[PYTHON DOC-SIG] Observations about gendoc.
Daniel Larsson
dlarsson@sw.seisy.abb.se
Sun, 16 Feb 1997 12:07:21 +0100
------------6BE469A627D94
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=us-ascii
Mark Hammond wrote:
> ...
> All this leads to a nice heriarchical index of the entire package.
>
> So my questions:
> * Does this sound reasonable? The recursive changes mean that it
> still works as before. This _seems_ the correct design for ni, which
> is recursive by nature. This could possibly be put to good use
> elsewhere.
Yes, I think it sounds good. This is more or less the idea I had for
supporting
ni.
> * Re the index. How should I generate it? With no frame, an
> indented list seems right. But if I have frames, an indented list
> will be too "wide". Best thing that comes to mind is some sort of
> nested set of index pages or something...Maybe dont use an actual
> HTML list (eg, heading levels) , to keep the width down. How about
> generating for an MSIE tree control :-):-)
> Any advice on this?
I would vote for nested indices. This would at least solve the nested
list
problem.
-- Daniel
------------6BE469A627D94
Content-Transfer-Encoding: 7bit
Content-Type: text/html; charset=us-ascii
<HTML><BODY>
<DT>Mark Hammond wrote:<BR>
> ...<BR>
> All this leads to a nice heriarchical index of the entire package.<BR>
> <BR>
> So my questions:<BR>
> * Does this sound reasonable? The recursive changes mean that
it<BR>
> still works as before. This _seems_ the correct design for ni,
which<BR>
> is recursive by nature. This could possibly be put to good use<BR>
> elsewhere.<BR>
<BR></DT>
<DT>Yes, I think it sounds good. This is more or less the idea I had for
supporting</DT>
<DT>ni.</DT>
<DT><BR>
> * Re the index. How should I generate it? With no frame,
an<BR>
> indented list seems right. But if I have frames, an indented
list<BR>
> will be too "wide". Best thing that comes to mind
is some sort of<BR>
> nested set of index pages or something...Maybe dont use an actual<BR>
> HTML list (eg, heading levels) , to keep the width down. How
about<BR>
> generating for an MSIE tree control :-):-)<BR>
> Any advice on this?<BR>
<BR></DT>
<DT>I would vote for nested indices. This would at least solve the nested
list</DT>
<DT>problem.</DT>
<DT><BR>
-- Daniel</DT>
</BODY>
</HTML>
------------6BE469A627D94--
_______________
DOC-SIG - SIG for the Python Documentation Project
send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org
_______________