[Differential] [Updated, 2,615 lines] D44: Update reStrusctured Text versions of man pages

Nicola Nye nicolan at fastmail.com
Thu Jun 11 06:03:26 EDT 2015

Hi Nic,

I'm not a Python person either by any means, but to my untrained eye
your updates look good.

For what it's worth, Bron and I were discussing whether we should look
migrating the website from Sphinx to some wiki variant in order to make
easier for contributors to add to the documentation.

Obviously this then allows greater flexibility in building the man
we can leave them off the online docs and just leave them to ship with
the cyrus package, or we find another way to include them online
(which might just mean we end up with a different, but still slightly 
annoying process, such as wikihtml2man!).

Something to discuss at today's meeting...

Or shoot through your ideas on the list!


On Thu, Jun 11, 2015, at 08:55 AM, Nic Bernstein wrote:
> Nicola,
> I've just made a big commit in D44, and would appreciate another set of 
> eyes on it prior to accepting it.
> In this commit are the new Sphinx extension for manpage building, as 
> well as a load of said man pages.
> My specific concerns are to verify that the Sphinx extension works for 
> others as well as for me.  Also, as I am not a Python person, I think 
> we'd really benefit from someone who is looking at the extent of my 
> subclassing in the new extension.  I am not really sure if I've managed 
> to do as little as possible there (which is what I think we'd prefer).
> Please take a look and let me know.
> Cheers,
>      -nic
> On 06/10/2015 05:45 PM, onlight (Nic Bernstein) wrote:
> > onlight updated this revision to Diff 96.
> > onlight added a comment.
> >
> > More man page updates and cleanup.  New Sphinx extension.
> >
> > - Fix building of man pages and port more over
> > - More updates to man pages from cyrus-imapd/man
> >
> >
> >    rD cyrus-docs
> >
> >    https://git.cyrus.foundation/D44?vs=90&id=96
> >
> >    dev/update-command-man-pages
> >
> >    https://git.cyrus.foundation/D44
> -- 
> Nic Bernstein                             nic at onlight.com
> Onlight, Inc.                             www.onlight.com
> 1442 N Farwell Ave., Suite 600            v. 414.272.4477
> Milwaukee, Wisconsin  53202
> Email had 1 attachment:
> + nic.vcf
>   1k (text/x-vcard)

More information about the Cyrus-devel mailing list