Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 29 Apr 2001 10:55:09 +0400 (MSD)
From:      Alex Kapranoff <alex@kapran.bitmcnit.bryansk.su>
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   bin/26943: [patch] description of :C modifier is misplaced in make.1
Message-ID:  <200104290655.f3T6t8H00999@kapran.bitmcnit.bryansk.su>

next in thread | raw e-mail | index | archive | help

>Number:         26943
>Category:       bin
>Synopsis:       [patch] description of :C modifier is misplaced in make.1
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Apr 29 00:20:01 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     Alex Kapranoff
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
Inner Mongolia
>Environment:
System: FreeBSD kapran.bitmcnit.bryansk.su 5.0-CURRENT FreeBSD 5.0-CURRENT #3: Wed Apr 25 21:16:35 MSD 2001 root@kapran.bitmcnit.bryansk.su:/usr/src/sys/compile/KAPRAN i386


>Description:
	make.1 manpage describes :C modifier in comparison to :S, but
	before :S. That brings some inconvenience for first-time
	readers.  The first patch moves :C section just below :S (cut-n-paste
	only, no semantic changes) and the second adds some
	insignificant markup to the section.

>How-To-Repeat:
	
>Fix:
--- /usr/src/usr.bin/make/make.1	Wed Apr 25 20:50:37 2001
+++ make.1	Sun Apr 29 10:34:32 2001
@@ -584,34 +584,6 @@
 The colon may be escaped with a backslash
 .Pq Ql \e .
 .Bl -tag -width Cm
-.Sm off
-.It Cm C No \&/ Ar pattern Xo
-.No \&/ Ar replacement
-.No \&/ Op Cm 1g
-.Xc
-.Sm on
-The 
-.Cm C
-modifier is just like the
-.Cm S
-modifier except that the old and new strings, instead of being
-simple strings, are a regular expression (see
-.Xr regex 3 )
-and an
-.Xr ed 1 Ns \-style
-replacement string.  Normally, the first occurrence of the pattern in
-each word of the value is changed.  The
-.Ql 1
-modifier causes the substitution to apply to at most one word; the
-.Ql g
-modifier causes the substitution to apply to as many instances of the
-search pattern as occur in the word or words it is found in.  Note that
-.Ql 1
-and
-.Ql g
-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
 Replaces each word in the variable with its suffix.
 .It Cm H
@@ -685,6 +657,34 @@
 of a dollar sign
 .Pq Ql \&$ ,
 not a preceding dollar sign as is usual.
+.Sm off
+.It Cm C No \&/ Ar pattern Xo
+.No \&/ Ar replacement
+.No \&/ Op Cm 1g
+.Xc
+.Sm on
+The 
+.Cm C
+modifier is just like the
+.Cm S
+modifier except that the old and new strings, instead of being
+simple strings, are a regular expression (see
+.Xr regex 3 )
+and an
+.Xr ed 1 Ns \-style
+replacement string.  Normally, the first occurrence of the pattern in
+each word of the value is changed.  The
+.Ql 1
+modifier causes the substitution to apply to at most one word; the
+.Ql g
+modifier causes the substitution to apply to as many instances of the
+search pattern as occur in the word or words it is found in.  Note that
+.Ql 1
+and
+.Ql g
+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 T
 Replaces each word in the variable with its last component.
 .It Ar old_string=new_string

--- make.1.orig	Sun Apr 29 10:34:32 2001
+++ make.1	Sun Apr 29 10:22:00 2001
@@ -672,13 +672,16 @@
 .Xr regex 3 )
 and an
 .Xr ed 1 Ns \-style
-replacement string.  Normally, the first occurrence of the pattern in
-each word of the value is changed.  The
+replacement string.  Normally, the first occurrence of the
+.Ar pattern
+in each word of the value is changed.  The
 .Ql 1
 modifier causes the substitution to apply to at most one word; the
 .Ql g
 modifier causes the substitution to apply to as many instances of the
-search pattern as occur in the word or words it is found in.  Note that
+search
+.Ar pattern
+as occur in the word or words it is found in.  Note that
 .Ql 1
 and
 .Ql g
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200104290655.f3T6t8H00999>