<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>
<br>
Message: 2<br>
Date: Mon, 23 Mar 2015 19:21:56 +0900<br>
From: "Bernd Bausch" <<a href="mailto:berndbausch@gmail.com">berndbausch@gmail.com</a>><br>
To: <<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>><br>
Subject: [OpenStack-docs] Sphinx error when building in<br>
        openstack-manuals<br>
Message-ID: <011201d06553$32f2faa0$98d8efe0$@<a href="http://gmail.com" target="_blank">gmail.com</a>><br>
Content-Type: text/plain;       charset="us-ascii"<br>
<br>
My goal is to add a page to openstack-manuals (it describes policy.json).<br>
While its best location would be the configuration guide, there is only one<br>
directory with RST files, "playground-user-guide". So I put it there.<br>
<br>
Maven is not interested in the playground, since there is no pom.xml.<br>
Therefore, I run Sphinx directly.<br>
<br>
1- add policy.rst to openstack-manuals/doc/playground-user-guide/source<br>
2- add it to the table of contents in index.rst<br>
3- in the source directory, "sphinx-build -b html . my-output-directory"<br>
<br>
<br>
Sphinx throws this at me:<br>
<br>
File<br>
"/home/bbausch/openstack/policy/openstack-manuals/doc/playground-user-guide/<br>
sphinx-ext/scope.py", line 32, in builder_inited<br>
    path = os.path.join(app.env.srcdir, doc + app.env.config.source_suffix)<br>
TypeError: coercing to Unicode: need string or buffer, list found<br>
<br>
When I remove the "scope" extension from conf.py, sphinx-build completes<br>
successfully. I doubt this is the solution, though.<br>
<br>
I guess I miss something somewhere. What could it be?<br>
<br>
Bernd<br>
OpenStack apprentice<br>
<br><br></blockquote><div><br></div><div>I'm investigating. </div><div><br></div><div>When building master branch this morning, if I build anything I get a WARNING on any of the files that are marked admin_only, even when I build with the tag in the command line. I'll see what's up by working on it today, look for a patch (your) overnight if we get it figured out. </div><div><br></div><div>Thanks for reporting -</div><div>Anne</div><div><br></div><div><br></div></div><br></div></div>