http://blog.gmane.org/gmane.text.docutils.user hourly 1 1901-01-01T00:00+00:00 http://gmane.org/img/gmane-25t.png http://gmane.org http://comments.gmane.org/gmane.text.docutils.user/4714 ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Leo 2008-11-30T21:22:32 http://comments.gmane.org/gmane.text.docutils.user/4696 Hi, In a ReST file I have a custom interpreted text role called "graded" derived from the "strong" role. When writing HTML, I can use CSS to make that role styled the way I want--not only boldfaced, but a different color. I'd like to do something similar in LaTeX. I'm using rst2latex.py; I don't know if this matters. I kind of imagined that in the preamble for the written LaTeX file would be a command that initially defined "graded" as an alias for "strong", and called this graded role on the text that I used it for. Then I could customize the styling through a latex style file. Instead, I saw in the written file that text in the graded role is just marked up with standard \textbf{} and there's no way to distinguish that on the LaTeX level from text that I marked up in the regular strong role. I guess what I'm asking is if the class of the custom role gets passed to the LaTeX file anywhere. It seems not, since grepping the LaTeX file for the name of the custom role only turns up examples in the body text. Would rst2newlatex.py work differently? Do I need to put something in the source file to tell the LaTeX writer how to handle it? Thanks, Matt -- Matthew Leingang Clinical Associate Professor of Mathematics leingang< at >cims.nyu.edu ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Matthew Leingang 2008-11-18T13:33:46 http://comments.gmane.org/gmane.text.docutils.user/4691 Hi, Triying to install docutils, I have following error messages; ~/docutils-0.5/docutils/parsers/rst/states.py:2046 Deprecating Warning: Base Exception . Message has been deprecated as of Python 2.6 FAIL . test_node_class_names(test_nodes_MiscTests) FAILED (failures=1) I have to install the soft in order to use Salome, so I am really ....... What can I do ? Thanks a lot. jm ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ perpignan-66 2008-11-12T12:09:00 http://comments.gmane.org/gmane.text.docutils.user/4682 I've encountered a limitation of option lists: options may only have one option argument for the syntax requirements to be met. Something like this doesn't work: -r FROM TO, --replace=FROM TO replace "FROM" with "TO" I've seen a question on this list posted in September, which was about a similar issue: an option name that contains colons. The answer to that question was to use a simple name for that option and explain its syntax, which in the case of a path arguments sounds resonable. However, in my case, I find it misleading to use one option name for what is actually two option arguments, even if explained. Would it be possible to extend the syntax to allow for multiple option arguments, each of which might stay as simple as it is now? I'm not sure about getopt, whose supported syntax ReST's option lists are documented to implement, but multiple-argument options are well possible with Python's optparse standard module, so it's at least nothing wildly uncommon. Thomas Lotze 2008-11-11T17:05:28 http://comments.gmane.org/gmane.text.docutils.user/4680 Dear Docutils users, I have `plans for the latex2e writer development`__, but before changing too much I'd like to ask users about current use, preferences and wishes. __ http://docutils.sourceforge.net/sandbox/latex-variants/README.html (Sourceforge does no longer list directories without index file, see the content with SVN view under: http://svn.berlios.de/viewcvs/docutils/trunk/sandbox/latex-variants/) Questionaire ============ 1. Do you use custom stylesheets with Docutils-generated LaTeX files? 2. Would you prefer the stylesheet to be a LaTeX package: "*.sty" Input with \usepackage{}. +2 Existing LaTeX packages can be used as --stylesheet argument. +1 Command names can contain the char < at > (no \makeatletter needed). -1 Warnings, if home-made stylesheets do not use the proper LaTeX package commands. Expects the file extension ".sty": +1 Clear distinction between self-contained, complete LaTeX documents and style sheets (cf. *.html vs. *.css). -1 not backwards compatible. LaTeX inclusion: "*.tex" Input with \input{}. Expects file extension ".tex". -1 Some existing LaTeX packages fail if given as --stylesheet argument (as they must be called via \usepackage, e.g. in a home-made custom stylesheet). +-0 Command names with char < at > must be wrapped in \makeatletter \makeatother. +-0 Simpler syntax. +1 Backwards compatible. 3. Did you ever use a custom role and realize that the exported LaTeX code does not compile? 4. Did you ever use a custom role, ``myclass``, say and define a ``\docutilsrole<myclassname>`` LaTeX command for it? 5. If 4. == YES, how important is backwards compatibility? Would you update your style-sheets if the interface improves significantly but non-compatible? 6. Feature wishes or ideas of improvement for the latexe2 writer. Günter ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ _______________________________________________ Docutils-users mailing list Docutils-users< at >lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/docutils-users Please use "Reply All" to reply to the list. Guenter Milde 2008-11-11T08:43:50 http://comments.gmane.org/gmane.text.docutils.user/4678 Hi folks, I'm trying to catch the docutils error within Leo (a python outlining editor), and I can't seem to understand how to capture the error. Here's what I'm trying: try: res = pub.publish(argv=['--stylesheet=%s' % path]) except Exception, inst: print type(inst) # the exception instance print inst.args # arguments stored in .args print inst # __str__ allows args to printed directly raise inst Anybody know of a way to do this? If I run docutils from the command line, I get: docutils.utils.SystemMessage: <string>:376: (SEVERE/4) Title level inconsistent: I'd love a way to capture the contents of that error message and display it somehow. TIA Mike ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Mike Crowe 2008-11-07T16:18:02 http://comments.gmane.org/gmane.text.docutils.user/4675 Here is the message I received when trying to run the tests. Thanks C:\docutils\test>python alltests.py Testing Docutils 0.6 [snapshot 2008-10-30, r5709] with Python 2.5.2 on 2008-10-3 1 at 07:59:57 Working directory: C:\docutils\test Docutils package: C:\docutils\docutils ..F............................................................................. ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................ ====================================================================== FAIL: test_stylesheet_dependencies (test_dependencies.RecordDependenciesTests) ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docutils\test\test_dependencies.py", line 72, in test_stylesheet_depe ndencies self.assert_('data/stylesheet.txt' in self.get_record(**s)) AssertionError ---------------------------------------------------------------------- Ran 1088 tests in 11.735s FAILED (failures=1) Elapsed time: 14.860 seconds C:\docutils\test> ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Shaun Mahood 2008-10-31T14:10:12 http://comments.gmane.org/gmane.text.docutils.user/4673 Dear list, I am trying to parse docstrings of my Python modules using the following code: output = core.publish_parts(source=open('a.py'), source_path='', source_class=io.FileInput, reader_name="Python", writer = myWriter(), settings_overrides=overrides) where myWriter is a customized LaTeX2e writer. I got an error for even a very simple module # a=1 'b' def a(): ' adfd' pass The error message is: Traceback (most recent call last): File "test_rst.py", line 86, in ? settings_overrides=overrides) File "/usr/lib/python2.4/site-packages/docutils/core.py", line 433, in publish_parts enable_exit_status=enable_exit_status) File "/usr/lib/python2.4/site-packages/docutils/core.py", line 614, in publish_programmatically output = pub.publish(enable_exit_status=enable_exit_status) File "/usr/lib/python2.4/site-packages/docutils/core.py", line 204, in publish self.settings) File "/usr/lib/python2.4/site-packages/docutils/readers/__init__.py", line 69, in read self.parse() File "/usr/lib/python2.4/site-packages/docutils/readers/python/__init__.py", line 32, in parse module_section.walk(DocformatVisitor(self.document)) File "/usr/lib/python2.4/site-packages/docutils/nodes.py", line 135, in walk if child.walk(visitor): File "/usr/lib/python2.4/site-packages/docutils/nodes.py", line 127, in walk visitor.dispatch_visit(self) File "/usr/lib/python2.4/site-packages/docutils/nodes.py", line 1556, in dispatch_visit return method(node) File "/usr/lib/python2.4/site-packages/docutils/readers/python/__init__.py", line 54, in visit_attribute name = node[0][0].data AttributeError: 'Text' object has no attribute 'data' Am I doing anything wrong? Thanks. Bo ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Bo Peng 2008-10-28T16:45:58 http://comments.gmane.org/gmane.text.docutils.user/4664 ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Michael Koitz 2008-10-21T14:06:27 http://comments.gmane.org/gmane.text.docutils.user/4656 Hi members of the docutils mailing lists! I've recently discovered reStructuredText and I'm really fascinated. I like it very much. However, what I'm missing are line breaks. Normally, each paragraph becomes a <p> when converting to HTML (or a similar construct when converting to other formats). But sometimes, you want to separate two blocks of text *without* putting an empty line in between. I thought thoroughly about how line breaks could be realized in a comfortable way. I came up with the following idea: An option to connect paragraphs: Instead of defining a "line break" symbol, making it possible to connect two or more paragraphs using two "connection symbols" ( eg. { and } ). I'm going to explain what I mean by using an example: { reStructuredText is an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system. RST is designed for extensibility for specific application domains. Its parser is a component of Docutils. } This document defines the goals of reStructuredText and provides a history of the project. It is written using the reStructuredText markup... Converting to HTML, this would be transformed into something like: <p> reStructuredText is an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system. <br /> RST is designed for extensibility for specific application domains. Its parser is a component of Docutils. </p> <p> This document defines the goals of reStructuredText and provides a history of the project. It is written using the reStructuredText markup... </p> Which would result in the following visible output: reStructuredText is an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system. RST is designed for extensibility for specific application domains. Its parser is a component of Docutils. This document defines the goals of reStructuredText and provides a history of the project. It is written using the reStructuredText markup... Note that the word "RST" neither is in the same line as the preceding sentence, nor is at the beginning of a new paragraph after a blank line. Of course, as usual, the length of lines without line breaks depends on the document width (e.g. the window width of a browser displaying the HTML). Another example: { If you often get errors of the kind "Invalid configuration. Configuration file: config123.conf" you should do bla bla. } This would result in the following visible output: If you often get errors of the kind "Invalid configuration. Configuration file: config123.conf" you should do bla bla. Note that there are no empty lines in between. Without using the "connection symbols" it would be harder to read this as a single sentence because of the empty lines. The other possibility to write everything into a normal paragraph would also produce a rather ugly result. Finally, I want to list some advantages of the "connection symbols" idea I can think of: 1. People writing documents which make a vast use of both line breaks and normal separated paragraphs (e.g. novels) now could easily do this using reStructuredText. 2. The source code still is nicely readable. There are no "linebreak symbols" in the text blocks which would interrupt the reading flow. 3. Using the "connection symbols" doesn't force the user to change indention levels. So normal paragraphs and connected paragraphs could be mixed without making the source code look bad. AFAIK, indention would be required if one used a RST directive instead of the proposed "connection symbols". 4. Outputs like the one in my second example are possible which, at the moment, aren't possible. What do you think about this idea? ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Red Wraith 2008-10-19T16:06:27 http://comments.gmane.org/gmane.text.docutils.user/4651 ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Ryan Krauss 2008-10-17T11:50:20 http://comments.gmane.org/gmane.text.docutils.user/4646 Hi all. I did a cool hack recently, very similar in spirit to the rst-literals script I had written a while ago that can extract literal-blocks from ReST files. This time, instead of literal-blocks, I'm extracting field-lists that are embedded within a definition term that is a single word within brackets (see example below). It's entirely generic, you can define any kind of "object" and columns. The script is in my sandbox, feel free to try it out, I tried to make it as "automatic" as possible. If you have a postgres server and psycopg2, it should just be able to create database tables from rst documents, provided they contain entries as below. Anyway, here are the docs, any comments appreciated. Extract and store data entries from a set of reStructuredText documents. Entries look like this (all names are generic):: [book] :title: Probability Theory :subtitle: The Logic of Science :authors: E.T. Jaynes, G. Larry Bretthorst :isbn: 978-0521592710 You can have the data stored in an existing database, or in a file. This program can also automatically infer a database schema from the data (and create the tables). If you only store the data in a database, only the fields defined in the schema will be stored (the others will be dropped). This allows you to create your database tables ahead of time, as you like, and to have only valid fields filled with the data later. This script provides an ultra-simple way to store data that can be expressed as name-value pairs embedded in a text file (with other text). The typical kind of data that you would use this for would be for PIM data (e.g., books, addresses, links, etc.). A special source key is used in the outgoing data to identify the source file that each data entry came from. By default, the source is the filename, but you can set this source id in the file itself, by creating an 'Id' docinfo entry, at the top of the document, like this:: ======== My Title ======== :Id: <unique-id> ... About the outputs: If <OUTPUT> is a filename, SQL code or CSV is written to a file. However, if a connection string is provided, we run the commands on the given database. Warning: if an inferred schema definition is to be stored in a database, we first drop the data from those tables. About normalization: By default the field names are sanitized by attempting to remove plurals automatically, and the value strings are merged into a single line each. This can be optionally disabled. ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Martin Blais 2008-10-09T20:19:32 http://comments.gmane.org/gmane.text.docutils.user/4643 Consider http://mentat.za.net/numpy/numpy_advanced_slides/ Do you know why the display get muddled if you switch to full screen on FireFox 3? It seems to be a problem with the fixed-width font display? This is the first time I've ever experienced better performance on IE than FireFox. Is it just the display I am using at work, or a known bug, or ...? Thanks, Alan Isaac ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Alan G Isaac 2008-10-09T17:43:38 http://comments.gmane.org/gmane.text.docutils.user/4639 ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Ryan Krauss 2008-10-09T02:25:59 http://comments.gmane.org/gmane.text.docutils.user/4637 I'm using rest2web_ to maintain my website, so all my individual pages are in restructured text. If you're not familiar with it, rest2web basically calls something like docutils.core.publish_parts(...writer_name='html'...) for each page in a directory. I've run into the situation where I have a paragraph in one page that I'd like to link to from another page. Specifically, I want to link to a single publication in a list of publications, something like:: ... some publications ... Steven Bethard, James H. Martin and Sara Klingenstein. `Finding Temporal Structure in Text: Machine Learning of Syntactic Temporal Relations`_. *International Journal of Semantic Computing (IJSC)*, 1(4), December 2007. ... more publications ... Now, since it's just a plain paragraph, the html writer just doesn't output an element that I can link to. It outputs just a simple paragraph like:: <p>Steven Bethard, James H. Martin and Sara Klingenstein... What can I do to get an id for the paragraph element there? Basically, I'd like to see something like the following generated:: <p id="finding-temporal-structure-in-text"> Steven Bethard, James H. Martin and Sara Klingenstein... Then I could link directly to that paragraph with a url like http://verbs.colorado.edu/~bethard/publications.html#finding-temporal-structure-in-text Hope my explanation made sense, and thanks in advance for your help! Steve .. _rest2web: http://www.voidspace.org.uk/python/rest2web/ ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Steven Bethard 2008-10-03T16:35:36 http://comments.gmane.org/gmane.text.docutils.user/4629 Howdy all, I'm glad to see that Engelbert Gruber <grubert< at >users.sf.net> has made available a ManPage writer for Docutils <URL:http://docutils.sourceforge.net/sandbox/grubert/man/>. What I don't know is how to make use of this. I don't want to hack on the installed docutils software; that's managed by my operating system package manager and it would be a mistake to mess about manually with those files. Ideally what I'd like is to have an ‘rst2man’ command that uses Engelbert's work as a writer with the existing docutils. Failing that, I'd like to see what is needed to get us there. I've read some of the documentation at the Docutils site, but e.g. <URL:http://docutils.sourceforge.net/docs/dev/hacking.html> says little more on this topic than “Figure out whether you want a Parser, a Transform, or a Writer”. Well, that decision is already made — I need a Writer, and fortunately I have one — but now what? I realise it's not as simple as:: $ cp -a man/ $HOME/.docutils/writers/. $ docutils --writer 'ManPage' < foo.txt > foo.1 but what *is* the process? (If it *is* that simple, I'd be very happy to be told!) Ben Finney 2008-09-30T09:36:12 http://comments.gmane.org/gmane.text.docutils.user/4628 Moin, I use REST with Plone and have questions about field list. I'm not sure if this are REST or Plone Problems. 1. If the fieldname is longer then 14 characters the column is rendered with colspan=2 and the value is rendered in the next row. Is it possible to set the width of the fieldname? 2. There is a colon set after the fieldname. Is it possible to supress this colon? 3. If I put a fieldlist after a fieldlist separated by a linefeed the are rendered as one table. I put commets between to get two tables. How do I separate fieldlist? Many thanks Matthias ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Matthias Teege 2008-09-30T07:12:46 http://comments.gmane.org/gmane.text.docutils.user/4625 The site updating script can no longer be run. SF no longer offers shell access, although that may be temporary. Details here: http://sourceforge.net/community/forum/topic.php?id=3518&page http://sourceforge.net/community/forum/topic.php?id=3505&page The updating script is here: http://svn.berlios.de/viewcvs/*checkout*/docutils/trunk/sandbox/infrastructure/docutils-update The script needs to be reworked to use SCP instead of SSH. It should probably be reworked to checkout the repo & build the site locally, instead of executing on the berlios.de server. I don't have time to work on this right now. Can anybody help with this? David Goodger 2008-09-25T14:52:12 http://comments.gmane.org/gmane.text.docutils.user/4621 I am trying to implement a math directive using matplotlib and am running into a problem. Here's my directive: class Math(rst.Directive): has_content = True def run(self): # Raise an error if the directive does not have contents. #self.assert_has_content() return [ math_node(''.join(self.content),''.join(self.content)) ] def __repr__(self): return u''.join(self.content) class math_node(Element): children = () def __init__(self,data,rawsource): Element.__init__(self,rawsource) self.rawsource=rawsource self.math_data=data directives.register_directive('math', Math) It works great when I use it like this: .. math:: $\alpha$ Or like this: .. math:: $\alpha$ But this gives me a warning: .. |AA| math:: $\alpha$ <string>:15: (WARNING/2) Substitution definition "AA" empty or invalid. .. |AA| math:: $\alpha$ So I am getting a "problematic" node in the output. and I get the alpha at the place where the subst is defined instead. Is there anything a directiveneeds to do to be usable in this way? I know registering a role is probably a better idea, but I would like this to work like it does for the image directive. Roberto Alsina 2008-09-25T02:26:47 http://comments.gmane.org/gmane.text.docutils.user/4614 Hi all, We have recently started using docutils to document some of our COM interfaces using docs embedded in the code, the results have been very pleasing, but I want to ask if we are approaching one aspect of the documentation design in the right way. We wanted to have some markup to document the parameters and return values to each of the functions, so I came up with the following directive syntax. .. param :: ParamName Documentation for ParamName here. .. return :: Something Useful. I register the directives using register_directive, and this all works wonderfully for our html generated documentation. (ultimately in a .chm shudder!) However, we also generate a python wrapper and use the same documentation for the docstrings, so that each function looks like this def Function(ParamName) : """Blah. ..param :: ParamName Documentation for ParamName here. .. return :: Something Useful. """ So the problem with this is that although it is perfectly readable to a human, it is not readable to other general purpose docutils tools - they complain about there not being a param/return directive. We could register them as canonical directives, but somehow that seems wrong because this is an application specific thing, and our end users are unlikely to want to modify their docutils tools. Also, I like to imagine a day when all python modules are documented using docutils, and there is a help tool (possibly hooked into an editor) that reads them on the fly, and those tools would need to know about our directives as well. So, in short, is there a better solution to this? Is there a general purpose solution to domain specific extensions? Or is this particular domain specific solution general enough to warrant an extension to the docutils core? Many thanks Sam ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Sam Partington 2008-09-23T10:11:03 http://comments.gmane.org/gmane.text.docutils.user/4612 Hi all -- At work, my colleagues and I need to write some good old-fashioned Unix man pages. So we brainstormed for 15 seconds or so and came up with a list of candidate markup systems: asciidoc, POD, and docutils/rST. We have an intern doing the gruntwork, so all I have to do is stand back while he evaluates the contenders and make sure he picks the right one. ;-) To my surprise, it appears that the right choice is still, after all these years, POD. If I understand things correctly, docutils has no support for generating man pages out of the box. You have to checkout http://svn.berlios.de/svnroot/repos/docutils/trunk/sandbox/manpage-writer separately and use its rst2man script. Furthermore, the sandbox manpage-writer appears to be in a state of flux: for example, it crashes on its own man page (rst2man.txt) because of some NotImplemented exceptions in the code. So what's the deal with this code? Is it being actively developed as we speak? Or is it in need of a little attention? Thanks -- Greg ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Greg Ward 2008-09-22T14:39:44 Search the mailing list at Gmane query http://search.gmane.org/?group=$group=gmane.text.docutils.user