From nobody@FreeBSD.org  Sun Dec  5 15:13:36 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 168BF16A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  5 Dec 2004 15:13:36 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0516443D5C
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  5 Dec 2004 15:13:36 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id iB5FDZLa047584
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 5 Dec 2004 15:13:35 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id iB5FDZMY047582;
	Sun, 5 Dec 2004 15:13:35 GMT
	(envelope-from nobody)
Message-Id: <200412051513.iB5FDZMY047582@www.freebsd.org>
Date: Sun, 5 Dec 2004 15:13:35 GMT
From: Francois Ropert <francois.ropert@rezalfr.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: handbook network-inetd webpage
X-Send-Pr-Version: www-2.3

>Number:         74724
>Category:       docs
>Synopsis:       [patch] several problems in handbook network-inetd webpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ceri
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Dec 05 15:20:18 GMT 2004
>Closed-Date:    Thu Feb 16 20:57:32 GMT 2006
>Last-Modified:  Thu Feb 16 20:57:32 GMT 2006
>Originator:     Francois Ropert
>Release:        5.3-RELEASE
>Organization:
>Environment:
FreeBSD reloaded 5.3-RELEASE-p1 FreeBSD 5.3-RELEASE-p1 #8: Tue Nov 30 19:15:09 CET 2004 root@reloaded:/usr/src/sys/i386/compile/ASPIRE  i386
>Description:
First problem : Miss words in 23.2.3 Command-Line Options section : inetd synopsis missings : [-s maximum ]

Second problem :

Missing description of -s maximum (after -R rate description and before -a description)

Third problem :

Typo error in 23.2.4 inetd.conf : Comments in the file are precedeb by a #.

# is surround of antiquote and quotation marks.
>How-To-Repeat:
Refresh web browser
>Fix:
First problem : add [-s maximum] between [-R rate] and [configuration file] in synopsis.

Second problem : Missing description of -s maximum :

-s maximum
Specify the default maximum number of simultaneous invocations of each service from a single IP address; the default is unlimited. May be overridden on a per-service basis with the "max-child-per-ip" parameter.

Third problem :

Replace ``#'' by ''#'' in the third line from "Example 23-1. Sending inetd a HangUP Signal".


>Release-Note:
>Audit-Trail:

From: "Kevin D. Kinsey, DaleCo, S.P." <kdk@daleco.biz>
To: Francois Ropert <francois.ropert@rezalfr.org>
Cc: freebsd-gnats-submit@freebsd.org
Subject: [PATCH] Re: docs/74724: handbook network-inetd webpage
Date: Mon, 13 Dec 2004 23:35:58 -0600

 Francois Ropert wrote:
 
 >First problem : Miss words in 23.2.3 Command-Line Options section : inetd synopsis missings : [-s maximum ]
 >
 >Second problem :
 >
 >Missing description of -s maximum (after -R rate description and before -a description)
 >
 >  
 >
 Third problem :
 
 >Typo error in 23.2.4 inetd.conf : Comments in the file are preceded by a #.
 >
 ># is surround of antiquote and quotation marks.
 >  
 >
 
 
 Merci, Francois for the problem report.  I have addressed items
 #1 and #2.  The "antiquote" "quote" problem is in the way the
 documents are rendered; in the sgml source files they are listed
 as <quote> </quote>, so someone more experienced than I will
 need to address that, if indeed it can be addressed within the
 current doc build system (IANAE.)
 
 Thanks again for your submission.  I have attached a patch
 below for the Document Project Team to review.
 
 Kevin Kinsey
 
 Affects: /usr/doc/en/books/handbook/network-servers/chapter.sgml
 ------------------------------------------------------------------------------------------------------------------
 
 --- chapter.sgml        Fri Nov 19 17:19:42 2004
 +++ chapter.sgml.edit   Mon Dec 13 23:27:32 2004
 @@ -158,7 +158,7 @@
        <para><application>inetd</application> synopsis:</para>
  
        <para><option>     inetd [-d] [-l] [-w] [-W] [-c maximum] [-C 
 rate] [-a address | hostname]
 -           [-p filename] [-R rate] [configuration file]</option></para>
 +           [-p filename] [-R rate] [-s maximum] [configuration 
 file]</option></para>
  
        <variablelist>
         <varlistentry>
 @@ -229,6 +229,19 @@
               allows an unlimited number of invocations.</para>
           </listitem>
         </varlistentry>
 +
 +      <varlistentry>
 +          <term>-s maximum</term>
 +
 +          <listitem>
 +            <para>Specify the default maximum number of simultaneous
 +             invocations of each service from a single IP address;
 +             the default is unlimited.  May be overridden on a
 +             per-service basis with the
 +             <option>max-child-per-ip</option>
 +              parameter.</para>
 +          </listitem>
 +        </varlistentry>
  
         <varlistentry>
           <term>-a</term>
 
 --------------------------------------------------------------------------------------------------------------------
