<html>
<head>
<style>
body {
font-family: Verdana, sans-serif;
font-size: 0.8em;
color:#484848;
}
h1, h2, h3 { font-family: "Trebuchet MS", Verdana, sans-serif; margin: 0px; }
h1 { font-size: 1.2em; }
h2, h3 { font-size: 1.1em; }
a, a:link, a:visited { color: #2A5685;}
a:hover, a:active { color: #c61a1a; }
a.wiki-anchor { display: none; }
fieldset.attachments {border-width: 1px 0 0 0;}
hr {
width: 100%;
height: 1px;
background: #ccc;
border: 0;
}
span.footer {
font-size: 0.8em;
font-style: italic;
}
</style>
</head>
<body>
Issue #3220 has been updated by Peter Cock.
<ul>
<li><strong>Status</strong> changed from <i>In Progress</i> to <i>Closed</i></li>
<li><strong>% Done</strong> changed from <i>20</i> to <i>100</i></li>
</ul>
<p>We made the switch to using reStructuredText by default with epydoc for Biopython 1.67 (although there are likely still visual glitches waiting to be reported). Closing.</p>
<hr />
<h1><a href="https://redmine.open-bio.org/issues/3220#change-15295">Feature #3220: Port Biopython docstrings to reStructuredText</a></h1>
<ul><li>Author: Eric Talevich</li>
<li>Status: Closed</li>
<li>Priority: Low</li>
<li>Assignee: Biopython Dev Mailing List</li>
<li>Category: Documentation</li>
<li>Target version: </li>
<li>URL: </li></ul>
<p>The first part of the effort to port Biopython's documentation to Sphinx is to convert our API docs from Epytext to reStructuredText. Plain text will generally work.</p>
<p>Epydoc already supports using reStructuredText as a markup language instead of the default Epytext, so this isn't as painful as it sounds. This can be done one module at a time, changing the format declaration at the top from:<br /><pre>
__docformat__ = "epytext en"
</pre><br />to:<br /><pre>
__docformat__ = "restructuredtext en"
</pre></p>
<p>And changing any Epytext markup in the docstrings to valid rST.</p>
<p>Note that this adds the dependency of Docutils when generating API docs, in addition to the current dependency on Epydoc. Since documentation is normally built ahead of the time when packaging stable Biopython releases, this shouldn't be a problem for end users, and may be a small inconvenience for developers who want to work on the documentation.</p>
<p>See:<br /><a class="external" href="http://epydoc.sourceforge.net/manual-othermarkup.html">http://epydoc.sourceforge.net/manual-othermarkup.html</a><br /><a class="external" href="http://docutils.sourceforge.net/rst.html">http://docutils.sourceforge.net/rst.html</a></p>
<hr />
<span class="footer"><p>You have received this notification because you have either subscribed to it, or are involved in it.<br />To change your notification preferences, please click here and login: <a class="external" href="http://redmine.open-bio.org">http://redmine.open-bio.org</a></p></span>
</body>
</html>