<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
Nicola,<br>
Well, still not working for me. Is it working for you?<br>
<br>
Here's what I get after performing a "git pull":<br>
<blockquote>
<pre><a class="moz-txt-link-abbreviated" href="mailto:nic@flatboy:~/Checkouts/cyrus.foundation/cyrus-docs$">nic@flatboy:~/Checkouts/cyrus.foundation/cyrus-docs$</a> for file in `grep -lR ":manpage:" source/imap`; do sed -i $file -e 's/:manpage:/:cyrusman:/g'; done
<a class="moz-txt-link-abbreviated" href="mailto:nic@flatboy:~/Checkouts/cyrus.foundation/cyrus-docs$">nic@flatboy:~/Checkouts/cyrus.foundation/cyrus-docs$</a> make man html
sphinx-build -b cyrman -d build/doctrees source build/man
Running Sphinx v1.2.2
Initializing cyrusman plugin
loading pickled environment... not yet created
building [cyrman]: all manpages
updating environment: 274 added, 0 changed, 0 removed
reading sources... [ 6%] imap/admin/commands/ctl_conversationsdb
:cyrusman: error:
imap/admin/commands/ctl_conversationsdb: 159: Missing man page section for 'cyrus-master(8)'.
make: *** [man] Error 1
</pre>
</blockquote>
It struck me as odd that the error message, about no man page
section, itself included a man page section. Upon checking, I see
this:<br>
<blockquote>
<pre>See Also
========
:cyrusman:`imapd.conf(5)`, :cyrusman:`cyrus-master(8)`
</pre>
</blockquote>
So I think whatever check your cyrusman 'role' is performing has a
problem.<br>
<br>
It's too late in the evening, being 3-scotch o'clock, for me to
diagnose this from this side of the world. ;-0<br>
-nic<br>
<br>
<div class="moz-cite-prefix">On 08/13/2015 09:25 PM, Nicola Nye
wrote:<br>
</div>
<blockquote
cite="mid:1439519126.2727914.355874537.07C73543@webmail.messagingengine.com"
type="cite">
<title></title>
<div>Hi Nic,<br>
</div>
<div> <br>
</div>
<div>There were a bunch of :manpage: references that were missing
the (x) section number. I've amended the pages and committed a
new version of the code which provides better reporting.<br>
</div>
<div> <br>
</div>
<div>Do you know if there's any :manpage: references that are
referencing non-cyrus content? (We don't want to :cyrusman:ls
for instance)<br>
</div>
<div> <br>
</div>
<div> Let me know if this works any better for you!<br>
</div>
<div> <br>
</div>
<div>On Fri, Aug 14, 2015, at 01:00 AM, Nic Bernstein wrote:<br>
</div>
<blockquote type="cite">
<div>On 08/13/2015 12:15 AM, Nicola Nye wrote:<br>
</div>
<div> <br>
</div>
<blockquote type="cite"
cite="mid:1439442908.2065313.355003409.083DA734@webmail.messagingengine.com">
<div>Delicious victory is mine!<br>
</div>
<div> <br>
</div>
<div>We now have a :cyrusman: sphinx option which generates
urls into our docs.cyrus.foundation tree, performing string
munging magic to match the generated url to our directory
and filename structure.<br>
</div>
<div> <br>
</div>
<div>Now, to look at updating all the references in our
existing docs so that it uses the new tag...<br>
</div>
<div> <br>
</div>
</blockquote>
<div> <br>
</div>
<div>Nicola,<br>
</div>
<div>Doesn't work for me.<br>
</div>
<div> <br>
</div>
<div>I pulled your changes, and then ran the following script to
replace all :manpage: references with :cyrusman:<br>
</div>
<div> <br>
</div>
<blockquote>
<pre>$ for file in `grep -lR ":manpage:" source/imap`; do sed -i $file -e 's/:manpage:/:cyrusman:/g'; done
</pre>
</blockquote>
<div>Then I ran a build:<br>
</div>
<div> <br>
</div>
<blockquote>
<pre>$ 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
<span class="colour" style="color:rgb(204, 0, 0)">Exception occurred</span>:
File "/home/nic/Checkouts/cyrus.foundation/cyrus-docs/source/exts/sphinxlocal/writers/cyrusman.py", line 49, in man_role
manpage_num = m.group(2)
AttributeError: 'NoneType' object has no attribute 'group'
<span class="colour" style="color:rgb(204, 0, 0)">The full traceback has been saved in /tmp/sphinx-err-yWaXf3.log, if you want to report the issue to the developers.</span>
</pre>
</blockquote>
<div>Full traceback is attached.<br>
</div>
<div> <br>
</div>
<div>Cheers,<br>
</div>
<div>-nic<br>
</div>
<div> <br>
</div>
<pre>--
Nic Bernstein <a moz-do-not-send="true" href="mailto:nic@onlight.com">nic@onlight.com</a>
Onlight llc. <a moz-do-not-send="true" href="http://www.onlight.com">www.onlight.com</a>219 N. Milwaukee St., Ste. 2A v. 414.272.4477
Milwaukee, Wisconsin 53202 f. 414.290.0335
</pre>
<p>Email had 1 attachment:<br>
</p>
<ul>
<li>
<div><code>sphinx-err-yWaXf3.log</code><br>
</div>
<div> 8k (text/x-log)<br>
</div>
</li>
</ul>
</blockquote>
<div> <br>
</div>
</blockquote>
<br>
<pre class="moz-signature" cols="72">--
Nic Bernstein <a class="moz-txt-link-abbreviated" href="mailto:nic@onlight.com">nic@onlight.com</a>
Onlight Inc. <a class="moz-txt-link-abbreviated" href="http://www.onlight.com">www.onlight.com</a>
6525 W Bluemound Rd., Ste 24 v. 414.272.4477
Milwaukee, Wisconsin 53213-4073 f. 414.290.0335
</pre>
</body>
</html>