OpenSolaris

Discussions Communities Projects Download Source Browser

Home » OpenSolaris Forums » zfs » discuss

Thread: [zfs-discuss] Location of ZFS documentation (source)?

Welcome, Guest Help
Login Login
Guest Settings Guest Settings
Reply to this Thread Reply to this Thread Search Forum Search Forum Back to Thread List Back to Thread List

Permlink Replies: 4 - Last Post: Nov 4, 2009 6:21 PM by: alblue Threads: [ Previous | Next ]
alblue

Posts: 9
From: GB

Registered: 10/24/09
[zfs-discuss] Location of ZFS documentation (source)?
Posted: Nov 2, 2009 3:07 PM

  Click to reply to this thread Reply

The man pages documentation from the old Apple port
(http://github.com/alblue/mac-zfs/tree/master/zfs_documentation/man8/)
don't seem to have a corresponding source file in the onnv-gate
repository (http://hub.opensolaris.org/bin/view/Project+onnv/WebHome)
although I've found the text on-line
(http://docs.sun.com/app/docs/doc/819-2240/zfs-1m)

Can anyone point me to where these are stored, so that we can update
the documentation in the Apple fork?

Alex
_______________________________________________
zfs-discuss mailing list
zfs-discuss at opensolaris dot org
http://mail.opensolaris.org/mailman/listinfo/zfs-discuss


cindys

Posts: 405
From: US

Registered: 11/2/05
Re: [zfs-discuss] Location of ZFS documentation (source)?
Posted: Nov 2, 2009 3:39 PM   in response to: alblue

  Click to reply to this thread Reply

Hi Alex,

I'm checking with some folks on how we handled this handoff
for the previous project.

I'll get back to you shortly.

Thanks,

Cindy

On 11/02/09 16:07, Alex Blewitt wrote:
> The man pages documentation from the old Apple port
> (http://github.com/alblue/mac-zfs/tree/master/zfs_documentation/man8/)
> don't seem to have a corresponding source file in the onnv-gate
> repository (http://hub.opensolaris.org/bin/view/Project+onnv/WebHome)
> although I've found the text on-line
> (http://docs.sun.com/app/docs/doc/819-2240/zfs-1m)
>
> Can anyone point me to where these are stored, so that we can update
> the documentation in the Apple fork?
>
> Alex
> _______________________________________________
> zfs-discuss mailing list
> zfs-discuss at opensolaris dot org
> http://mail.opensolaris.org/mailman/listinfo/zfs-discuss
_______________________________________________
zfs-discuss mailing list
zfs-discuss at opensolaris dot org
http://mail.opensolaris.org/mailman/listinfo/zfs-discuss


cindys

Posts: 405
From: US

Registered: 11/2/05
Re: [zfs-discuss] Location of ZFS documentation (source)?
Posted: Nov 3, 2009 6:48 AM   in response to: cindys

  Click to reply to this thread Reply

Alex,

You can download the man page source files from this URL:

http://dlc.sun.com/osol/man/downloads/current/

If you want a different version, you can navigate to the available
source consolidations from the Downloads page on opensolaris.org.

Thanks,

Cindy

On 11/02/09 16:39, Cindy Swearingen wrote:
> Hi Alex,
>
> I'm checking with some folks on how we handled this handoff
> for the previous project.
>
> I'll get back to you shortly.
>
> Thanks,
>
> Cindy
>
> On 11/02/09 16:07, Alex Blewitt wrote:
>> The man pages documentation from the old Apple port
>> (http://github.com/alblue/mac-zfs/tree/master/zfs_documentation/man8/)
>> don't seem to have a corresponding source file in the onnv-gate
>> repository (http://hub.opensolaris.org/bin/view/Project+onnv/WebHome)
>> although I've found the text on-line
>> (http://docs.sun.com/app/docs/doc/819-2240/zfs-1m)
>>
>> Can anyone point me to where these are stored, so that we can update
>> the documentation in the Apple fork?
>>
>> Alex
>> _______________________________________________
>> zfs-discuss mailing list
>> zfs-discuss at opensolaris dot org
>> http://mail.opensolaris.org/mailman/listinfo/zfs-discuss
> _______________________________________________
> zfs-discuss mailing list
> zfs-discuss at opensolaris dot org
> http://mail.opensolaris.org/mailman/listinfo/zfs-discuss
_______________________________________________
zfs-discuss mailing list
zfs-discuss at opensolaris dot org
http://mail.opensolaris.org/mailman/listinfo/zfs-discuss


alblue

Posts: 9
From: GB

Registered: 10/24/09
Re: [zfs-discuss] Location of ZFS documentation (source)?
Posted: Nov 4, 2009 12:59 AM   in response to: cindys

  Click to reply to this thread Reply

On Tue, Nov 3, 2009 at 2:48 PM, Cindy Swearingen
<Cindy dot Swearingen at sun dot com> wrote:
> Alex,
>
> You can download the man page source files from this URL:
>
> http://dlc.sun.com/osol/man/downloads/current/

Thanks, that's great.
_______________________________________________
zfs-discuss mailing list
zfs-discuss at opensolaris dot org
http://mail.opensolaris.org/mailman/listinfo/zfs-discuss


alblue

Posts: 9
From: GB

Registered: 10/24/09
Re: [zfs-discuss] Location of ZFS documentation (source)?
Posted: Nov 4, 2009 6:21 PM   in response to: cindys

  Click to reply to this thread Reply

On 3 Nov 2009, at 14:48, Cindy Swearingen wrote:

> Alex,
>
> You can download the man page source files from this URL:
>
> http://dlc.sun.com/osol/man/downloads/current/

FYI there's a couple of nits in the man pages:

* the zpool create synopsis hits the 80 char mark. Might be better to
fit on several lines e.g.

zpool create [-fn] [-o property=value] ...
[-O file-system-property=value] ...
[-m mountpoint] [-R root] pool vdev ...

* same for the zpool import
* There's a few bold open square brackets when there probably
shouldn't be;
zfs.1m:\fB[\fB-ug\fR] "\fIeveryone\fR"|\fIuser\fR|\fIgroup\fR[,...]\fR
zfs.1m:\fB[\fB-e\fR] \fIperm\fR|@\fIsetname\fR[,...]\fR
zfs.1m:\fB[\fB-ld\fR] \fIfilesystem\fR|\fIvolume\fR\fR
zpool.1m:\fB[\fB-O\fR \fIfile-system-property=value\fR] ...\fR
->
zfs.1m:[\fB-ug\fR] "\fIeveryone\fR"|\fIuser\fR|\fIgroup\fR[,...]\fR
zfs.1m:[\fB-e\fR] \fIperm\fR|@\fIsetname\fR[,...]\fR
zfs.1m:[\fB-ld\fR] \fIfilesystem\fR|\fIvolume\fR\fR
zpool.1m:[\fB-O\fR \fIfile-system-property=value\fR] ...\fR

* zpool upgrade looks like it's an older message,
zpool.1m:This system is currently running ZFS version 2.
->
# zpool upgrade -a
This system is currently running ZFS pool version 8.

All pools are formatted using this version.

This is confusing, especially since ZFS filesystem version 2 is the
default:
# zfs upgrade
This system is currently running ZFS filesystem version 2.

Alex
_______________________________________________
zfs-discuss mailing list
zfs-discuss at opensolaris dot org
http://mail.opensolaris.org/mailman/listinfo/zfs-discuss





Terms of Use | Privacy | Trademarks | Copyright Policy | Site Guidelines
Your use of this web site or any of its content or software indicates your agreement to be bound by these Terms of Use.
Copyright © 1995-2005 Sun Microsystems, Inc.