WARNING - OLD ARCHIVES

This is an archived copy of the Xen.org mailing list, which we have preserved to ensure that existing links to archives are not broken. The live archive, which contains the latest emails, can be found at http://lists.xen.org/
   
 
 
Xen 
 
Home Products Support Community News
 
   
 

xen-api

Re: [Xen-API] XCP Documentation Update

To: Jonathan Ludlam <Jonathan.Ludlam@xxxxxxxxxxxxx>
Subject: Re: [Xen-API] XCP Documentation Update
From: Todd Deshane <todd.deshane@xxxxxxx>
Date: Tue, 23 Nov 2010 15:49:43 -0500
Cc: Magnus Therning <Magnus.Therning@xxxxxxxxxxxxx>, "xen-api@xxxxxxxxxxxxxxxxxxx" <xen-api@xxxxxxxxxxxxxxxxxxx>
Delivery-date: Tue, 23 Nov 2010 12:50:22 -0800
Dkim-signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:mime-version:sender:received :in-reply-to:references:from:date:x-google-sender-auth:message-id :subject:to:cc:content-type:content-transfer-encoding; bh=Fk+gU6vowFBp5vkTYvyxNC63a6FMTFel7TxXiLiqMNE=; b=gBliS0CE0Cp76EUrSruhiM79f2ZAmgttuRS1i8dUBvesgEYXMHryZ+hRMkgTtmC05+ 3XLSi3ElBeLeRD9oLXVcfE3gy5Qdbn0xUBfRrnuKGtsJW0H3vZUH2R5K6wESL6clO8uX KsrpPaDGZyRK8rlOKbI8kZJAFBaACJHW9/G4M=
Domainkey-signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type :content-transfer-encoding; b=VTNe1HhyAOjAFbpkM1lhtqfnUtuAwX7zBxZbBFcW+0AT5+2VGf+vh0YkvrrLVP44vw 9N05suZT/olbsFMWsrTU+oRrPcKDjuqi5TxUE9RMtfIHYC3osdGBuA4672xLuQgtPJ9L 0wCvnYJ5r5BqbRMDVNPm2Xz+xohqMPYvnbngM=
Envelope-to: www-data@xxxxxxxxxxxxxxxxxxx
In-reply-to: <3DF3667B-8BF3-4F21-BA7B-7D307665963B@xxxxxxxxxxxxx>
List-help: <mailto:xen-api-request@lists.xensource.com?subject=help>
List-id: Discussion of API issues surrounding Xen <xen-api.lists.xensource.com>
List-post: <mailto:xen-api@lists.xensource.com>
List-subscribe: <http://lists.xensource.com/mailman/listinfo/xen-api>, <mailto:xen-api-request@lists.xensource.com?subject=subscribe>
List-unsubscribe: <http://lists.xensource.com/mailman/listinfo/xen-api>, <mailto:xen-api-request@lists.xensource.com?subject=unsubscribe>
References: <652FFB2C8F91E3428799B1FFF8B490C9857D1140AF@xxxxxxxxxxxxxxxxxxxxxxxxx> <AANLkTingg=jYKJ9Ohaa=tuBKFFKAoER6iU_Pntsd1Wko@xxxxxxxxxxxxxx> <AANLkTin4Dxn+4nTMvGaEo90De0HMws3Ldkreg-8_vyvu@xxxxxxxxxxxxxx> <4CA45BAB.2060505@xxxxxxxxxxxxx> <AANLkTi=na0WByj6Q-+UkXfsYB4MdWqDdxiesjWgMsQET@xxxxxxxxxxxxxx> <3DF3667B-8BF3-4F21-BA7B-7D307665963B@xxxxxxxxxxxxx>
Sender: xen-api-bounces@xxxxxxxxxxxxxxxxxxx
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

<Prev in Thread] Current Thread [Next in Thread>