On Jun 10, 2007, at 4:15 PM, Daniel Stenberg wrote:
> On Sun, 10 Jun 2007, James Housley wrote:
>
>> There has been many changes to the code that needs to be
>> documented. I see
>> in the repository libssh2-doc, which is XML based DocBook. This
>> looks like
>> it might be what is driving the Wiki pages, but not sure. Daniel
>> started a
>> docs directory in with the source, which is much easier to have
>> installed
>> with libssh2 on Un*x systems and is capable of producing web pages
>> (FreeBSD
>> and Linux and others do).
>>
>> The question is how to proceed from here?
>
> I want the docs to be:
>
> 1 - included in the release tarballs
>
> 2 - added to CVS
>
> 3 - installed as man pages on 'make install'
>
> 4 - Possibly as a bonus, available as HTML and PDF versions
>
> In the curl project we've accomplished all this by simply writing
> the docs in
> the nroff (man page) format and generating HTML and PDF from those.
> It has
> worked fine and that's why I took that route. I'm not emotionally
> attached to
> it so if someone feels strongly for another approach that works,
> then I'll
> certainly be open for it.
I agree to, and like the nroff format. I will probably use -mdoc
instead of -man, but I will play with that some. We just need to get
help to get the new docs on the website.
Jim
-- /"\ ASCII Ribbon Campaign . \ / - NO HTML/RTF in e-mail . X - NO Word docs in e-mail . / \ ----------------------------------------------------------------- jeh@FreeBSD.org http://www.FreeBSD.org The Power to Serve jim@TheHousleys.Net http://www.TheHousleys.net --------------------------------------------------------------------- Progress (n) : What led from smart users in front of dumb terminals to dumb users in front of smart terminals. ------------------------------------------------------------------------- This SF.net email is sponsored by DB2 Express Download DB2 Express C - the FREE version of DB2 express and take control of your XML. No limits. Just data. Click to get it now. http://sourceforge.net/powerbar/db2/ _______________________________________________ libssh2-devel mailing list libssh2-devel_at_lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/libssh2-develReceived on 2007-06-10