From owner-freebsd-doc  Fri Oct 30 10:00:07 1998
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Received: (from majordom@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id KAA06876
          for freebsd-doc-outgoing; Fri, 30 Oct 1998 10:00:07 -0800 (PST)
          (envelope-from owner-freebsd-doc@FreeBSD.ORG)
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id KAA06823
          for <doc@FreeBSD.ORG>; Fri, 30 Oct 1998 10:00:00 -0800 (PST)
          (envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.8.8/8.8.5) id KAA24469;
	Fri, 30 Oct 1998 10:00:01 -0800 (PST)
Received: from mail.yk.rim.or.jp (mail.yk.rim.or.jp [202.247.130.37])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id JAA06062
          for <FreeBSD-gnats-submit@freebsd.org>; Fri, 30 Oct 1998 09:52:17 -0800 (PST)
          (envelope-from k-horik@yk.rim.or.jp)
Received: from localhost (ppp440.yk.rim.or.jp [202.247.165.140])
	by mail.yk.rim.or.jp (8.8.5/3.6W-RIMNET-98-06-09) with ESMTP id CAA21799
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 31 Oct 1998 02:52:15 +0900 (JST)
Message-Id: <19981031025141Z.k-horik@yk.rim.or.jp>
Date: Sat, 31 Oct 1998 02:51:41 +0900
From: horikawa@jp.freebsd.org
Reply-To: horikawa@jp.freebsd.org
To: FreeBSD-gnats-submit@FreeBSD.ORG
X-Send-Pr-Version: 3.2
Subject: docs/8505: as.1's SYNOPSIS contains minor typo (unbalanced brackes)
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>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