[Openstack-docs] Newbie Questions

Joe Topjian joe.topjian at cybera.ca
Fri Mar 29 22:32:39 UTC 2013


Build succeeded. Thank you both - I'll be sure to focus on validation if I
ever get vague errors. :)


On Fri, Mar 29, 2013 at 3:32 PM, Anne Gentle <anne at openstack.org> wrote:

> What I do when the build fails is open the bk_*.xml file in Oxygen and see
> if it validates. In this case, there are missing xml:id attributes on
> sections recently added. (Note that individual chapter files may not
> validate when they have linkend references, a known issue.)Fixed here:
> https://review.openstack.org/25758
>
> Anne
>
>
>
>
> On Fri, Mar 29, 2013 at 4:02 PM, Lorin Hochstein <lorin at nimbisservices.com
> > wrote:
>
>> Joe:
>>
>> I wrote a docbook schema validation script that might give you more
>> helpful error messages than Maven. It's included in the repo. To run it, do
>> from the openstack-manuals root:
>>
>> tools/validate.py
>>
>> It's been failing for a while so it may pick up issues unrelated to your
>> specific changes.
>>
>> Lorin
>>>> Sent from Mailbox <https://bit.ly/SZvoJe> for iPhone
>>
>>
>> On Fri, Mar 29, 2013 at 3:58 PM, Joe Topjian <joe.topjian at cybera.ca>wrote:
>>
>>> Hello,
>>>
>>> I'm working on Bug 1117767 (GlusterFS and Cinder) and have a few
>>> questions:
>>>
>>> 1. Is it OK to have changes to multiple books in one commit? For this
>>> bug, I edited the Compute, Block, and Ops books.
>>>
>>> 2. I'm getting an error when trying to generate the Compute Admin book.
>>> This happens on my modified repo and a clean repo:
>>>
>>> [INFO]
>>> ------------------------------------------------------------------------
>>> [INFO] BUILD FAILURE
>>> [INFO]
>>> ------------------------------------------------------------------------
>>> [INFO] Total time: 1:03.474s
>>> [INFO] Finished at: Fri Mar 29 13:50:36 MDT 2013
>>> [INFO] Final Memory: 100M/346M
>>> [INFO]
>>> ------------------------------------------------------------------------
>>> [ERROR] Failed to execute goal
>>> com.rackspace.cloud.api:clouddocs-maven-plugin:1.7.2:generate-webhelp
>>> (generate-webhelp) on project openstack-guide: Failed to transform
>>> bk-compute-adminguide.xml. Processing terminated by xsl:message at line 222
>>> -> [Help 1]
>>> [ERROR]
>>> [ERROR] To see the full stack trace of the errors, re-run Maven with the
>>> -e switch.
>>> [ERROR] Re-run Maven using the -X switch to enable full debug logging.
>>> [ERROR]
>>> [ERROR] For more information about the errors and possible solutions,
>>> please read the following articles:
>>> [ERROR] [Help 1]
>>> http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
>>>
>>> The link says that the error is plugin-specific which is beyond me at
>>> the moment. Any ideas?
>>>
>>> Thanks,
>>> Joe
>>>
>>> --
>>> Joe Topjian
>>> Systems Administrator
>>> Cybera Inc.
>>>
>>> www.cybera.ca
>>>
>>> Cybera is a not-for-profit organization that works to spur and support
>>> innovation, for the economic benefit of Alberta, through the use
>>> of cyberinfrastructure.
>>>
>>
>>
>> _______________________________________________
>> Openstack-docs mailing list
>> Openstack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>>
>


-- 
Joe Topjian
Systems Administrator
Cybera Inc.

www.cybera.ca

Cybera is a not-for-profit organization that works to spur and support
innovation, for the economic benefit of Alberta, through the use
of cyberinfrastructure.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130329/3d3fca0e/attachment-0001.html>


More information about the Openstack-docs mailing list