Thread overview
DDoc macro questions (usage)...
Oct 14, 2005
clayasaurus
Oct 15, 2005
Regan Heath
Oct 15, 2005
clayasaurus
Oct 15, 2005
clayasaurus
Oct 15, 2005
Derek Parnell
Oct 15, 2005
Walter Bright
Oct 15, 2005
Walter Bright
Oct 16, 2005
clayasaurus
October 14, 2005
Just got around to playing with DDoc and I have some questions about macros...

1)
I was playing arond with macros but when I try

Macros:
   RED = hello red world!
   or...
   LINK = www.dsource.org

I crash the compiler :-/ Should I make another bug report? Or am I doing something horribly wrong.

2)
How would you make a bulleted list with the macros?



Thanks.
~ Clay
October 15, 2005
On Fri, 14 Oct 2005 17:22:48 -0400, clayasaurus <clayasaurus@gmail.com> wrote:
> Just got around to playing with DDoc and I have some questions about macros...
>
> 1)
> I was playing arond with macros but when I try
>
> Macros:
>     RED = hello red world!
>     or...
>     LINK = www.dsource.org
>
> I crash the compiler :-/ Should I make another bug report?

Yes.

> Or am I doing something horribly wrong.

Maybe, maybe not.. IMO it shouldn't crash regardless.

Regan
October 15, 2005
"clayasaurus" <clayasaurus@gmail.com> wrote in message news:dip7i2$n07$1@digitaldaemon.com...
> 2)
> How would you make a bulleted list with the macros?

Something like:

/*********************
$(UL
    $(LI This is an item.)
    $(LI This is another item.)
)
*********************/

I really wish it were easier to make lists.  Maybe with some kind of special syntax.


October 15, 2005
Regan Heath wrote:
> On Fri, 14 Oct 2005 17:22:48 -0400, clayasaurus <clayasaurus@gmail.com>  wrote:
> 
>> Just got around to playing with DDoc and I have some questions about  macros...
>>
>> 1)
>> I was playing arond with macros but when I try
>>
>> Macros:
>>     RED = hello red world!
>>     or...
>>     LINK = www.dsource.org
>>
>> I crash the compiler :-/ Should I make another bug report?
> 
> 
> Yes.

Done.

> 
>> Or am I doing something horribly wrong.
> 
> 
> Maybe, maybe not.. IMO it shouldn't crash regardless.
> 
> Regan
October 15, 2005
Jarrett Billingsley wrote:
> "clayasaurus" <clayasaurus@gmail.com> wrote in message news:dip7i2$n07$1@digitaldaemon.com...
> 
>>2)
>>How would you make a bulleted list with the macros?
> 
> 
> Something like:
> 
> /*********************
> $(UL
>     $(LI This is an item.)
>     $(LI This is another item.)
> )
> *********************/
> 
> I really wish it were easier to make lists.  Maybe with some kind of special syntax. 
> 
> 

Thanks. : )

~ Clay
October 15, 2005
On Fri, 14 Oct 2005 20:27:06 -0400, Jarrett Billingsley wrote:

> "clayasaurus" <clayasaurus@gmail.com> wrote in message news:dip7i2$n07$1@digitaldaemon.com...
>> 2)
>> How would you make a bulleted list with the macros?
> 
> Something like:
> 
> /*********************
> $(UL
>     $(LI This is an item.)
>     $(LI This is another item.)
> )
> *********************/
> 
> I really wish it were easier to make lists.  Maybe with some kind of special syntax.

To make my documentation looking less 'html'-centric I've defined two macros thus ...

  LIST = <ul>$0</ul>
  ITEM = <li>$0</li>

/*********************
$(LIST
    $(ITEM This is an item.)
    $(ITEM This is another item.)
)
*********************/

-- 
Derek Parnell
Melbourne, Australia
15/10/2005 12:51:22 PM
October 15, 2005
"clayasaurus" <clayasaurus@gmail.com> wrote in message news:dip7i2$n07$1@digitaldaemon.com...
> Just got around to playing with DDoc and I have some questions about macros...
>
> 1)
> I was playing arond with macros but when I try
>
> Macros:
>     RED = hello red world!
>     or...
>     LINK = www.dsource.org
>
> I crash the compiler :-/ Should I make another bug report? Or am I doing something horribly wrong.

A compiler crash is *always* a compiler bug, and a bug report is apropos. I've fixed that one, by the way. To work around, add a module declaration and attach the comment with the macros: section to that.

> 2)
> How would you make a bulleted list with the macros?

    $(OL
        $(LI item 1)
        $(LI item 2)
        $(LI another item)
    )


October 15, 2005
"Walter Bright" <newshound@digitalmars.com> wrote in message news:dirh1p$2k4d$3@digitaldaemon.com...
>    $(OL
>        $(LI item 1)
>        $(LI item 2)
>        $(LI another item)
>    )

OL is an "Ordered List," meaning that it will be shown with numbers (or letters, depending on the nesting level).  UL is an "Unordered List," meaning that the items technically could be shown in any order, so it is bulleted.


October 15, 2005
"Jarrett Billingsley" <kb3ctd2@yahoo.com> wrote in message news:dirk0q$2m36$1@digitaldaemon.com...
> "Walter Bright" <newshound@digitalmars.com> wrote in message news:dirh1p$2k4d$3@digitaldaemon.com...
> >    $(OL
> >        $(LI item 1)
> >        $(LI item 2)
> >        $(LI another item)
> >    )
>
> OL is an "Ordered List," meaning that it will be shown with numbers (or letters, depending on the nesting level).  UL is an "Unordered List," meaning that the items technically could be shown in any order, so it is bulleted.

Right.


October 16, 2005
Walter Bright wrote:
> "clayasaurus" <clayasaurus@gmail.com> wrote in message
> news:dip7i2$n07$1@digitaldaemon.com...
> 
>>Just got around to playing with DDoc and I have some questions about
>>macros...
>>
>>1)
>>I was playing arond with macros but when I try
>>
>>Macros:
>>    RED = hello red world!
>>    or...
>>    LINK = www.dsource.org
>>
>>I crash the compiler :-/ Should I make another bug report? Or am I doing
>>something horribly wrong.
> 
> 
> A compiler crash is *always* a compiler bug, and a bug report is apropos.
> I've fixed that one, by the way. To work around, add a module declaration
> and attach the comment with the macros: section to that.

Ok. I'll keep that in mind.

> 
> 
>>2)
>>How would you make a bulleted list with the macros?
> 
> 
>     $(OL
>         $(LI item 1)
>         $(LI item 2)
>         $(LI another item)
>     )
> 
> 

Thanks

~ Clay