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

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

To: "'Dylan Martin'" <dmartin@xxxxxxxxxxxx>, "'Artur Linhart - Linux communication'" <AL.LINUX@xxxxxxxxxxx>
Subject: [Xen-devel] RE: [Xen-users] Push for Better Documentation
From: "Artur Linhart - Linux communication" <AL.LINUX@xxxxxxxxxxx>
Date: Thu, 19 Jul 2007 13:23:59 +0200
Cc: xen-devel@xxxxxxxxxxxxxxxxxxx, xen-users@xxxxxxxxxxxxxxxxxxx, 'Lev Lafayette' <lev@xxxxxxxxxx>, 'Christian Horn' <chorn@xxxxxxxxxxxx>, 'Tom Horsley' <tom.horsley@xxxxxxx>
Delivery-date: Thu, 19 Jul 2007 04:21:59 -0700
Envelope-to: www-data@xxxxxxxxxxxxxxxxxx
In-reply-to: <20070718202540.GK30252@xxxxxxxxxxxx>
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>
References: <20070710011615.GA25845@xxxxxxxxxxxx> <03ce01c7c2ff$15d4b8e0$6d58a8c0@xxxxxxxxxxxxxxxxxxxxxxxxx> <20070711003248.GA2640@xxxxxxxxxxxx> <04d601c7c3a4$d2d4e910$6d58a8c0@xxxxxxxxxxxxxxxxxxxxxxxxx> <20070718202540.GK30252@xxxxxxxxxxxx>
Sender: xen-devel-bounces@xxxxxxxxxxxxxxxxxxx
Thread-index: AcfJeXS7jNRZ7OxtT4eDnUUoO1p1sQAfUdig
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...

        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

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