Re: Converting Texinfo to DocBook

On Sunday, November 3, 2002, at 04:53 PM, Zack Brown wrote:

> On Sun, Nov 03, 2002 at 09:50:51AM -0800, Blair Zajac wrote:
>> This may be relevant for the SVN book authors.
>>
>> "Arnold Robbins explains how he transformed Texinfo into DocBook
>> for Effective Awk (for O'Reilly)."
>>
>> http://www.oreillynet.com/pub/a/oreilly/linux/2002/11/01/awk3.html
>
> Is this the direction Subversion is going?

the old 'subversion handbook' has been converted from texinfo into
docbook as part of becomming the new subversion o'reilly's book cmike,
ben collins-sussman, and fitz are working on.

> Currently I see four distinct
> documentation formats in the project: plain text, emacs outline,
> texinfo,
> and docbook. That does seem like a lot. It might be best to
> standardize on
> two of them. Say, docbook format for formatted docs, and emacs outline
> for
> everything else.

requiring some special (even really simple) format for random notes
files seems like overkill. personally, i'm all in favor of getting rid
of the texinfo in fovor of docbook for things that are meant to be
printed out or rendered into some other format, but i don't see the
point in messing with the plain text stuff. it works well enough the
way it is.

-garrett

-- 
garrett rooney                    Remember, any design flaw you're
rooneg@electricjellyfish.net      sufficiently snide about becomes
http://electricjellyfish.net/     a feature.       -- Dan Sugalski
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org