From nobody@FreeBSD.org  Tue Dec 30 15:10:19 2003
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 9A10E16A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 30 Dec 2003 15:10:19 -0800 (PST)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id D13FC43D54
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 30 Dec 2003 15:10:18 -0800 (PST)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.10/8.12.10) with ESMTP id hBUNAIdL074320
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 30 Dec 2003 15:10:18 -0800 (PST)
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.10/8.12.10/Submit) id hBUNAI7d074319;
	Tue, 30 Dec 2003 15:10:18 -0800 (PST)
	(envelope-from nobody)
Message-Id: <200312302310.hBUNAI7d074319@www.freebsd.org>
Date: Tue, 30 Dec 2003 15:10:18 -0800 (PST)
From: Lucas <aspiesrule@mcleodusa.net>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Bug in hypertext version of random (4) manpage
X-Send-Pr-Version: www-2.0

>Number:         60743
>Category:       docs
>Synopsis:       Bug in hypertext version of random (4) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    schweikh
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 30 15:20:07 PST 2003
>Closed-Date:    Tue Feb 10 11:35:24 PST 2004
>Last-Modified:  Tue Feb 10 11:35:24 PST 2004
>Originator:     Lucas
>Release:        N/A
>Organization:
Private
>Environment:
N/A
>Description:
      In the documentation paragraphs for the "kern.random.sys.harvest.ethernet", "kern.random.sys.harvest.point_to_point", and "kern.random.sys.harvest.interrupt" sysctls, the text "one (1)" has been erroneously converted into a hyperlink that tries to search for a (nonexistent) manpage titled "one" in section 1.
>How-To-Repeat:
      Read the hypertext manpage for random (4).  Try to click on one of the links to one (1).  Watch man.cgi give up.
>Fix:
      Change "<A HREF=...>one (1)</A>" to "one (1)".  Sorry, but I am writing this PR from a Wintel box w/o a working copy of diff, so I cannot provide a patch at this time.
>Release-Note:
>Audit-Trail:

From: Marc Silver <marcs@draenor.org>
To: freebsd-gnats-submit@FreeBSD.org, aspiesrule@mcleodusa.net
Cc:  
Subject: Re: docs/60743: Bug in hypertext version of random (4) manpage
Date: Sat, 17 Jan 2004 15:56:14 +0000

 --5G06lTa6Jq83wMTw
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Hi,
 
 Due to the fact that the man.cgi dymanically generates the HTML page
 from the raw man page, I'm not entirely sure if this problem should be
 fixed in man.cgi or in the actual man page.  man.cgi should perhaps be
 more stringent when generating links to other pages, as the man page
 contains 'one (1)' and not 'one(1)', as is the standard adhered to in
 FreeBSD man pages.
 
 That said, my personal feeling is that the man page could more easily be
 changed with fewer consequences, and I've attached a patch to that end.
 Perhaps someone who knows more than me about this could make a decision
 on where the change should go.
 
 Cheers,
 Marc
 
 --5G06lTa6Jq83wMTw
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="random.4-patch"
 
 --- random.4-orig	Sat Jan 17 17:39:00 2004
 +++ random.4	Sat Jan 17 17:53:48 2004
 @@ -107,27 +107,27 @@
  The
  .Va kern.random.sys.harvest.ethernet
  variable is used to select LAN traffic as an entropy source.
 -A zero (0) value means that LAN traffic
 +A value of 0 (zero) value means that LAN traffic
  is not considered as an entropy source.
 -Set the variable to one (1)
 +Set the variable to 1 (one)
  if you wish to use LAN traffic for entropy harvesting.
  .Pp
  The
  .Va kern.random.sys.harvest.point_to_point
  variable is used to select serial line traffic as an entropy source.
  (Serial line traffic includes PPP, SLIP and all tun0 traffic.)
 -A zero (0) value means such traffic
 +A 0 (zero) value means such traffic
  is not considered as an entropy source.
 -Set the variable to one (1)
 +Set the variable to 1 (one)
  if you wish to use it for entropy harvesting.
  .Pp
  The
  .Va kern.random.sys.harvest.interrupt
  variable is used to select hardware interrupts
  as an entropy source.
 -A zero (0) value means interrupts
 +A 0 (zero) value means interrupts
  are not considered as an entropy source.
 -Set the variable to one (1)
 +Set the variable to 1 (one)
  if you wish to use them for entropy harvesting.
  All interrupt harvesting is setup by the
  individual device drivers.
 
 --5G06lTa6Jq83wMTw--
State-Changed-From-To: open->patched 
State-Changed-By: schweikh 
State-Changed-When: Tue Jan 20 13:35:23 PST 2004 
State-Changed-Why:  
Patch committed, thanks! 


Responsible-Changed-From-To: freebsd-doc->schweikh 
Responsible-Changed-By: schweikh 
Responsible-Changed-When: Tue Jan 20 13:35:23 PST 2004 
Responsible-Changed-Why:  
My MFC Reminder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=60743 
State-Changed-From-To: patched->closed 
State-Changed-By: schweikh 
State-Changed-When: Tue Feb 10 11:35:01 PST 2004 
State-Changed-Why:  
Not applicable to -STABLE. 

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