Another extensive update of Ddoc, www.digitalmars.com/d/ddoc.html

This one adds color syntax highlighting of D code, and the ability to process any document, not just D modules. A big chunk of the D documentation was converted to using Ddoc, you can see it in the color syntax hightlighting!

I hope to get back to regular bug fixing after this.

http://www.digitalmars.com/d/changelog.html

> http://www.digitalmars.com/d/changelog.html

The changelog entry for 135 is missing...

"Ben Hinkle" <bhinkle@mathworks.com> wrote in message news:dhs69m$2sfm$1@digitaldaemon.com...
>
> > http://www.digitalmars.com/d/changelog.html
>
> The changelog entry for 135 is missing...

Hmm. It was in the upload list, I wonder what happened. Anyhow, it's there now.

In article <dhs36g$2pru$1@digitaldaemon.com>, Walter Bright says...
>
>Another extensive update of Ddoc, www.digitalmars.com/d/ddoc.html
>
>This one adds color syntax highlighting of D code, and the ability to process any document, not just D modules. A big chunk of the D documentation was converted to using Ddoc, you can see it in the color syntax hightlighting!
>
>I hope to get back to regular bug fixing after this.
>
>http://www.digitalmars.com/d/changelog.html
>
>
>

Walter, in the template.html there are a few places near the bottom that converted the '<b>' html tag to '&gt;b&lt;' and the '</b>' html tag to '&gt;/b&lt;', just thought I'd point it out.

example:
--------

# <pre class="d_code"><span style="color:blue">template</span>
# &lt;b&gt;Bar&lt;/b&gt;(T)
# {
#     <span style="color:blue">class</span> &lt;b&gt;Bar&lt;/b&gt;
#     {
#         T member;
#     }
# }
# </pre>

David L.

P.S. The new color-syntax looks nice! <g>

-------------------------------------------------------------------
"Dare to reach for the Stars...Dare to Dream, Build, and Achieve!"
-------------------------------------------------------------------

MKoD: http://spottedtiger.tripod.com/D_Language/D_Main_XP.html

"David L. Davis" <SpottedTiger@yahoo.com> wrote in message news:di10ho$12ai$1@digitaldaemon.com...
> Walter, in the template.html there are a few places near the bottom that converted the '<b>' html tag to '&gt;b&lt;' and the '</b>' html tag to '&gt;/b&lt;', just thought I'd point it out.

Fixed. Thanks!

"Walter Bright" <newshound@digitalmars.com> wrote in message news:dhs36g$2pru$1@digitaldaemon.com...
> Another extensive update of Ddoc, www.digitalmars.com/d/ddoc.html
>
> This one adds color syntax highlighting of D code, and the ability to
> process any document, not just D modules. A big chunk of the D
> documentation
> was converted to using Ddoc, you can see it in the color syntax
> hightlighting!
>
> I hope to get back to regular bug fixing after this.
>
> http://www.digitalmars.com/d/changelog.html

Wee!

One thing that annoys me, though - DDoc seems to suffix a semicolon to the end of every declaration in the docs, even if they don't have a semicolon on them in the source (i.e. with a function declaration).  Could the semicolon be removed in the docs?  It'd be nice if that were optional.

Secondly, could there be a separate way to output members of structs / classes than members of modules, or is that all handled by a generic system? It looks a little out of place if I want to, say, put a border around the authors and examples sections, but the members of the struct are just sitting there, and if I put a box around members, it'll put a box around the entire module as well.

And lastly, how do I change the code highlighting colors?

"Jarrett Billingsley" <kb3ctd2@yahoo.com> wrote in message news:dim6gs$2ei4$1@digitaldaemon.com...
> One thing that annoys me, though - DDoc seems to suffix a semicolon to the end of every declaration in the docs, even if they don't have a semicolon
on
> them in the source (i.e. with a function declaration).  Could the
semicolon
> be removed in the docs?  It'd be nice if that were optional.

There isn't an obvious way to control that. The declaration text is actually generated not from the source, but from the symbol table.

> Secondly, could there be a separate way to output members of structs / classes than members of modules, or is that all handled by a generic
system?
> It looks a little out of place if I want to, say, put a border around the authors and examples sections, but the members of the struct are just sitting there, and if I put a box around members, it'll put a box around
the
> entire module as well.

Try redefining the DDOC_XXXX macros.

> And lastly, how do I change the code highlighting colors?

Redefine the D_XXXX macros, which are by default set to:

D_COMMENT = $(GREEN $0)
D_STRING  = $(RED $0)
D_KEYWORD = $(BLUE $0)
D_PSYMBOL = $(U $0)
D_PARAM   = $(I $0)

"Walter Bright" <newshound@digitalmars.com> wrote in message news:dimcq2$2laq$1@digitaldaemon.com...
> There isn't an obvious way to control that. The declaration text is
> actually
> generated not from the source, but from the symbol table.

So the semicolons are part of the symbols?  That seems odd..

> Try redefining the DDOC_XXXX macros.

If you mean the DDOC_MEMBERS section, I have.  However, the same macro applies to members of modules _and_ members of classes/structs.  I'd like to know how to (if at all possible) use one macro for the module-level members, and another for class/struct members.

> Redefine the D_XXXX macros, which are by default set to:
>
> D_COMMENT = $(GREEN $0)
> D_STRING  = $(RED $0)
> D_KEYWORD = $(BLUE $0)
> D_PSYMBOL = $(U $0)
> D_PARAM   = $(I $0)

Might want to document those; the Doc Doc (hehe) doesn't mention them at all.  Thanks for those!

"Jarrett Billingsley" <kb3ctd2@yahoo.com> wrote in message news:dimi9f$2ue1$1@digitaldaemon.com...
> Might want to document those; the Doc Doc (hehe) doesn't mention them at all.  Thanks for those!

I just realized something - there is no number highlighting.  Will this be a future feature?

"Jarrett Billingsley" <kb3ctd2@yahoo.com> wrote in message news:dimu68$r0n$1@digitaldaemon.com...
> I just realized something - there is no number highlighting.  Will this be
a
> future feature?

It could be done easilly enough, I just wonder if there's much value to it.