From nobody@FreeBSD.org  Wed Nov 29 18:46:43 2006
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 5EA2216A415
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 29 Nov 2006 18:46:43 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [69.147.83.33])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 060FE43CAC
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 29 Nov 2006 18:46:40 +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 kATIkgb2049249
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 29 Nov 2006 18:46:42 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id kATIkglf049248;
	Wed, 29 Nov 2006 18:46:42 GMT
	(envelope-from nobody)
Message-Id: <200611291846.kATIkglf049248@www.freebsd.org>
Date: Wed, 29 Nov 2006 18:46:42 GMT
From: "waldeck@gmx.de"<waldeck@gmx.de>
To: freebsd-gnats-submit@FreeBSD.org
Subject: man 4 random has a URL as reference - 2nd TRIAL
X-Send-Pr-Version: www-3.0

>Number:         106027
>Category:       docs
>Synopsis:       man 4 random has a URL as reference - 2nd TRIAL
>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:   Wed Nov 29 18:50:20 GMT 2006
>Closed-Date:    Wed Nov 29 20:16:02 GMT 2006
>Last-Modified:  Thu Nov 30 07:50:15 GMT 2006
>Originator:     waldeck@gmx.de
>Release:        7.0-CURRENT-200611
>Organization:
>Environment:
FreeBSD fbh 7.0-CURRENT-200611 FreeBSD 7.0-CURRENT-200611
root@fb:/usr/src/sys/i386/compile/FB70B01 i386
>Description:
Follow up to PR 101564 (http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/101564).

> The URL is required to understand the Yarrow protocol, we cannot remove
> that eventhough it requires internet access for this.

If the paper is really required for the understanding it should be part of the system.

I asked Bruce Schneier about the topic and I got following answer:

>How-To-Repeat:

>Fix:

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Wed Nov 29 20:16:00 UTC 2006 
State-Changed-Why:  
please refer to the audit trail to see why i close this pr. 

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

From: Remko Lodder <remko@FreeBSD.org>
To: "waldeck@gmx.de" <waldeck@gmx.de>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/106027: man 4 random has a URL as reference - 2nd TRIAL
Date: Wed, 29 Nov 2006 21:16:21 +0100

 waldeck@gmx.de wrote:
 >> Number:         106027
 >> Category:       docs
 >> Synopsis:       man 4 random has a URL as reference - 2nd TRIAL
 >> Confidential:   no
 >> Severity:       non-critical
 >> Priority:       low
 >> Responsible:    freebsd-doc
 >> State:          open
 >> Quarter:        
 >> Keywords:       
 >> Date-Required:
 >> Class:          doc-bug
 >> Submitter-Id:   current-users
 >> Arrival-Date:   Wed Nov 29 18:50:20 GMT 2006
 >> Closed-Date:
 >> Last-Modified:
 >> Originator:     waldeck@gmx.de
 >> Release:        7.0-CURRENT-200611
 >> Organization:
 >> Environment:
 > FreeBSD fbh 7.0-CURRENT-200611 FreeBSD 7.0-CURRENT-200611
 > root@fb:/usr/src/sys/i386/compile/FB70B01 i386
 >> Description:
 > Follow up to PR 101564 (http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/101564).
 > 
 >> The URL is required to understand the Yarrow protocol, we cannot remove
 >> that eventhough it requires internet access for this.
 > 
 > If the paper is really required for the understanding it should be part of the system.
 > 
 > I asked Bruce Schneier about the topic and I got following answer:
 > 
 >> How-To-Repeat:
 > 
 >> Fix:
 > 
 >> Release-Note:
 >> Audit-Trail:
 >> Unformatted:
 >  >Hello Bruce,
 >  >
 >  >FreeBSD uses an implemenation of the yarrow pseudorandom number generator.
 >  >
 >  >The man page (man 4 random) includes the URL of your paper
 >  >(http://www.counterpane.com/yarrow.html).
 >  >
 >  >This is not convenient if your are offline.
 >  >
 >  >Is there any problem like licening issues if a copy of the paper is 
 >  >included in FreeBSD?
 >  
 >  No.
 >  
 >  Bruce
 >  
 > _______________________________________________
 > freebsd-doc@freebsd.org mailing list
 > http://lists.freebsd.org/mailman/listinfo/freebsd-doc
 > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"
 
 I dont feel conformtable doing that, we discussed this before and
 we will stick with the online reference, not only is that being
 maintained (which will probably wont be done very well within
 FreeBSD (no offense for the docteam) since it needs active
 following of the online document). As stated back then it will also not
 fit in a normally sized manual page, so that is not an option as well.
 
 I think we are done best with the current reference to the online paper.
 
 Some information from ruslan which i also used in the previous Pr/email:
 
  > if you follow it, you'll find the Yarrow paper is quite large,
  > and cannot probably be fit into a reasonable sized manpage.  I think
  > to understand the meaning of variables you need to know math and well
  > understand Yarrow theory, which that paper is about.
  > I think what's there now in our manpage is fine.
 
 So i see no other reason then to close this PR at this point.
 
 Thanks for taking the time to verify this with Bruce though!
 
 Cheers,
 Remko
 
 p.s. if someone else has another opinion feel free to grab the
 PR and reopen it.
 
 -- 
 Kind regards,
 
       Remko Lodder               ** remko@elvandar.org
       FreeBSD                    ** remko@FreeBSD.org
 
       /* Quis custodiet ipsos custodes */

From: "Dr. Markus Waldeck" <waldeck@gmx.de>
To: remko@FreeBSD.org, bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/106027: man 4 random has a URL as reference - 2nd 20TRIAL
Date: Thu, 30 Nov 2006 08:49:52 +0100

 Hi,
 
 > I dont feel conformtable doing that, we discussed this before and
 > we will stick with the online reference, not only is that being
 > maintained 
 
 Have you had a look to the home page?
 
 http://www.schneier.com/yarrow.html
 
 ==> Note: Yarrow is no longer being supported.
 
 This is the reason why I asked Bruce!
 
 Dr. Markus Waldeck
 
 
 -- 
 Der GMX SmartSurfer hilft bis zu 70% Ihrer Onlinekosten zu sparen! 
 Ideal fr Modem und ISDN: http://www.gmx.net/de/go/smartsurfer
>Unformatted:
 >Hello Bruce,
 >
 >FreeBSD uses an implemenation of the yarrow pseudorandom number generator.
 >
 >The man page (man 4 random) includes the URL of your paper
 >(http://www.counterpane.com/yarrow.html).
 >
 >This is not convenient if your are offline.
 >
 >Is there any problem like licening issues if a copy of the paper is 
 >included in FreeBSD?
 
 No.
 
 Bruce
 
