OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] Compact DocBook ?

> then you have a perfectly normal docbook document,

... and you lose the ability to use of development tools like IDEs,
you have to regenerate the sources every time you make a tiny change
(which happens much more often than regenerating  documentation),
debuggers get confused, you need to set up a way to name your sources
and map this to the filesystem, ...

Unfortunately, this way of working works if the main thing you're
writing is documentation with some toy examples in them (and even
then, I personally just write scripts that embed pure source code into
DocBook includes). It doesn't work for real development.


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]