Ddoc as general documentation tool

[Gour]

On Mon, 19 Mar 2012 09:55:40 -0500
Andrei Alexandrescu <SeeWebsiteForEmail at erdani.org> wrote:

> DDoc has two main assets: (a) it understands D structures, e.g. you
> can use it to document D APIs, and (b) it highlights D code nicely.

Yeah, that's anticpated usage of it.

> More specialized tools that have a focus on document formatting have 
> naturally an advantage over DDoc for general-purpose documentation.

After some research, it seems that the best is to use Ddoc for
documenting our code and library, while leaving the rest to the
specialized tool (we're heading towards AsciiDoc).


Sincerely,
Gour


-- 
What is night for all beings is the time of awakening 
for the self-controlled; and the time of awakening for 
all beings is night for the introspective sage.

http://atmarama.net | Hlapicina (Croatia) | GPG: 52B5C810
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: not available
URL: <http://lists.puremagic.com/pipermail/digitalmars-d/attachments/20120319/aca6c082/attachment.pgp>