Partial merge of man page cleanups from NetBSD:
revision 1.91 Fri Nov 7 01:01:46 2003 UTC by lukem Add some subsections in the VARIABLE ASSIGNMENTS section. In the "modifier description" list, show each modifier with the leading `:'. Rationale: it's hard to search for modifiers without it, and we already do the same thing in the -options and .makecommands lists. I now find it much easier to find the description for a modifier in the man page. Obtained from: NetBSD
This commit is contained in:
parent
0e7685cf23
commit
e086cdc47b
@ -852,7 +852,7 @@ These directories will be searched for source files by
|
||||
.Nm
|
||||
after it has finished parsing all input makefiles.
|
||||
.El
|
||||
.Pp
|
||||
.Ss Variable modifiers
|
||||
Variable expansion may be modified to select or modify each word of the
|
||||
variable (where a
|
||||
.Dq word
|
||||
@ -867,7 +867,7 @@ The colon may be escaped with a backslash
|
||||
.Pq Ql \e .
|
||||
.Bl -tag -width Cm
|
||||
.Sm off
|
||||
.It Cm C No / Ar pattern Xo
|
||||
.It Cm \&:C No / Ar pattern Xo
|
||||
.No / Ar replacement
|
||||
.No / Op Cm 1g
|
||||
.Xc
|
||||
@ -896,13 +896,13 @@ and
|
||||
are orthogonal; the former specifies whether multiple words are
|
||||
potentially affected, the latter whether multiple substitutions can
|
||||
potentially occur within each affected word.
|
||||
.It Cm E
|
||||
.It Cm \&:E
|
||||
Replaces each word in the variable with its suffix.
|
||||
.It Cm H
|
||||
.It Cm \&:H
|
||||
Replaces each word in the variable with everything but the last component.
|
||||
.It Cm L
|
||||
.It Cm \&:L
|
||||
Converts variable to lower-case letters.
|
||||
.It Cm M Ns Ar pattern
|
||||
.It Cm \&:M Ns Ar pattern
|
||||
Select only those words that match the rest of the modifier.
|
||||
The standard shell wildcard characters
|
||||
.Pf ( Ql * ,
|
||||
@ -913,21 +913,21 @@ may
|
||||
be used.
|
||||
The wildcard characters may be escaped with a backslash
|
||||
.Pq Ql \e .
|
||||
.It Cm N Ns Ar pattern
|
||||
.It Cm \&:N Ns Ar pattern
|
||||
This is identical to
|
||||
.Cm M ,
|
||||
.Cm \&:M ,
|
||||
but selects all words which do not match
|
||||
the rest of the modifier.
|
||||
.It Cm O
|
||||
.It Cm \&:O
|
||||
Order every word in the variable alphabetically.
|
||||
.It Cm Q
|
||||
.It Cm \&:Q
|
||||
Quotes every shell meta-character in the variable, so that it can be passed
|
||||
safely through recursive invocations of
|
||||
.Nm .
|
||||
.It Cm R
|
||||
.It Cm \&:R
|
||||
Replaces each word in the variable with everything but its suffix.
|
||||
.Sm off
|
||||
.It Cm S No / Ar old_string Xo
|
||||
.It Cm \&:S No / Ar old_string Xo
|
||||
.No / Ar new_string
|
||||
.No / Op Cm g
|
||||
.Xc
|
||||
@ -971,7 +971,7 @@ with the single exception that a backslash is used to prevent the expansion
|
||||
of a dollar sign
|
||||
.Pq Ql $ ,
|
||||
not a preceding dollar sign as is usual.
|
||||
.It Ar old_string=new_string
|
||||
.It Ar :old_string=new_string
|
||||
This is the
|
||||
.At V
|
||||
style variable substitution.
|
||||
@ -991,11 +991,11 @@ is the substring of
|
||||
.Ar old_string
|
||||
to be replaced in
|
||||
.Ar new_string
|
||||
.It Cm T
|
||||
.It Cm \&:T
|
||||
Replaces each word in the variable with its last component.
|
||||
.It Cm U
|
||||
.It Cm \&:U
|
||||
Converts variable to upper-case letters.
|
||||
.It Cm u
|
||||
.It Cm \&:u
|
||||
Remove adjacent duplicate words (like
|
||||
.Xr uniq 1 ) .
|
||||
.El
|
||||
|
Loading…
Reference in New Issue
Block a user