[Doc-SIG] Docstring grammar: a very revised proposal

[Fred L. Drake, Jr.]

Mark Hammond writes:
 > Im happy to ignore StructuredText for out-of-line doc for now.  The critical

  Structured text (as evolved by David Ascher & others in this forum)
is for embedded documentation.  I only intend to support one
out-of-line format, which will be in SGML or XML (I'm leaning toward
SGML today).

 > issue we have to deal with is docstrings.  Did we ever determine what
 > OReilly's position on XML and particular DTDs is?

  Frank Willison told me that they like to see books written in some
subset of DocBook, where the specific subset depends on the topic;
they want the author to use semantic markup appropriate to the
subject.  My impression was that the *specific* subset wasn't a real
concern.
  I don't know that this is of real concern to us.  If someone wants
to feed Python's standard documentation to a publisher, DocBook can be 
used as an output format.

 > This SIG has been going for ages, and has been amazingly short on results (a
 > critisism that obviously includes myself!).  It really is time to get
 > something happening, and this is an excellent start!

  Results?  What's that?  ;)


  -Fred

--
Fred L. Drake, Jr.	  <fdrake at acm.org>
Corporation for National Research Initiatives