[idldoc] IDLDOC vs. preformatted text

Andrew Collette andrew.collette at gmail.com
Tue Dec 11 14:25:35 PST 2007


Hi,

I'm using IDLDOC 3 beta 4 and I have to say it's wonderful, and easier to
write for than all the @-style tags.  However, I'm having a problem
displaying preformatted code and tables as part of a comment block.  I'm
using the ":: followed by indentation" method as outlined in the release
notes, which works as advertised.  I've encountered the following :

(1) The "starting" symbol "::" appears in the output.  Is this intentional?
(2) The parser doesn't seem to recognize tabs as part of indentation.  I
suppose this could be by design, but there are some instances where example
code we have is indented with tabs rather than spaces.  It would be nice not
to have to convert all of them.

Is there another way to indicate preformatted text to the parser?  I used to
use HTML "pre" tags in the @example section, but those don't work any more
because of the automatic insertion of paragraph tags between blocks of
text.  Is there any way to use something like a ":preformat: (somecode)
:preformat:" construct which would let me indicate exactly where it
starts/stops, instead of having the parser guess?

Thanks,
Andrew Collette
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.idldev.com/pipermail/idldoc-idldev.com/attachments/20071211/414cc77a/attachment.htm>


More information about the idldoc mailing list