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.

regards


-- 

regards 

-- 
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk


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