From garys@opusnet.com  Fri Aug 19 00:40:16 2005
Return-Path: <garys@opusnet.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 19CEA16A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 19 Aug 2005 00:40:16 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from opusnet.com (mail.opusnet.com [209.210.200.6])
	by mx1.FreeBSD.org (Postfix) with ESMTP id CA17B43D48
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 19 Aug 2005 00:40:15 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
  (SMTPD32-8.05) id AA6C61400B2; Thu, 18 Aug 2005 17:40:12 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j7J0fHLn001056
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 18 Aug 2005 17:41:17 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j7J0fCxh001055;
	Thu, 18 Aug 2005 17:41:12 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Message-Id: <6yy86ysqqf.86y@mail.opusnet.com>
Date: Thu, 18 Aug 2005 17:41:12 -0700
From: "Gary W. Swearingen" <garys@opusnet.com>
Reply-To: garys@opusnet.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: sh(1) manpage doesn't contain the word "comment", etc.
X-GNATS-Notify:

>Number:         85103
>Category:       docs
>Synopsis:       sh(1) manpage doesn't contain the word "comment", etc.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Aug 19 00:50:19 GMT 2005
>Closed-Date:    Sun Jan 01 16:14:23 GMT 2006
>Last-Modified:  Sun Jan 01 16:14:23 GMT 2006
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 5.4-RELEASE i386
>Organization:
none
>Environment:
n/a
>Description:

The sh(1) manpage doesn't describe "#" comments or contain the
word "comment" for people searching for that.

>How-To-Repeat:
>Fix:

The "pdksh" manpage slips in this phrase:

    #, if used at the beginning of a word, introduces a comment --
    everything after the # up to the nearest newline is ignored;

but it should also say something about it not working interactively.
>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <keramida@ceid.upatras.gr>
To: "Gary W. Swearingen" <garys@opusnet.com>
Cc: bug-followup@freebsd.org
Subject: Re: docs/85103: sh(1) manpage doesn't contain the word "comment", etc.
Date: Fri, 19 Aug 2005 15:52:06 +0300

 On 2005-08-18 17:41, "Gary W. Swearingen" <garys@opusnet.com> wrote:
 > The sh(1) manpage doesn't describe "#" comments or contain the
 > word "comment" for people searching for that.
 >
 > The "pdksh" manpage slips in this phrase:
 >
 >     #, if used at the beginning of a word, introduces a comment --
 >     everything after the # up to the nearest newline is ignored;
 >
 > but it should also say something about it not working interactively.
 
 It does work interactively too:
 
 % flame:/home/keramida$ env PS1='$ ' sh
 % $ echo foo # bar
 % foo
 % $
 
 But you're right we should add something about comments.
 

From: Daniel Gerzo <danger@rulez.sk>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/85103: sh(1) manpage doesn't contain the word "comment", etc.
Date: Sat, 31 Dec 2005 14:44:10 +0100

 --DocE+STaALJfprDB
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Hello,
 
    Here is diff.
 
 -- 
 Sincerely,
    Daniel Gerzo
 
 --DocE+STaALJfprDB
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="sh.1.diff"
 
 --- sh.1.orig	Fri Dec 30 23:28:16 2005
 +++ sh.1	Sat Dec 31 00:14:13 2005
 @@ -358,6 +358,12 @@
  .It Li <& Ta Li >& Ta Li <<- Ta Li >|
  .El
  .El
 +.Pp
 +.Ql #
 +introduces a comment if used at the beginning of the word.
 +Everything after the
 +.Ql #
 +up to the nearest newline is ignored.
  .Ss Quoting
  Quoting is used to remove the special meaning of certain characters
  or words to the shell, such as operators, whitespace, keywords,
 
 --DocE+STaALJfprDB--
State-Changed-From-To: open->closed 
State-Changed-By: stefanf 
State-Changed-When: Sun Jan 1 16:14:12 UTC 2006 
State-Changed-Why:  
Committed.  Thanks! 

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