[Top][All Lists]
[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