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

Re: [Xen-devel] RE: [Xen-users] Push for Better Documentation

To: "Artur Linhart - Linux communication" <AL.LINUX@xxxxxxxxxxx>, "'Dylan Martin'" <dmartin@xxxxxxxxxxxx>
Subject: Re: [Xen-devel] RE: [Xen-users] Push for Better Documentation
From: Mats Petersson <mats@xxxxxxxxxxxxxxxxx>
Date: Thu, 19 Jul 2007 12:43:36 +0100
Cc: 'Tom Horsley' <tom.horsley@xxxxxxx>, xen-devel@xxxxxxxxxxxxxxxxxxx, xen-users@xxxxxxxxxxxxxxxxxxx, 'Lev Lafayette' <lev@xxxxxxxxxx>, 'Christian Horn' <chorn@xxxxxxxxxxxx>
Delivery-date: Tue, 24 Jul 2007 08:48:22 -0700
Dkim-signature: a=rsa-sha1; c=relaxed/relaxed; d=googlemail.com; s=beta; h=domainkey-signature:received:received:x-mailer:date:to:from:subject:cc:in-reply-to:references:mime-version:content-type:sender:message-id; b=lu8s2hzJW46JbAkQ/fhNeQE2OY6Rd00r0f6mwGvTOMeNZO3fXaNO1lDoNn/3XqEjdu334Q2WWpI5ljcj2VLDK2xLs/8dxPevbB4bNuqq0gkFogTppfcmoUq4aDTZh+Rd2HJqSPBu5Bkt8pfdMmdRryf46tGPrp8SURCH74+8XnQ=
Domainkey-signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=beta; h=received:x-mailer:date:to:from:subject:cc:in-reply-to:references:mime-version:content-type:sender:message-id; b=hAPCBJtM3hzTl3M7FJUuH+h44IY32NRquBA8CZ5DJ2O9SO3880u1kkgzk9mH97pA1ZktTGO0NHYia294VrR05Rhso0NHE5g1ArdEX3pXGic6GwjZ0Dx9K/u9OM7ulWXvfvPgoHvh7sUbhNiFyvAzJZLyZ4mKvR+7Z6a/5z9uBUI=
Envelope-to: www-data@xxxxxxxxxxxxxxxxxx
In-reply-to: <06ed01c7c9f7$4f08cb70$4e1db00a@xxxxxxxxxxxxxxxxxxxxxxxxx>
List-help: <mailto:xen-users-request@lists.xensource.com?subject=help>
List-id: Xen user discussion <xen-users.lists.xensource.com>
List-post: <mailto:xen-users@lists.xensource.com>
List-subscribe: <http://lists.xensource.com/cgi-bin/mailman/listinfo/xen-users>, <mailto:xen-users-request@lists.xensource.com?subject=subscribe>
List-unsubscribe: <http://lists.xensource.com/cgi-bin/mailman/listinfo/xen-users>, <mailto:xen-users-request@lists.xensource.com?subject=unsubscribe>
References: <20070710011615.GA25845@xxxxxxxxxxxx> <03ce01c7c2ff$15d4b8e0$6d58a8c0@xxxxxxxxxxxxxxxxxxxxxxxxx> <20070711003248.GA2640@xxxxxxxxxxxx> <04d601c7c3a4$d2d4e910$6d58a8c0@xxxxxxxxxxxxxxxxxxxxxxxxx> <20070718202540.GK30252@xxxxxxxxxxxx> <06ed01c7c9f7$4f08cb70$4e1db00a@xxxxxxxxxxxxxxxxxxxxxxxxx>
Sender: xen-users-bounces@xxxxxxxxxxxxxxxxxxx
At 12:23 19/07/2007, Artur Linhart - Linux communication wrote:
OK, thank Zou for information. Do You know something about who is
responsible for the documentation creation etc, or where the developen
"pod"-s are stored and managed (some version control system, etc? I would be
good to work on documentation of something, what is not yet in processing by
somebody - or work on the themes together...


The docs are part of the Xen "source code", so if you grab the Xen source tarball, or install "mercurial" (hg)[1] and do "hg clone http://xenbits.xensource.com/xen-unstable";.

Using mercurial is the best way, since that means that you can:
1) Generate patches from your changes without keeping a second copy of everything you may want to change [2]. 2) Update your current source-directory to the latest unstable sources with "hg pull && hg update" 3) Roll back your changes if you decide that you haven't "done the right changes" [e.g. when you do "too many fingers on keyboard" in the editor and end up with half the file missing and no backup file]. You can even keep your own local set of changes and thus have a history of what you've done, and then export all changes as one patch-set.

[1] Here's the first place google found for downloading mercurial: http://linux.softpedia.com/get/Programming/Version-Control/Mercurial-9329.shtml

[2] Of course there is a second copy, but it's automatically maintained by mercurial rather than by manually. The drawback here is that since mercurial keeps ALL the changes, the "second copy" is quite a bit larger than the whole Xen source-tree - but it is compressed, so not that bad, and in a place where disk-space is counted in tens or hundreds of gigabytes, it's not a real problem.

--
Mats


        With regards

                archie

-----Original Message-----
From: Dylan Martin [mailto:dmartin@xxxxxxxxxxxx]
Sent: Wednesday, July 18, 2007 10:26 PM
To: Artur Linhart - Linux communication
Cc: 'Lev Lafayette'; 'Tom Horsley'; 'Christian Horn';
xen-users@xxxxxxxxxxxxxxxxxxx
Subject: Re: [Xen-users] Push for Better Documentation

> I would help with it, but I never wrote some manual pages and have zero
> know-how about it... Right now I do not know if there are some tools for
> writing of man pages.

Okay, I said I'd get back to you about this, but I didn't think I'd
take this long... ;)

The source for the xen man pages is in pod format.  That's Plain Old
Documentation.  It's a really simple format used for perl.  If you're
on a unixy box, you can type 'man perlpod' to read all about it.
There are different commands to convert pod code to
man,html,text,latex etc... pod2man, pod2html etc..

If you look in the  docs dir in the source tarball, you'll see
dirs called man, man1, and man5.  The 'man' dir contains the pod
files.  Edit those and then run 'make' from inside the 'docs' dir.
The new man files will show up in man1 and man5.  To view man files
that aren't in the system man dirs, you can run "nroff -man filename |
less"

Have fun!

-Dylan

> Where did You get even the old manual pages? In the binary tarball there
is
> the directory /usr/share/man with the subdirs man1 and man8, but there are

> Only 3 fragments (for example nothing about xm) and that's it...

It looks like Fedora 7 doesn't even bother to include the crusty old
man files.  Can't blame them for that...


__________ Informace od NOD32 2405 (20070718) __________

Tato zprava byla proverena antivirovym systemem NOD32.
http://www.nod32.cz



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


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

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