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 ! ;-)
On Mon, Jul 13, 2009 at 11:26:01AM +0200, Emmanuel Anne wrote: > 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 ! ;-)
> On Mon, Jul 13, 2009 at 11:26:01AM +0200, Emmanuel Anne wrote:
> > 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 ! ;-)
> 2009/7/13 Mike Hommey <mh+...@glandium.org <mh%2B...@glandium.org>>
> > On Mon, Jul 13, 2009 at 11:26:01AM +0200, Emmanuel Anne wrote:
> > > 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 ! ;-)
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...
> > > On Mon, Jul 13, 2009 at 11:26:01AM +0200, Emmanuel Anne wrote:
> > > > 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 ! ;-)
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.
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 ? (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 !).
On Wed, Jul 15, 2009 at 11:52:23PM +0200, Mike Hommey wrote: > 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.
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.
On Jul 15, 4:53 pm, Mike Hommey <mh+...@glandium.org> wrote:
> On Wed, Jul 15, 2009 at 11:52:23PM +0200, Mike Hommey wrote:
> > 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.
