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

[Nicola Nye]

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
at
migrating the website from Sphinx to some wiki variant in order to make
it
easier for contributors to add to the documentation.

Obviously this then allows greater flexibility in building the man
pages:
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...
https://plus.google.com/hangouts/_/g4xnqjjb5zvomzeb4kqvja3fz4a

Or shoot through your ideas on the list!

   Nicola

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
> >
> >
> > REPOSITORY
> >    rD cyrus-docs
> >
> > CHANGES SINCE LAST UPDATE
> >    https://git.cyrus.foundation/D44?vs=90&id=96
> >
> > BRANCH
> >    dev/update-command-man-pages
> >
> > REVISION DETAIL
> >    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)