Responsible-Changed-From-To: freebsd-doc->ceri 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Tue Dec 14 11:07:47 GMT 2004 
Responsible-Changed-Why:  
I'll shepherd Kevin's patch in. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=74724 

From: Ceri Davies <ceri@submonkey.net>
To: "Kevin D. Kinsey, DaleCo, S.P." <kdk@daleco.biz>
Cc: FreeBSD Gnats Submit <freebsd-gnats-submit@FreeBSD.org>
Subject: Re: docs/74724: handbook network-inetd webpage
Date: Tue, 14 Dec 2004 11:07:39 +0000

 On Tue, Dec 14, 2004 at 05:40:28AM +0000, Kevin D. Kinsey, DaleCo, S.P. wrote:
 > The following reply was made to PR docs/74724; it has been noted by GNATS.
 
 >  Third problem :
 >  
 >  >Typo error in 23.2.4 inetd.conf : Comments in the file are preceded by a #.
 >  >
 >  ># is surround of antiquote and quotation marks.
 >  
 >  Merci, Francois for the problem report.  I have addressed items
 >  #1 and #2.  The "antiquote" "quote" problem is in the way the
 >  documents are rendered; in the sgml source files they are listed
 >  as <quote> </quote>, so someone more experienced than I will
 >  need to address that, if indeed it can be addressed within the
 >  current doc build system (IANAE.)
 
 # should be marked up as <literal> there, not with <quote>.
 
 Ceri
 
 Patch looks good, by the way.

From: Kevin Kinsey <kdk@daleco.biz>
To: Ceri Davies <ceri@submonkey.net>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/74724: handbook network-inetd webpage]
Date: Fri, 17 Dec 2004 18:29:06 -0600

 Ceri Davies wrote:
 
 >OK.  Would you like to send me the patch as it stands now and I'll check
 >that we're really on the same wavelength here.
 >  
 >
 >>If the example works for you, I'll submit a new (albeit larger)
 >>patch when I can (before the Holidays) and let you guys do
 >>whatcha will.
 >>    
 >>
 >
 >OK, great.  I'm away between the 20th and 29th and probably offline for
 >the duration, so if you want to run it by someone else rather than
 >waiting that's ok withe me.  Otherwise I'll pick it up when I get back.
 >  
 >
 
 Hope you have a good Holiday.  I'll put this one back
 in the PR stack, in case you're off line already...
 
 New patch for this chapter:
 
 http://daleco.biz/patches/74724.patch
 
 This is an "old style" diff, but applies cleanly.  The
 result is at:
 
 http://daleco.biz/inetd.html
 
              but is subject to removal at my whim ;-)
 
 Another, equivalent "unified" patch (diff -u) doesn't
 seem to apply cleanly for me.  If this would be better
 and you can fix it, 'tis here:
 
 http://daleco.biz/patches/74724.patch.u.bad
 
 Kevin Kinsey
State-Changed-From-To: open->closed 
State-Changed-By: ceri 
State-Changed-When: Thu Feb 16 20:56:56 UTC 2006 
State-Changed-Why:  
Sorry this took so long, but it's been fixed. 

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