Re: [Docutils-users] Really surprising behavior

[David G. <go...@py...>]

Beni Cherniavsky wrote:
>>   <document source="<stdin>">
>>       <bullet_list bullet="*">
>
> Never thought that the bullet is recorded of the DOM.  doctree.html
> confirms that and notes that it may be ignored in processing.
> What's the implication?

It's just stored there to help round-trip conversion.  From PEP 258:

    The DTD retains all information necessary to reconstruct the
    original input text, or a reasonable facsimile thereof.

> Is it ignored currently?

Yes.  I don't think it's used for anything now.

> Will it?

It may be used for text-output Writers, such as the one Stephan Diebel
reported on here a few days ago.

> Are there any guidelines in choosing bullets when writing rST?

Not really.  I like * for first-level, and - for lower levels.  But
that's just me.

-- 
David Goodger  <go...@py...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/