[ltt-dev] LTTV-supplied documentation

[ltt-dev] LTTV-supplied documentation

[Alexandre Montplaisir]

Hi,

I have a question about the documentation provided with the LTTV package 
(the /doc directory).
Is everything in there still relevant? It's full of makefiles that don't 
seem to "make" anything anymore.

At first glance, the html guides in:
doc/user/user_guide/html
doc/developer/developer_guide/html

seem to be the most up-to-date, but there's also a bunch of stuff in 
doc/developer/ that seems relevant (provided it isn't outdated).

As you may have guessed, I'm working on Debian packages, and was 
wondering what should go in the "lttv-doc" one.

Thanks,
Alexandre

[ltt-dev] LTTV-supplied documentation

[Mathieu Desnoyers]

* Alexandre Montplaisir (alexandre.montplaisir at polymtl.ca) wrote:
> Hi,
>
> I have a question about the documentation provided with the LTTV package  
> (the /doc directory).
> Is everything in there still relevant? It's full of makefiles that don't  
> seem to "make" anything anymore.

Not everything.

>
> At first glance, the html guides in:
> doc/user/user_guide/html
> doc/developer/developer_guide/html
>
> seem to be the most up-to-date, but there's also a bunch of stuff in  
> doc/developer/ that seems relevant (provided it isn't outdated).

doc/developer contains a lot of architecture-level description of lttv,
some of which did not follow with code refactoring.

>
> As you may have guessed, I'm working on Debian packages, and was  
> wondering what should go in the "lttv-doc" one.

The documents I'm actively keeping up to date are:

/doc/developer/lttng-lttv-compatibility.txt
/LTTngManual.html

For the rest, it's a per-file investigation.

Thanks,

Mathieu


>
> Thanks,
> Alexandre
>
> _______________________________________________
> ltt-dev mailing list
> ltt-dev at lists.casi.polymtl.ca
> http://lists.casi.polymtl.ca/cgi-bin/mailman/listinfo/ltt-dev
>

-- 
Mathieu Desnoyers
Operating System Efficiency R&D Consultant
EfficiOS Inc.
http://www.efficios.com

[ltt-dev] LTTV-supplied documentation

[Alexandre Montplaisir]

> The documents I'm actively keeping up to date are:
>
> /doc/developer/lttng-lttv-compatibility.txt
> /LTTngManual.html
>
> For the rest, it's a per-file investigation.
>
> Thanks,
>
> Mathieu
>    

Ok thanks, I think I'll drop lttv-doc for now and include those two 
files with the main package instead.

>
>    
>> Thanks,
>> Alexandre
>>
>> _______________________________________________
>> ltt-dev mailing list
>> ltt-dev at lists.casi.polymtl.ca
>> http://lists.casi.polymtl.ca/cgi-bin/mailman/listinfo/ltt-dev
>>
>>      
>    

[ltt-dev] LTTV-supplied documentation

[Mathieu Desnoyers]

* Alexandre Montplaisir (alexandre.montplaisir at polymtl.ca) wrote:
>
>> The documents I'm actively keeping up to date are:
>>
>> /doc/developer/lttng-lttv-compatibility.txt
>> /LTTngManual.html
>>
>> For the rest, it's a per-file investigation.
>>
>> Thanks,
>>
>> Mathieu
>>    
>
> Ok thanks, I think I'll drop lttv-doc for now and include those two  
> files with the main package instead.

Do you need me to push a lttv release which includes your fix to make
your packaging easier ?

Mathieu

>
>>
>>    
>>> Thanks,
>>> Alexandre
>>>
>>> _______________________________________________
>>> ltt-dev mailing list
>>> ltt-dev at lists.casi.polymtl.ca
>>> http://lists.casi.polymtl.ca/cgi-bin/mailman/listinfo/ltt-dev
>>>
>>>      
>>    
>
>
> _______________________________________________
> ltt-dev mailing list
> ltt-dev at lists.casi.polymtl.ca
> http://lists.casi.polymtl.ca/cgi-bin/mailman/listinfo/ltt-dev
>

-- 
Mathieu Desnoyers
Operating System Efficiency R&D Consultant
EfficiOS Inc.
http://www.efficios.com

[ltt-dev] LTTV-supplied documentation

[Alexandre Montplaisir]

On 10-09-07 12:24 PM, Mathieu Desnoyers wrote:
> * Alexandre Montplaisir (alexandre.montplaisir at polymtl.ca) wrote:
>    
>>      
>>> The documents I'm actively keeping up to date are:
>>>
>>> /doc/developer/lttng-lttv-compatibility.txt
>>> /LTTngManual.html
>>>
>>> For the rest, it's a per-file investigation.
>>>
>>> Thanks,
>>>
>>> Mathieu
>>>
>>>        
>> Ok thanks, I think I'll drop lttv-doc for now and include those two
>> files with the main package instead.
>>      
> Do you need me to push a lttv release which includes your fix to make
> your packaging easier ?
>
> Mathieu
>    

No, there's no hurry. The patch I sent previously is already included as 
an out-of-tree patch, which can be dropped at the next release.
Thanks though ;)

Alexandre

>    
>>      
>>>
>>>        
>>>> Thanks,
>>>> Alexandre
>>>>
>>>> _______________________________________________
>>>> ltt-dev mailing list
>>>> ltt-dev at lists.casi.polymtl.ca
>>>> http://lists.casi.polymtl.ca/cgi-bin/mailman/listinfo/ltt-dev
>>>>
>>>>
>>>>          
>>>
>>>        
>>
>> _______________________________________________
>> ltt-dev mailing list
>> ltt-dev at lists.casi.polymtl.ca
>> http://lists.casi.polymtl.ca/cgi-bin/mailman/listinfo/ltt-dev
>>
>>      
>