[REBOL] Cosmetic bug - Help

From: al::bri::xtra::co::nz at: 6-Oct-2000 14:58

> Do you think that the HELP convention, as in:
>
>     >> help append
>     USAGE:
>         APPEND series value /only
>
>     DESCRIPTION:
>          Appends a value to the tail of a series and returns the series
head.
>          APPEND is a function value.
>
>     ARGUMENTS:
>          series -- (Type: series port)
>          value -- (Type: any)
>
>     REFINEMENTS:
>          /only -- Appends a block value as a block
>
> is sufficient...

No. I feel 'help should give a result that looks like this:

>     >> help append
>     Usage:
>         Append Series Value /Only
>
>     Description:
>          Appends a value to the tail of a series and returns the series
head.
>          Append is a function value.
>
>     Arguments:
>          Series -- (Type: Series Port)
>          Value -- (Type: Any)
>
>     Refinements:
>          /Only -- Appends a block value as a block.

Then the Title case indicates what's important and what's not so important,
instead of 'help blaring it out with all uppercase.

Andrew Martin
ICQ: 26227169
http://members.nbci.com/AndrewMartin/

  [This is the only message in the thread]