[xiph-cvs] cvs commit: vorbis/doc/xml TODO

[Ralph Giles]

giles       02/10/13 11:30:40

  Added:       doc/xml  TODO
  Log:
  Add a todo list for the docbook conversion.

Revision  Changes    Path
1.1                  vorbis/doc/xml/TODO

Index: TODO
===================================================================
TODO list for vorbis spec docbook conversion.

* Get the figures working in pdf. Jade seems to be doing something
  (suboptimal) with <graphic>, and nothing at all with <imageobject>.

* Proof against html original and remove it.

* Reset all those nested lists of decoding structions in docbook. They
  don't wrap properly in the printed version, and they don't look so
  good. Easy but tedious.

* Set remaining auxiliary material.

* Get vector versions of the figures from Monty and/or create them anew.
  We need eps versions for the printable version. Optionally, have the
  makefile run them through ghostscript to create the pngs for the html
  version if the docbook processor isn't smart enough to do so.

* Get the equations working. We should have one version, either latex or
  mathml from which both the html and print versions are generated. Latex
  source is in the alt tags in the document.

* Normalize variable naming. The current spec uses brackets to indicated
  values decoded from the bitstream. In html and pdf we can use tt font
  to indicate this, so the [] is redundant. Remove them from scalars and
  either keep them for vectors, or set the vectors bold tt. Note that
  this requires resetting the already tt sections.

<p><p><p>--- >8 ----
List archives:  http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to 'cvs-request at xiph.org'
containing only the word 'unsubscribe' in the body.  No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.