[ntp:hackers] Man page generation and maintanence

TS Glassey tglassey at earthlink.net
Sun May 27 11:16:52 PDT 2007


So how would that be accomplished here then is the question to answer.

T
----- Original Message ----- 
From: "Brian Utterback" <Brian.Utterback at Sun.COM>
To: "TS Glassey" <tglassey at earthlink.net>
Cc: <hackers at support.ntp.org>
Sent: Sunday, May 27, 2007 11:03 AM
Subject: Re: [ntp:hackers] Man page generation and maintanence


> I'll buy that. That's pretty much what I had in mind.
>
> TS Glassey wrote:
>> BLU - Good morning -
>>
>> I am not suggesting that they be totally decoupled but run as a 
>> sub-project of the implementation one perhaps. And the reasoning is that 
>> most of the Hacker's participants are working on either core 
>> functionality or in driver support for REFCLOCKS rather than the 
>> documentation process itself.
>>
>> For instance inside Sun, Tech Pub's handles all of the documents 
>> published and its their charter to make sure that the content meets the 
>> Engineering Department's design requirements... but they operate under a 
>> separate umbrella from release and engineering.
>>
>> Todd
>>
>> ----- Original Message ----- From: "Brian Utterback" 
>> <Brian.Utterback at Sun.COM>
>> To: "TS Glassey" <tglassey at earthlink.net>
>> Cc: <hackers at support.ntp.org>
>> Sent: Sunday, May 27, 2007 8:23 AM
>> Subject: Re: [ntp:hackers] Man page generation and maintanence
>>
>>
>>> Hmm, I am not sure I agree that they should be decoupled. Decoupling 
>>> promotes
>>> the docs getting out of sync. I don't see any advantage to having a
>>> separate project. What is your reasoning Todd?
>>>
>>> TS Glassey wrote:
>>>> There should be a separate project under the NTP banner for maintaining 
>>>> these IMHO... and I am willing to put time into this as well Brian if 
>>>> you want to create this new repository.
>>>>
>>>>
>>>> Todd Glassey
>>>> ----- Original Message ----- From: "Brian Utterback" 
>>>> <Brian.Utterback at Sun.COM>
>>>> To: <hackers at support.ntp.org>
>>>> Sent: Sunday, May 27, 2007 6:19 AM
>>>> Subject: [ntp:hackers] Man page generation and maintanence
>>>>
>>>>
>>>>
>>>>> I am in the process of creating Solaris specific man pages. I am
>>>>> somewhat confused with the
>>>>> creation of man pages in general in NTP.
>>>>>
>>>>> In the past there has been a lot of comments from Dave about how he
>>>>> maintains the docs in
>>>>> html and the rest of the docs are generated from that. I have assumed
>>>>> that this includes
>>>>> the man pages, but I think that this is incorrect.
>>>>>
>>>>> The HTML in the Bitkeeper repro for ntp-dev is mostly almost 2 years
>>>>> old, with a couple
>>>>> of small updates here and there.
>>>>>
>>>>> The actual man pages in the distro seem to  have little or no updating
>>>>> going on, but it is
>>>>> hard to tell since the history page at Bitkeeper is filled with 
>>>>> release
>>>>> tags and only goes
>>>>> back 13 weeks (anybody know how to go back further?).
>>>>>
>>>>> From my previous conversations with Harlan and Bruce, it seemed that
>>>>> there used
>>>>> to be scripts that were used to create the man pages, but they have
>>>>> fallen into disrepair.
>>>>> I tried using autogen to create new man pages via the method commented
>>>>> out in the
>>>>> bootstrap file, but it required a version of autogen that was not
>>>>> installed on pogo.
>>>>> I was not able to install the required version on pogo in my home
>>>>> directory because
>>>>> it complained about missing stuff. I have attempted to install autogen
>>>>> on Solaris in
>>>>> the past, but I totally failed to find my way through the twisty 
>>>>> little
>>>>> passages of
>>>>> dependencies, all different.
>>>>>
>>>>> I am interested in getting the man pages going again. Autogen seems to
>>>>> have the
>>>>> ability to create OS specific pages, so does anybody have some info 
>>>>> that
>>>>> might
>>>>> help me get started? Is there the proper version of autogen available 
>>>>> in
>>>>> the flock
>>>>> somewhere? And where is the ultimate source for the man pages kept and 
>>>>> can
>>>>> I update them?
>>>>>
>>>>> Brian Utterback
>>>>> _______________________________________________
>>>>> hackers mailing list
>>>>> hackers at support.ntp.org
>>>>> https://support.ntp.org/mailman/listinfo/hackers
>>>>
>>>> _______________________________________________
>>>> hackers mailing list
>>>> hackers at support.ntp.org
>>>> https://support.ntp.org/mailman/listinfo/hackers
>>>>
>>>
>>
> 



More information about the hackers mailing list