[Doc-SIG] Docutils Update: statemachine.ViewList

David Goodger goodger@python.org
Thu, 07 Nov 2002 20:48:33 -0500


I've just checked in code for ViewList and StringList classes to
docutils/statemachine.py.  StringList objects are now used inside the
state machine (the guts of the parser) instead of standard Python
lists.  The change should be internal-only, with no outside effects,
but outside code should be tested.  Please let me know if there are
any problems.

Here's the ViewList class docstring:

    List with extended functionality: slices of ViewList objects are
    child lists, linked to their parents. Changes made to a child list
    also affect the parent list.  A child list is effectively a "view"
    (in the SQL sense) of the parent list.  Changes to parent lists,
    however, do *not* affect active child lists.  If a parent list is
    changed, any active child lists should be recreated.

    The start and end of the slice can be trimmed using the
    `trim_start()` and `trim_end()` methods, without affecting the
    parent list.  The link between child and parent lists can be
    broken by calling `disconnect()` on the child list.

    Also, ViewList objects keep track of the source & offset of each
    item. This information is accessible via the `source()`,
    `offset()`, and `info()` methods.

BTW, this solves the "include" directive problems brought up by Brett
Porter last week.  (A long way to go to fix a small problem!  But it
should pay off in the long term.)

-- 
David Goodger  <goodger@python.org>  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/



-------------------------------------------------------
This sf.net email is sponsored by: See the NEW Palm
Tungsten T handheld. Power & Color in a compact size!
http://ads.sourceforge.net/cgi-bin/redirect.pl?palm0001en
_______________________________________________
Docutils-develop mailing list
Docutils-develop@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/docutils-develop