Use more macros, and use them more consistently.
Fix a few typos.
This commit is contained in:
parent
1b3dbc9530
commit
ee1fddfe1e
@ -1,4 +1,4 @@
|
|||||||
.\" $NetBSD: ftp.1,v 1.110 2005/07/05 09:29:54 lukem Exp $
|
.\" $NetBSD: ftp.1,v 1.111 2005/07/06 11:18:05 wiz Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright (c) 1996-2005 The NetBSD Foundation, Inc.
|
.\" Copyright (c) 1996-2005 The NetBSD Foundation, Inc.
|
||||||
.\" All rights reserved.
|
.\" All rights reserved.
|
||||||
@ -613,8 +613,9 @@ transferring a
|
|||||||
.Xr tar 1
|
.Xr tar 1
|
||||||
archive of the subtree (in binary mode).
|
archive of the subtree (in binary mode).
|
||||||
.It Ic hash Op Ar size
|
.It Ic hash Op Ar size
|
||||||
Toggle hash-sign (``#'') printing for each data block
|
Toggle hash-sign
|
||||||
transferred.
|
.Pq Sq #
|
||||||
|
printing for each data block transferred.
|
||||||
The size of a data block defaults to 1024 bytes.
|
The size of a data block defaults to 1024 bytes.
|
||||||
This can be changed by specifying
|
This can be changed by specifying
|
||||||
.Ar size
|
.Ar size
|
||||||
@ -676,16 +677,33 @@ invoked with the next
|
|||||||
command), and remain defined until a
|
command), and remain defined until a
|
||||||
.Ic close
|
.Ic close
|
||||||
command is executed.
|
command is executed.
|
||||||
The macro processor interprets `$' and `\e' as special characters.
|
The macro processor interprets
|
||||||
A `$' followed by a number (or numbers) is replaced by the
|
.Sq $
|
||||||
|
and
|
||||||
|
.Sq \e
|
||||||
|
as special characters.
|
||||||
|
A
|
||||||
|
.Sq $
|
||||||
|
followed by a number (or numbers) is replaced by the
|
||||||
corresponding argument on the macro invocation command line.
|
corresponding argument on the macro invocation command line.
|
||||||
A `$' followed by an `i' signals that macro processor that the
|
A
|
||||||
executing macro is to be looped.
|
.Sq $
|
||||||
On the first pass `$i' is
|
followed by an
|
||||||
replaced by the first argument on the macro invocation command line,
|
.Sq i
|
||||||
on the second pass it is replaced by the second argument, and so on.
|
signals the macro processor that the executing macro is to be
|
||||||
A `\e' followed by any character is replaced by that character.
|
looped.
|
||||||
Use the `\e' to prevent special treatment of the `$'.
|
On the first pass
|
||||||
|
.Dq $i
|
||||||
|
is replaced by the first argument on the macro invocation command
|
||||||
|
line, on the second pass it is replaced by the second argument,
|
||||||
|
and so on.
|
||||||
|
A
|
||||||
|
.Sq \e
|
||||||
|
followed by any character is replaced by that character.
|
||||||
|
Use the
|
||||||
|
.Sq \e
|
||||||
|
to prevent special treatment of the
|
||||||
|
.Sq $ .
|
||||||
.It Ic mdelete Op Ar remote-files
|
.It Ic mdelete Op Ar remote-files
|
||||||
Delete the
|
Delete the
|
||||||
.Ar remote-files
|
.Ar remote-files
|
||||||
@ -828,9 +846,18 @@ and
|
|||||||
.Ic case
|
.Ic case
|
||||||
settings).
|
settings).
|
||||||
Variable templating is accomplished by including the
|
Variable templating is accomplished by including the
|
||||||
sequences `$1', `$2', ..., `$9' in
|
sequences
|
||||||
|
.Dq $1 ,
|
||||||
|
.Dq $2 ,
|
||||||
|
\&...
|
||||||
|
.Dq $9
|
||||||
|
in
|
||||||
.Ar inpattern .
|
.Ar inpattern .
|
||||||
Use `\\' to prevent this special treatment of the `$' character.
|
Use
|
||||||
|
.Sq \e
|
||||||
|
to prevent this special treatment of the
|
||||||
|
.Sq $
|
||||||
|
character.
|
||||||
All other characters are treated literally, and are used to determine the
|
All other characters are treated literally, and are used to determine the
|
||||||
.Ic nmap
|
.Ic nmap
|
||||||
.Op Ar inpattern
|
.Op Ar inpattern
|
||||||
@ -842,13 +869,19 @@ $1.$2 and the remote file name "mydata.data", $1 would have the value
|
|||||||
The
|
The
|
||||||
.Ar outpattern
|
.Ar outpattern
|
||||||
determines the resulting mapped filename.
|
determines the resulting mapped filename.
|
||||||
The sequences `$1', `$2', ...., `$9' are replaced by any value resulting
|
The sequences
|
||||||
from the
|
.Dq $1 ,
|
||||||
|
.Dq $2 ,
|
||||||
|
\&...
|
||||||
|
.Dq $9
|
||||||
|
are replaced by any value resulting from the
|
||||||
.Ar inpattern
|
.Ar inpattern
|
||||||
template.
|
template.
|
||||||
The sequence `$0' is replace by the original filename.
|
The sequence
|
||||||
|
.Dq $0
|
||||||
|
is replaced by the original filename.
|
||||||
Additionally, the sequence
|
Additionally, the sequence
|
||||||
.Ql Op Ar seq1 , Ar seq2
|
.Dq Op Ar seq1 , Ar seq2
|
||||||
is replaced by
|
is replaced by
|
||||||
.Op Ar seq1
|
.Op Ar seq1
|
||||||
if
|
if
|
||||||
@ -867,9 +900,18 @@ the output filename "myfile.data" for input filenames "myfile.data" and
|
|||||||
"myfile.myfile" for the input filename ".myfile".
|
"myfile.myfile" for the input filename ".myfile".
|
||||||
Spaces may be included in
|
Spaces may be included in
|
||||||
.Ar outpattern ,
|
.Ar outpattern ,
|
||||||
as in the example: `nmap $1 sed "s/ *$//" \*[Gt] $1' .
|
as in the example:
|
||||||
Use the `\e' character to prevent special treatment
|
.Dl nmap $1 sed "s/ *$//" \*[Gt] $1
|
||||||
of the `$','[',']', and `,' characters.
|
Use the
|
||||||
|
.Sq \e
|
||||||
|
character to prevent special treatment
|
||||||
|
of the
|
||||||
|
.Sq $ ,
|
||||||
|
.Sq \&[ ,
|
||||||
|
.Sq \&] ,
|
||||||
|
and
|
||||||
|
.Sq \&,
|
||||||
|
characters.
|
||||||
.It Ic ntrans Op Ar inchars Op Ar outchars
|
.It Ic ntrans Op Ar inchars Op Ar outchars
|
||||||
Set or unset the filename character translation mechanism.
|
Set or unset the filename character translation mechanism.
|
||||||
If no arguments are specified, the filename character
|
If no arguments are specified, the filename character
|
||||||
@ -1444,7 +1486,9 @@ A synonym for
|
|||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
Command arguments which have embedded spaces may be quoted with
|
Command arguments which have embedded spaces may be quoted with
|
||||||
quote `"' marks.
|
quote
|
||||||
|
.Sq \&"
|
||||||
|
marks.
|
||||||
.Pp
|
.Pp
|
||||||
Commands which toggle settings can take an explicit
|
Commands which toggle settings can take an explicit
|
||||||
.Ic on
|
.Ic on
|
||||||
@ -1873,9 +1917,10 @@ A particularly
|
|||||||
useful example of this mechanism is:
|
useful example of this mechanism is:
|
||||||
.Dq Li dir \&"\&" \&|more .
|
.Dq Li dir \&"\&" \&|more .
|
||||||
.It
|
.It
|
||||||
Failing the above checks, if ``globbing'' is enabled,
|
Failing the above checks, if
|
||||||
local file names are expanded
|
.Dq globbing
|
||||||
according to the rules used in the
|
is enabled, local file names are expanded according to the rules
|
||||||
|
used in the
|
||||||
.Xr csh 1 ;
|
.Xr csh 1 ;
|
||||||
c.f. the
|
c.f. the
|
||||||
.Ic glob
|
.Ic glob
|
||||||
|
Loading…
Reference in New Issue
Block a user