Worst Phobos documentation evar!

[ketmar via Digitalmars-d]

On Wed, 31 Dec 2014 16:21:26 -0800
Walter Bright via Digitalmars-d <digitalmars-d at puremagic.com> wrote:

> On 12/31/2014 3:03 PM, Dicebot wrote:
> > One of the very first lines:
> >
> >      $(TABLE2 Kinds of Arrays,
> >          $(THEAD Syntax, Description)
> >          $(TROW $(ARGS $(I type)*), $(ARGS $(RELATIVE_LINK2 pointers, Pointers
> > to data)))
> >          $(TROW $(ARGS $(I type)[$(I integer)]), $(ARGS $(RELATIVE_LINK2
> > static-arrays, Static arrays)))
> >          $(TROW $(ARGS $(I type)[]),  $(ARGS $(RELATIVE_LINK2 dynamic-arrays,
> > Dynamic arrays)))
> >          $(TROW $(ARGS $(I type)[$(I type)]), $(ARGS $(DDLINK hash-map,
> > Associative Arrays, Associative arrays)))
> >      )
> >

> Making some effort myself:
> 
> $(TABLE2 Kinds of Arrays,
>    $(THEAD Syntax            , Description                           )
>    $(TROW  $(I type*)        , $(LINK2 #pointers, Pointers to data)  )
>    $(TROW  $(I type[integer]), $(LINK2 #static-arrays, Static arrays))
> )

not really better. it's still noisy and it's still YELLING AT ME,
disctracting me from the actual text.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 181 bytes
Desc: not available
URL: <http://lists.puremagic.com/pipermail/digitalmars-d/attachments/20150101/56525c5c/attachment.sig>