Re: [Xen-API] XCP Documentation Update

[Todd Deshane <todd.deshane@xxxxxxx>]

Hi Jon,

> 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.
>

I am starting to get a better sense of what we need to do. I will take
a closer look at this next week. I've read through the docs and have
some questions and comments.

I follow up with you offline to get a good contact on the documentation team.

Thanks,
Todd

> 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
>
>



-- 
Todd Deshane
http://todddeshane.net
http://runningxen.com

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