From owner-freebsd-doc@FreeBSD.ORG Wed Nov 29 20:32:46 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id E079416A510 for ; Wed, 29 Nov 2006 20:32:45 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [69.147.83.40]) by mx1.FreeBSD.org (Postfix) with ESMTP id BD0B543CF3 for ; Wed, 29 Nov 2006 20:30:18 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id kATKU90b067523 for ; Wed, 29 Nov 2006 20:30:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id kATKU8fB067522; Wed, 29 Nov 2006 20:30:08 GMT (envelope-from gnats) Date: Wed, 29 Nov 2006 20:30:08 GMT Message-Id: <200611292030.kATKU8fB067522@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Remko Lodder Cc: Subject: Re: docs/106027: man 4 random has a URL as reference - 2nd TRIAL X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Remko Lodder List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 29 Nov 2006 20:32:46 -0000 The following reply was made to PR docs/106027; it has been noted by GNATS. From: Remko Lodder To: "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 */