[Doc-SIG] docstring grammar (erratum)
Edward Welbourne
Edward Welbourne <eddyw@lsl.co.uk>
Tue, 30 Nov 1999 15:32:00 +0000
I said:
~ and output formatters can chose different symbols
in place of the star for successive nesting layers
and
~ and if we're insisting on all items in a list having the same
bullet, does it make sense to allow items after the first to
just use an unadorned star meaning re-use of first item's
symbol, thus saving us lots of editing when we want to change
the symbol in use by a list, or shuffle an item from a sub-list
out into its parent list (or etc.)
but `unadorned star' should be `unadorned twiddle' - I missed a
conversion after being persuaded that *'s font role prohibits its use
as, for instance, *o or *1, which would match `begin italic': hence the
use of ~ and remarks about other candidates. Likewise, in the first,
the presumption was that * is the default symbol, but I don't imagine
we'd be using ~ as a bullet much (well, we could), so that snippet
should have vanished. The output formatters chose symbols as
appropriate: the parser just identifies the list structure and which
bits are subordinate to which others.
Eddy.