Mailing List Archive: 49091 messages
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search
 

Cosmetic bug - Help

 [1/1] 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:
<<quoted lines omitted: 3>>
> /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/

Notes
  • Quoted lines have been omitted from some messages.
    View the message alone to see the lines that have been omitted