Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 31 Oct 1998 02:51:41 +0900
From:      horikawa@jp.freebsd.org
To:        FreeBSD-gnats-submit@FreeBSD.ORG
Subject:   docs/8505: as.1's SYNOPSIS contains minor typo (unbalanced brackes)
Message-ID:  <19981031025141Z.k-horik@yk.rim.or.jp>

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

>Number:         8505
>Category:       docs
>Synopsis:       as.1 SYNOPSIS contains minor typo (unbalanced brackets)
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Oct 30 10:00:01 PST 1998
>Last-Modified:
>Originator:     Kazuo Horikawa
>Organization:
jpman Project, Japan FreeBSD Users Group.
>Release:        FreeBSD 2.2.5-RELEASE i386
>Environment:

	src/contrib/binutils/gas/doc/as.1 revision 1.1.1.2 (HEAD)

>Description:

	In as.1's SYSNOPSIS, brackets are unbalanced.

	"% man 1 as" shows:
	as.1:12: `\|' is not allowed in an escape name
	[snip]
	SYNOPSIS
	       as [-a[dhlns]=file]] [-D] [--defsym SYM=VAL] [-f]
	[snip]


	Manpage as.1 contains following lines:
	[snip]
	.SH SYNOPSIS
	.na
	.B as
	.RB "[\|" \-a "[\|" dhlns "\|]" \c
	\&\[\|\=\c
          ^^                                  <- reporter inserted this line.
	.I file\c
	\&\|]\|]
	[snip]


	I think that author wanted to use "[", and that author did
	not want to use "\[". ("\[" is prefix of "\[xxx]".)

	After I removed "\" before "[", "man 1 as" shows:
	[snip]
	SYNOPSIS
	       as [-a[dhlns][=file]] [-D] [--defsym SYM=VAL] [-f]
	[snip]

>How-To-Repeat:

	% man 1 as

>Fix:
	
--- as.1.orig	Sun Oct 25 22:37:59 1998
+++ as.1	Sun Oct 25 22:38:03 1998
@@ -9,7 +9,7 @@
 .na
 .B as
 .RB "[\|" \-a "[\|" dhlns "\|]" \c
-\&\[\|\=\c
+\&[\|\=\c
 .I file\c
 \&\|]\|]
 .RB "[\|" \-D "\|]"
>Audit-Trail:
>Unformatted:

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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19981031025141Z.k-horik>