From owner-freebsd-bugs  Thu Mar  7 14: 0:38 2002
Delivered-To: freebsd-bugs@hub.freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 3C29837B402
	for <freebsd-bugs@hub.freebsd.org>; Thu,  7 Mar 2002 14:00:09 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g27M09H99032;
	Thu, 7 Mar 2002 14:00:09 -0800 (PST)
	(envelope-from gnats)
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id 37E9637B439
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  7 Mar 2002 13:55:06 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id 997F9BD80
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  7 Mar 2002 13:55:06 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id NAA12521
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 7 Mar 2002 13:55:06 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g27LwIL46775;
	Thu, 7 Mar 2002 13:58:18 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <zc3czcca6d.czc@localhost.localdomain>
Date: 07 Mar 2002 13:58:18 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: bin/35648: rc.conf; add note about "flags" to both files
Sender: owner-freebsd-bugs@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-bugs.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-bugs>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-bugs>
X-Loop: FreeBSD.org


>Number:         35648
>Category:       bin
>Synopsis:       rc.conf; add note about "flags" to both files
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 07 14:00:09 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The /etc/rc.conf and /etc/default/rc.conf files should have a comment
near the top noting that "_flags" may be interpreted as "_options"
and that "flags" always need a leading "-".

The term "flag" is ambiguous (see sh(1) and csh(1) for examples) as to
whether it means, eg, "-o" or just the "o".

It is also ambiguous in referring only to the "-o" and not including
the "-o' option's arguments (or even to only single-character options),
so it should be made clear that _flags is used here for both kinds.
================
>How-To-Repeat:
n/a
================
>Fix:

Add something like:

#
# Variable names with "_flags" suffixes may be interpreted as "_options"
# and the quoted arguments should always begin with "-".
>Release-Note:
>Audit-Trail:
>Unformatted:

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