qpid-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rajith Attapattu <rajit...@gmail.com>
Subject Re: Move documentation to svn / DocBook?
Date Wed, 02 Dec 2009 14:28:24 GMT
On Wed, Dec 2, 2009 at 9:13 AM, Alan Conway <aconway@redhat.com> wrote:
> On 12/02/2009 07:35 AM, Robert Godfrey wrote:
>>
>> Just like to add my voice to the chorus of +1s, I've been a big advocate
>> of
>> version controlling the docs, and using docbook, for a long time
>>
>> -- Rob
>>
>> I'm +1 on a top level doc dir.
>>>
>>> In the spirit of getting this done quickly I think it makes sense to do
>>> this in two steps. First get the current content translated into SVN so
>>> that
>>> the output matches what we currently have on the website, and then worry
>>> about refining the organization/structure/source-layout later. I'd hate
>>> to
>>> see the former stall on a discussion of the latter.
>>>
>>> --Rafael
>>>
> Another big +1 from me, I'm delighted to see this happening.
>
> Question: can docbook do man pages? There are some problems with the way we
> currently generate the qpidd man pages, wondering if docbook might help us
> there.

A quick google search seems to point to a few such tools.
Ex http://www.oasis-open.org/docbook/tools/dtm/

So it might be a worthwhile experiment.

>
> ---------------------------------------------------------------------
> Apache Qpid - AMQP Messaging Implementation
> Project:      http://qpid.apache.org
> Use/Interact: mailto:dev-subscribe@qpid.apache.org
>
>



-- 
Regards,

Rajith Attapattu
Red Hat
http://rajith.2rlabs.com/

---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:dev-subscribe@qpid.apache.org


Mime
View raw message