Docs and the :manpage: tag

Nic Bernstein nic at
Thu Aug 13 11:00:49 EDT 2015

On 08/13/2015 12:15 AM, Nicola Nye wrote:
> Delicious victory is mine!
> We now have a :cyrusman: sphinx option which generates urls into our 
> tree, performing string munging magic to match 
> the generated url to our directory and filename structure.
> Now, to look at updating all the references in our existing docs so 
> that it uses the new tag...

Doesn't work for me.

I pulled your changes, and then ran the following script to replace all 
:manpage: references with :cyrusman:

    $ for file in `grep -lR ":manpage:" source/imap`; do sed -i $file -e 's/:manpage:/:cyrusman:/g'; done

Then I ran a build:

    $ make man html
    sphinx-build -b cyrman -d build/doctrees   source build/man
    Running Sphinx v1.2.2
    Initializing cyrusman plugin
    loading pickled environment... done
    building [cyrman]: all manpages
    updating environment: [extensions changed] 274 added, 18 changed, 0 removed
    reading sources... [  3%] imap/admin/access-control/rights-reference
    Exception occurred:
       File "/home/nic/Checkouts/", line 49, in man_role
         manpage_num =
    AttributeError: 'NoneType' object has no attribute 'group'
    The full traceback has been saved in /tmp/sphinx-err-yWaXf3.log, if you want to report the issue to the developers.

Full traceback is attached.


Nic Bernstein                             nic at
Onlight llc.                    
219 N. Milwaukee St., Ste. 2A	          v. 414.272.4477
Milwaukee, Wisconsin  53202		  f. 414.290.0335

-------------- next part --------------
An HTML attachment was scrubbed...
-------------- next part --------------
A non-text attachment was scrubbed...
Name: sphinx-err-yWaXf3.log
Type: text/x-log
Size: 7710 bytes
Desc: not available
Url : 

More information about the Cyrus-devel mailing list