[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.