Re: [Xen-API] XCP Documentation Update

[Jonathan Ludlam <Jonathan.Ludlam@xxxxxxxxxxxxx>]

Hi Todd,

As I understand this, the problem is a bit more of a organisational one than a 
focused one of getting the docbook to compile. The trouble is that there is a 
lot of documentation for XenServer that could possibly be used for XCP, but a 
simple s/XenServer/XCP/g isn't going to be sufficient. We really need to get 
together with documentation team here to work out how best we can produce a set 
of docs for XCP and one for XenServer without horrendous duplication of effort, 
or things being fixed in one branch and not the other, and all the other pains 
associated with forking.

Jon



On 6 Nov 2010, at 21:16, Todd Deshane wrote:

> I looked into this issue a bit more.
> 
> It seems as though it could be compiled with openjade, for example
> http://tldp.org/HOWTO/DocBook-OpenJade-SGML-XML-HOWTO/x456.html, but
> during compilation to HTML (before going to PDF), I get the following
> errors
> 
> reference.xml:8:2:E: cannot find "../local.ent"; tried
> "../local.ent", "/usr/local/share/sgml/../local.ent",
> "/usr/share/sgml/../local.ent"
> 
> penjade:reference.xml:120:0:E: cannot find
> "../shared/hosts_pools_intro.ent"; tried
> "../shared/hosts_pools_intro.ent",
> "/usr/local/share/sgml/../shared/hosts_pools_intro.ent",
> "/usr/share/sgml/../shared/hosts_pools_intro.ent"
> 
> Plus lots of other undefined references.
> 
> The command I tried was:
> openjade -t xml -d
> /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl#html
> /usr/share/xml/declaration/xml.dcl reference.xml
> 
> Any ideas on how we can get this working?
> 
> Thanks,
> Todd
> 
> 
> On Thu, Sep 30, 2010 at 5:43 AM, Magnus Therning
> <magnus.therning@xxxxxxxxxxxxx> wrote:
>> On 29/09/10 02:58, Todd Deshane wrote:
>>> On Mon, Sep 20, 2010 at 10:37 AM, Todd Deshane <deshantm@xxxxxxxxx> wrote:
>>>> On Tue, Jul 27, 2010 at 9:20 AM, Stephen Spector
>>>> <stephen.spector@xxxxxxxxxx> wrote:
>>>>> XCP Folks:
>>>>> 
>>>>> 
>>>>> 
>>>>> I have taken down the Xen Cloud Platform Administrative Guide from the
>>>>> Xen.org website for some maintenance. Several people have found some 
>>>>> content
>>>>> that needed to be removed and I am having problems re-converting the 
>>>>> updated
>>>>> XML file into pdf. The document will remain UNDER CONSTRUCTION until I can
>>>>> get a new pdf created. Please let me know if you are an XML expert and I 
>>>>> can
>>>>> send you the updated copy for compile(?).
>>>> 
>>>> Something like:
>>>> http://www.xmlmind.com/xmleditor/_distrib/doc/commands/docbook_to_pdf.html
>>>> 
>>>> Is there a makefile in the Xen Server code that we could use?
>>> 
>>> Is anyone working on this? Is more community help needed?
>> 
>> I suspect this was forgotten due to Steven recently leaving xen.org.  I'll 
>> see
>> what I can find out about hits.
>> 
>> Cheers,
>> M
>> 
>> --
>> Magnus Therning
>> magnus.therning@xxxxxxxxxxxxx          Jabber: magnusth@eng
>> 
>> There does not now, nor will there ever, exist a programming language
>> in which it is the least bit hard to write bad programs.
>>     -- Flon's Axiom
>> 
>> _______________________________________________
>> xen-api mailing list
>> xen-api@xxxxxxxxxxxxxxxxxxx
>> http://lists.xensource.com/mailman/listinfo/xen-api
>> 
> 
> 
> 
> -- 
> Todd Deshane
> http://todddeshane.net
> http://runningxen.com
> 
> _______________________________________________
> xen-api mailing list
> xen-api@xxxxxxxxxxxxxxxxxxx
> http://lists.xensource.com/mailman/listinfo/xen-api


_______________________________________________
xen-api mailing list
xen-api@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/mailman/listinfo/xen-api