From e37e7dd6a6f5ae170dd93f2b7843e6dfb7b2fb89 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=BD=D0=B0=D0=B1?= Date: Thu, 24 Mar 2022 20:14:25 +0100 Subject: [PATCH] =?UTF-8?q?man:=20...=20->=20=E2=80=A6=20again?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit zfs-program.8 is left, but that's literal Lua syntax Reviewed-by: Brian Behlendorf Signed-off-by: Ahelenia Ziemiańska Closes #13255 --- man/man7/zfsprops.7 | 15 +++++++++------ man/man8/zed.8.in | 2 +- man/man8/zfs-allow.8 | 24 ++++++++++++------------ man/man8/zfs-program.8 | 9 +++++---- man/man8/zfs-send.8 | 6 +++--- 5 files changed, 30 insertions(+), 26 deletions(-) diff --git a/man/man7/zfsprops.7 b/man/man7/zfsprops.7 index 0976e80d73..7e9f8ede77 100644 --- a/man/man7/zfsprops.7 +++ b/man/man7/zfsprops.7 @@ -388,7 +388,7 @@ privilege with can access everyone's usage. .Pp The -.Sy userused Ns @ Ns Ar ... +.Sy userused Ns @ Ns Ar … properties are not displayed by .Nm zfs Cm get Sy all . The user's name must be appended after the @@ -872,14 +872,17 @@ This is done using .Sy zstd-fast- Ns Ar N , where .Ar N -is an integer in [1-9,10,20,30,...,100,500,1000] which maps to a negative +is an integer in +.Bq Sy 1 Ns - Ns Sy 10 , 20 , 30 , No … , Sy 100 , 500 , 1000 +which maps to a negative .Sy zstd level. -The lower the level the faster the compression - -.Ar 1000 No provides the fastest compression and lowest compression ratio. +The lower the level the faster the compression \(em +.Sy 1000 +provides the fastest compression and lowest compression ratio. .Sy zstd-fast is equivalent to -.Sy zstd-fast-1 . +.Sy zstd-fast- Ns Ar 1 . .Pp The .Sy zle @@ -1315,7 +1318,7 @@ can get and set everyone's quota. This property is not available on volumes, on file systems before version 4, or on pools before version 15. The -.Sy userquota@ Ns Ar ... +.Sy userquota@ Ns Ar … properties are not displayed by .Nm zfs Cm get Sy all . The user's name must be appended after the diff --git a/man/man8/zed.8.in b/man/man8/zed.8.in index d329760520..6c51f10695 100644 --- a/man/man8/zed.8.in +++ b/man/man8/zed.8.in @@ -75,7 +75,7 @@ Custom .Ev $PATH for zedlets to use. Normally zedlets run in a locked-down environment, with hardcoded paths to the ZFS commands -.Pq Ev $ZFS , $ZPOOL , $ZED , ... , +.Pq Ev $ZFS , $ZPOOL , $ZED , … , and a hard-coded .Ev $PATH . This is done for security reasons. diff --git a/man/man8/zfs-allow.8 b/man/man8/zfs-allow.8 index f949a0a5ee..52b7c43f44 100644 --- a/man/man8/zfs-allow.8 +++ b/man/man8/zfs-allow.8 @@ -215,19 +215,19 @@ send subcommand share subcommand Allows sharing file systems over NFS or SMB protocols snapshot subcommand Must also have the \fBmount\fR ability -groupquota other Allows accessing any \fBgroupquota@\fI...\fR property -groupobjquota other Allows accessing any \fBgroupobjquota@\fI...\fR property -groupused other Allows reading any \fBgroupused@\fI...\fR property -groupobjused other Allows reading any \fBgroupobjused@\fI...\fR property +groupquota other Allows accessing any \fBgroupquota@\fI…\fR property +groupobjquota other Allows accessing any \fBgroupobjquota@\fI…\fR property +groupused other Allows reading any \fBgroupused@\fI…\fR property +groupobjused other Allows reading any \fBgroupobjused@\fI…\fR property userprop other Allows changing any user property -userquota other Allows accessing any \fBuserquota@\fI...\fR property -userobjquota other Allows accessing any \fBuserobjquota@\fI...\fR property -userused other Allows reading any \fBuserused@\fI...\fR property -userobjused other Allows reading any \fBuserobjused@\fI...\fR property -projectobjquota other Allows accessing any \fBprojectobjquota@\fI...\fR property -projectquota other Allows accessing any \fBprojectquota@\fI...\fR property -projectobjused other Allows reading any \fBprojectobjused@\fI...\fR property -projectused other Allows reading any \fBprojectused@\fI...\fR property +userquota other Allows accessing any \fBuserquota@\fI…\fR property +userobjquota other Allows accessing any \fBuserobjquota@\fI…\fR property +userused other Allows reading any \fBuserused@\fI…\fR property +userobjused other Allows reading any \fBuserobjused@\fI…\fR property +projectobjquota other Allows accessing any \fBprojectobjquota@\fI…\fR property +projectquota other Allows accessing any \fBprojectquota@\fI…\fR property +projectobjused other Allows reading any \fBprojectobjused@\fI…\fR property +projectused other Allows reading any \fBprojectused@\fI…\fR property aclinherit property aclmode property diff --git a/man/man8/zfs-program.8 b/man/man8/zfs-program.8 index 4a9718cdcf..100cba03ee 100644 --- a/man/man8/zfs-program.8 +++ b/man/man8/zfs-program.8 @@ -96,16 +96,17 @@ argv = args["argv"] -- argv == {1="arg1", 2="arg2", ...} .Ed .Pp -If invoked from the libZFS interface, an arbitrary argument list can be +If invoked from the libzfs interface, an arbitrary argument list can be passed to the channel program, which is accessible via the same -"..." syntax in Lua: +.Qq Li ... +syntax in Lua: .Bd -literal -compact -offset indent args = ... -- args == {"foo"="bar", "baz"={...}, ...} .Ed .Pp Note that because Lua arrays are 1-indexed, arrays passed to Lua from the -libZFS interface will have their indices incremented by 1. +libzfs interface will have their indices incremented by 1. That is, the element in .Va arr[0] @@ -166,7 +167,7 @@ See the section below for function-specific details on error return codes. . .Ss Lua to C Value Conversion -When invoking a channel program via the libZFS interface, it is necessary to +When invoking a channel program via the libzfs interface, it is necessary to translate arguments and return values from Lua values to their C equivalents, and vice-versa. .Pp diff --git a/man/man8/zfs-send.8 b/man/man8/zfs-send.8 index 67e94ca85b..17e7294e95 100644 --- a/man/man8/zfs-send.8 +++ b/man/man8/zfs-send.8 @@ -40,7 +40,7 @@ .Nm zfs .Cm send .Op Fl DLPRbcehnpsvw -.Op Fl X Ar dataset Ns Oo , Ns Ar dataset Oc Ns ... +.Op Fl X Ar dataset Ns Oo , Ns Ar dataset Oc Ns … .Op Oo Fl I Ns | Ns Fl i Oc Ar snapshot .Ar snapshot .Nm zfs @@ -74,7 +74,7 @@ .Nm zfs .Cm send .Op Fl DLPRbcehnpvw -.Op Fl X Ar dataset Ns Oo , Ns Ar dataset Oc Ns ... +.Op Fl X Ar dataset Ns Oo , Ns Ar dataset Oc Ns … .Op Oo Fl I Ns | Ns Fl i Oc Ar snapshot .Ar snapshot .Xc @@ -142,7 +142,7 @@ If the flag is used to send encrypted datasets, then .Fl w must also be specified. -.It Fl X , -exclude Ar dataset Ns Oo , Ns Ar dataset Oc Ns ... +.It Fl X , -exclude Ar dataset Ns Oo , Ns Ar dataset Oc Ns … When the .Fl R flag is given,