zfs utilities man pages

[Emmanuel Anne]

I didn't find an updated version of the man pages to go with zfs-209.06.03. Since it uses pools version 16, the commands gain a few command line switches which should be documented.
Is it ok to take the man pages from opensolaris ?
I downloaded the live cd only to get these man pages ! ;-)

[Mike Hommey]

You can get the manual pages from
http://dlc.sun.com/osol/man/downloads/current/

But they need some modifications to fit zfs-fuse. See
http://groups.google.com/group/zfs-fuse/msg/7275c8b7230b86a6

Mike

[Emmanuel Anne]

Ok, thanks !

2009/7/13 Mike Hommey <mh+...@glandium.org>

[Rudd-O]

Emmannuel,

Can you merge the man pages as per the link you were given and send
them to me so I can push them in my Mercurial repository?

thanks in advance.

On 13 jul, 05:16, Emmanuel Anne <emmanuel.a...@gmail.com> wrote:
> Ok, thanks !
>

> 2009/7/13 Mike Hommey <mh+...@glandium.org <mh%2B...@glandium.org>>

[Emmanuel Anne]

After some checking, the man pages on the given url are from november 2007 (normal, it's supposed to be for the 0.5.x version), the ones from solaris are from march 2009 (better !), and the version of the code I am working on is june 2009 !!! So in fact we have no manual page for this version, but the ones from solaris are still better (a few options added, I found listsnaps for example).

Converting the solaris page to the ones used in linux seems to involve :
 - changing 1M -> 8
 - changing c0d0 -> sda, c1d0 -> sdb and so on until sdf !

gzip the result and you are done.

So I attach the 3 gzipped manual pages from solaris after having replaced everything...

I suppose the ideal solution would be to change the scons file to make it to install the man pages automatically, but puting them somewhere in the repository would be good enough for now...

2009/7/14 Rudd-O <rud...@rudd-o.com>

[Mike Hommey]

On Wed, Jul 15, 2009 at 08:55:13PM +0200, Emmanuel Anne wrote:
> After some checking, the man pages on the given url are from november 2007
> (normal, it's supposed to be for the 0.5.x version), the ones from solaris
> are from march 2009 (better !), and the version of the code I am working on
> is june 2009 !!! So in fact we have no manual page for this version, but the
> ones from solaris are still better (a few options added, I found listsnaps
> for example).
>
> Converting the solaris page to the ones used in linux seems to involve :
> - changing 1M -> 8
> - changing c0d0 -> sda, c1d0 -> sdb and so on until sdf !
>
> gzip the result and you are done.

Check the diff between the manpages I posted and the original
opensolaris ones from november 2007, there are more differences than
that.

Mike

[Emmanuel Anne]

2009/7/15 Mike Hommey <mh+...@glandium.org>

Check the diff between the manpages I posted and the original
opensolaris ones from november 2007, there are more differences than
that.

Sorry I don't have the original solaris man pages from nov 2007 to compare. But if you know the diffs to do, why don't you do them then ? (I didn't want to make the perfect manual page, I just wanted some more recent documentation in any form, for me the unmodified solaris manual pages are very good !).

Yeah november 2007 and not 2008.

Mike

[Mike Hommey]

On Wed, Jul 15, 2009 at 09:56:54PM +0200, Emmanuel Anne wrote:
> 2009/7/15 Mike Hommey <mh+...@glandium.org <mh%2B...@glandium.org>>

>
> > Check the diff between the manpages I posted and the original
> > opensolaris ones from november 2007, there are more differences than
> > that.
>
>
> Sorry I don't have the original solaris man pages from nov 2007 to compare.
> But if you know the diffs to do, why don't you do them then ?

Because I don't have the time.

Here are the diffs in case anyone is interested.

Mike

[Mike Hommey]

Better with the files actually attached.

Mike

[Rudd-O]

Thanks. Now all that's left is someone to integrate the man pages and
these diffs, and I promise, the minute someone comes up with that, I
will put them in my repository so that Ricardo, when he awakes from
his long slumber ;-) , can quickly merge these into his own
repository.

I promise that.

>  zfs.diff
> 20KViewDownload
>
>  zdb.diff
> < 1KViewDownload
>
>  zpool.diff
> 6KViewDownload