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

Re: [Xen-devel] Xen 3.0 documentation changes

To: Steven Hand <Steven.Hand@xxxxxxxxxxxx>
Subject: Re: [Xen-devel] Xen 3.0 documentation changes
From: Robb Romans <FMJ@xxxxxxxxxx>
Date: Wed, 07 Dec 2005 12:51:09 -0600
Cc: Xen Devel List <xen-devel@xxxxxxxxxxxxxxxxxxx>
Delivery-date: Wed, 07 Dec 2005 18:51:54 +0000
Envelope-to: www-data@xxxxxxxxxxxxxxxxxxx
In-reply-to: <E1Ek3aI-0001xu-00@xxxxxxxxxxxxxxxxx> (Steven Hand's message of "Wed, 07 Dec 2005 18:00:06 +0000")
List-help: <mailto:xen-devel-request@lists.xensource.com?subject=help>
List-id: Xen developer discussion <xen-devel.lists.xensource.com>
List-post: <mailto:xen-devel@lists.xensource.com>
List-subscribe: <http://lists.xensource.com/cgi-bin/mailman/listinfo/xen-devel>, <mailto:xen-devel-request@lists.xensource.com?subject=subscribe>
List-unsubscribe: <http://lists.xensource.com/cgi-bin/mailman/listinfo/xen-devel>, <mailto:xen-devel-request@lists.xensource.com?subject=unsubscribe>
Organization: IBM
References: <E1Ek3aI-0001xu-00@xxxxxxxxxxxxxxxxx>
Sender: xen-devel-bounces@xxxxxxxxxxxxxxxxxxx
User-agent: Gnus/5.1006 (Gnus v5.10.6) Emacs/21.4 (gnu/linux)
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

>>>>> "SH" == Steven Hand <Steven.Hand@xxxxxxxxxxxx> writes:

    >> >>>>> "SH" == Steven Hand <Steven.Hand@xxxxxxxxxxxx> writes:
    >> 
    >> >> Checking the changelog today for xen-unstable.hg, I find that
    >> >> some of the work that IBM has contributed to the Users' Manual
    >> >> and Interface Manual has been discarded.

    SH> Which work are you referring to?

    >>  :)
    >> 
    >> For example, the Users' Manual is now one 74K file. There was
    >> agreement between us and Xen to break it into smaller chunks, and
    >> we spent the time to do that.

    SH> Yes, I moved it (and the interface manual) back into one file to
    SH> more easily enable spell checking etc. It doesn't seem that
    SH> there's much benefit in having lots of small files - hg is fine
    SH> with merges and patches to parts of text files.

    SH> Are you keen to re-break it apart? I could understand if there
    SH> were lots of discrete edits taking place in various and an
    SH> inability to use merge but surely this is not the case?

I am able to work with the documentation in whatever format the
community desires. Personally, I don't mind if that is one large file,
or several smaller ones. Let's do stick with one or the other, though.

    >> >> Would someone from Xen please be kind enough to explain why
    >> this >> happened?

    SH> Prior to the release we tidied up the documentation to make it
    SH> at least consistent/correct (as far as possible). It may be that
    SH> this involved removing some of your text - but cannot say as I'm
    SH> not aware what your text was (see above).

    >>  It is not "my text". It is work done by IBM that was accepted
    >> into the tree.

    SH> Understood.

    >> The changes I'm referring to appear to have happened after the
    >> release. My guess is that is a consequence of your internal tree
    >> being pushed out to the open source tree.

    SH> Yes, sorry - I checked it into our internal staging tree which
    SH> then took a little while to be pushed publically (since we run
    SH> regression tests before a push to ensure the tree is not badly
    SH> broken).

    >> [8305: Xen patchbot -unstable ] [Xen-changelog] Updated docs for
    >> Xen 3.0.  From: Xen patchbot -unstable
    >> <patchbot-unstable@xxxxxxxxxxxxxxxxxxx> Subject: [Xen-changelog]
    >> Updated docs for Xen 3.0.  To: xen-changelog@xxxxxxxxxxxxxxxxxxx
    >> Date: Tue, 06 Dec 2005 17:52:14 +0000 Reply-To:
    >> xen-devel@xxxxxxxxxxxxxxxxxxx
    >> 
    >> # HG changeset patch # User smh22@xxxxxxxxxxxxxxxxxxxx # Node ID
    >> c8fdb0caa77b429cf47f9707926e83947778cb48 # Parent
    >> 0255f48b757fc4a69846356e8f42e9a4ed410c8c Updated docs for Xen
    >> 3.0.
    >> 
    >> Signed-off-by: Steven Hand <steven@xxxxxxxxxxxxx> <snip>

    >> >> What is the status of the patch that I submitted on Monday?

    SH> The patch you submitted on Monday was against an older version
    SH> of the tree and has not yet been applied.

    >>  It wasn't an older version when it was submitted.

    SH> True - my bad.

    SH> I've merged and applied it to the staging tree - should be
    SH> pushed out soon.

That is good news. Thanks very much.

    SH> cheers,

    SH> S.

Regards,
Robb


- -- 
Robb Romans                     (512) 838-0419
Linux Commando                  T/L   678-0419
ARS NA5TT
.-- - ..-. ..--..
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.8 <http://mailcrypt.sourceforge.net/>

iD8DBQFDly8ddoW/RCLrCx0RAp3jAKC4Bm3rYnpDeJPzX0AxrwV5Lrh3pQCeMiDl
w/8XF/w7QUJY2zsiMU4K3w8=
=6Faw
-----END PGP SIGNATURE-----

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel

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