1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html> <head>
<title>Epydoc: Future Directions</title>
<link rel="stylesheet" href="epydoc.css" type="text/css"/>
</head>
<!-- $Id: future.html,v 1.3 2002/10/02 07:07:09 edloper Exp $ -->
<body>
<h1> Epydoc: Future Directions </h1>
<p> I don't expect epydoc to undergo any major changes in the near
future. In particular, I am unlikely to add any new block structure
constructs (such as tables) to the epytext markup language; it is
currently quite simple and clean, and I'd like to keep it that way.
However, if there are improvements to the epytext markup language that
you feel would not significantly affect its simplicity, let me know.
And if there are any improvements you'd like made to epydoc tool
itself, feel free to <a
href="mailto:edloper@gradient.cis.upenn.edu">email me</a>. </p>
<p> If and when <a
href="http://docutils.sourceforge.net/">Docutils</a> becomes the
standard framework for Python API Documentation systems, I will look
into integrating epydoc into Docutils. </p>
<h2> To Do </h2>
<p> These are changes I'd like to make, if and when I get the time.
The order that they're listed in roughly reflects the order that I
would do them, if I got time. </p>
<ul>
<li> Package and release version 1.0. </li>
<li> Add special escape sequences, such as "<code>{->}</code>". </li>
<li> Change the parsing algorithm used by fields to eliminate the
restriction that the blocks contained by a field have indentation
greater than the indentation of the field tag; and the
recommendation that field lists be separated from paragraphs by a
blank line. </li>
<li> Add LaTeX or docbook output. </li>
</ul>
<table width="100%" class="navbox" cellpadding="1" cellspacing="0">
<tr>
<td align="center" width="16.6%">
<a class="nav" href="index.html">[Epydoc]</a></td>
<td align="center" width="16.6%">
<a class="nav" href="installing.html">[Installing]</a></td>
<td align="center" width="16.6%">
<a class="nav" href="using.html">[Using]</a></td>
<td align="center" width="16.6%">
<a class="nav" href="epytext.html">[Epytext]</a></td>
<td align="center" width="16.6%">
<a class="nav" href="http://www.cis.upenn.edu/~edloper/">[Author]</a></td>
<td align="center" width="16.6%">
<A href="http://sourceforge.net/projects/epydoc">
<IMG src="http://sourceforge.net/sflogo.php?group_id=32455&type=1"
width="88" height="26" border="0" alt="SourceForge"
align="top"/></A></td>
</tr>
</table>
<font size="-1">
<!-- hhmts start --> Last modified: Wed Sep 25 03:43:59 EDT 2002 <!-- hhmts end -->
</font>
</body>
</html>
|