From nobody@FreeBSD.org  Mon Aug 16 01:30:17 2004
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id ECE4216A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 16 Aug 2004 01:30:15 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id D37E743D2F
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 16 Aug 2004 01:30:15 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i7G1UFN6086857
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 16 Aug 2004 01:30:15 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.11/8.12.11/Submit) id i7G1UFid086856;
	Mon, 16 Aug 2004 01:30:15 GMT
	(envelope-from nobody)
Message-Id: <200408160130.i7G1UFid086856@www.freebsd.org>
Date: Mon, 16 Aug 2004 01:30:15 GMT
From: Marian Cerny <jojo@matfyz.cz>
To: freebsd-gnats-submit@FreeBSD.org
Subject: re_format(7) contains many extra '='
X-Send-Pr-Version: www-2.3

>Number:         70506
>Category:       docs
>Synopsis:       re_format(7) contains many extra '='
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 16 01:30:26 GMT 2004
>Closed-Date:    Wed Oct 20 22:49:09 GMT 2004
>Last-Modified:  Wed Oct 20 22:49:09 GMT 2004
>Originator:     Marian Cerny
>Release:        FreeBSD 5.2.1
>Organization:
>Environment:
FreeBSD potvorka 5.2.1-RELEASE FreeBSD 5.2.1-RELEASE #2: Sat Aug 14 14:06:07 CEST 2004
majo@potvorka:/usr/src/sys/i386/compile/POTVORKA  i386
>Description:
The manual page for re_format(7) contains many extra equal signs ('=').

I found them on this lines:

> A (modern) RE is one= or more non-empty= branches, separated by `|'.  It
> A branch is one= or more pieces, concatenated.  It matches a match for
> A piece is an atom possibly followed by a single= `*', `+', `?', or
> lowed by `}'.  The integers must lie between 0 and RE_DUP_MAX (255=)
> string)=, a bracket expression (see below), `.' (matching any single
> ordinary character), a `\' followed by any other character= (matching
> present=), or a single character with no other significance (matching
> ordinary character, not the beginning of a bound=.  It is illegal to end
> any decimal digit.  It is illegal= for two ranges to share an endpoint,
> and `[xy]' are all synonymous.  An equivalence class may not= be an end-
> There are two special cases= of bracket expressions: the bracket expres-
> No particular limit is imposed on the length of REs=.  Programs intended
> at the beginning of the RE or= the beginning of a parenthesized subex-
> pression, `$' is an ordinary character except at the end of the RE or=

On some lines it looks to me, it should be some special character. On
others not.
>How-To-Repeat:
man 7 re_format
>Fix:
Just remove those '=' mentioned above.
>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Marian Cerny <jojo@matfyz.cz>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/70506: re_format(7) contains many extra '='
Date: Tue, 17 Aug 2004 14:51:15 +0300

 On 2004-08-16 01:30, Marian Cerny <jojo@matfyz.cz> wrote:
 > The manual page for re_format(7) contains many extra equal signs ('=').
 
 Note that these are not really "extra" in the sense that they're
 unnecessary.  When the manpage is formatted for text output, it's easy
 to miss that this is some special character.  If you look at the
 Postscript formatted version of the manpage:
 
         $ man -t re_format > re_format.ps
         $ gv re_format.ps
 
 you'll easily notice that this special character is a double-dagger.
 
 The first paragraph of the manpage includes this text too:
 
         `=' marks decisions on these aspects that may not be fully
         portable to other IEEE Std 1003.2 (``POSIX.2'') implementations.
 
 Therefore, I don't these characters should be removed.
 
 - Giorgos
 
State-Changed-From-To: open->feedback 
State-Changed-By: keramida 
State-Changed-When: Tue Oct 12 14:58:21 GMT 2004 
State-Changed-Why:  
Do you think it's ok to leave these '=' signs in the manpage, or should we try 
to find a character that looks ok as a footnote mark in both nroff and groff 
formatted output? 

http://www.freebsd.org/cgi/query-pr.cgi?pr=70506 
State-Changed-From-To: feedback->closed 
State-Changed-By: keramida 
State-Changed-When: Wed Oct 20 22:47:54 GMT 2004 
State-Changed-Why:  
Submitter says this is not really a bug. 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Wed Oct 20 22:47:54 GMT 2004 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=70506 
>Unformatted:
