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 ?

On Mon, 12 Jul 2010 13:19:31 +0200
Remko Tronšon <remko@el-tramo.be> wrote:

> > 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.

Doesn't work for you?
yet you use xInclude... which could include files from your IDE?
Odd, that sounds like a reasonable litprog way of doing it.

Be assured, it does work for non trivial examples.




Dave Pawson

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