[Docutils-users] problems with .. include:: ?

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 454-5900

Hi --

I'm really enjoying Restructured Text. I grabbed the cvs snapshot yes=
terday
and everything was working as documented and as expected until I star=
ted
dividing a very large document up into chapters and using the
=2E. include::

directive to pull the chapters into the 'real' output document. Chapt=
ers
that are pulled in via the include directive are omitted from the gen=
erated
table of contents. Well, on closer examination, the very last chapter=
 pulled
in is included, but none of the others are.

For example, I've created the following 4 files
a.txt ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
A Restructured Text include Test
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=2E. contents::

--------------

=2E. include:: b.txt

--------------

=2E. include:: c.txt

--------------

=2E. include:: d.txt

b.txt~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is b.txt!
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

Some body text here...

c.txt ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This is C dot text
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

and also some body text in here!

d.txt~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
D . txt reporting for duty!
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D

complete with a body!

end~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~`

This generates the following HTML (note that only the last one appear=
s in
the TOC)...

<?xml version=3D"1.0" encoding=3D"utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang=3D"en">
<head>
<meta http-equiv=3D"Content-Type" content=3D"text/html; charset=3Dutf=
-8" />
<meta name=3D"generator" content=3D"Docutils 0.2.7:
http://docutils.sourceforge.net/" />
<title>A Restructured Text include Test</title>
<link rel=3D"stylesheet" href=3D"default.css" type=3D"text/css" />
</head>
<body>
<div class=3D"document" id=3D"a-restructured-text-include-test">
<h1 class=3D"title">A Restructured Text include Test</h1>
<div class=3D"contents topic" id=3D"contents">
<p class=3D"topic-title"><a name=3D"contents">Contents</a></p>
<ul class=3D"simple">
<li><a class=3D"reference" href=3D"#d-txt-reporting-for-duty" id=3D"i=
d1"
name=3D"id1">
D . txt reporting for duty!</a></li>
</ul>
</div>
<hr />
<p>text here?</p>
<div class=3D"section" id=3D"this-is-b-txt">
<h1><a name=3D"this-is-b-txt">This is b.txt!</a></h1>
<p>Some body text here...</p>
</div>
<hr />
<div class=3D"section" id=3D"this-is-c-dot-text">
<h1><a name=3D"this-is-c-dot-text">This is C dot text</a></h1>
<p>and also some body text in here!</p>
</div>
<hr />
<div class=3D"section" id=3D"d-txt-reporting-for-duty">
<h1><a class=3D"toc-backref" href=3D"#id1" name=3D"d-txt-reporting-fo=
r-duty">D .
txt reporting for duty!</a></h1>
<p>complete with a body!</p>
</div>
</div>
</body>
</html>

Is this a known limitation? Something that will be fixed? Or is this =
one of
those "push up your sleeves and fix it, pal" things?

--
//  Today's Oblique Strategy (=A9 Brian Eno/Peter Schmidt):
//  Ask your body
//  Brett g Porter * BgP...@ac...
//  http://mywebpages.comcast.net/bgporter/