bug-ed
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: rc3 doc comments


From: Karl Berry
Subject: Re: rc3 doc comments
Date: Tue, 7 Nov 2006 17:33:55 -0600

    Then novices should learn the meaning of <string>, 

It is irrational to expect all users to be computer scientists.
They're not.  There is no reason they should have to worry about it.

    the meaning of [string].

There's no way to avoid the brackets (or some special characters) for
optional cases.  But it can be avoided for simple nonterminals, and so
it should be, in user-oriented help messages and text anyway.  The less
special syntax, the better.

karl




reply via email to

[Prev in Thread] Current Thread [Next in Thread]