12, 2010 7:38 AM
To: Robert Lucente
Subject: Re: [docbook-apps] Compact DocBook ?
On Mon, 12 Jul 2010 06:11:46 -0400
Robert Lucente rluce...@pipeline.com wrote:
Think of it the other way round?
Embed java code in Docbook?
Nice !
Tangle and weave are the ideas,
Literate Programming
Dear all,
[I hope this is on-topic for this list]
I'm hoping to embed DocBook within some Java code (as comments). Along with
some support utilities, this should allow embedding of documentation next to
the code it describes. This is somewhat similar to JavaDoc, but:
a. using DocBook
On Mon, 12 Jul 2010 10:36:36 +0200
Paul Millar p...@astro.gla.ac.uk wrote:
Dear all,
[I hope this is on-topic for this list]
I'm hoping to embed DocBook within some Java code (as comments).
Think of it the other way round?
Embed java code in Docbook?
then you have a perfectly normal
document.
Regards Lars
-Ursprungligt meddelande-
Från: Paul Millar [mailto:p...@astro.gla.ac.uk]
Skickat: den 12 juli 2010 10:37
Till: docbook-apps@lists.oasis-open.org
Ämne: [docbook-apps] Compact DocBook ?
Dear all,
[I hope this is on-topic for this list]
I'm hoping to embed 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
On Mon, 12 Jul 2010 13:19:31 +0200
Remko Tronçon re...@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
Remko Tronçon wrote:
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.
Of couse it
lars.bjer...@swedbank.se wrote:
Another way to do it is to use regular JavaDoc and do the following:
1 Generate html from java
2 Generate DocBook from html
There is nice tools dbdoclet which can be used for generating DocBook
from JavaDoc comments. I think that with some customization it could
+--
| I'm hoping to embed DocBook within some Java code (as
| comments). Along with some support utilities, this should
| allow embedding of documentation next to the code it describes.
| This is somewhat similar to JavaDoc, but:
|
| a. using DocBook vocabulary,
|
| b. to be included