Bug 106027

Summary: man 4 random has a URL as reference - 2nd TRIAL
Product: Documentation Reporter: Dr. Markus Waldeck <waldeck>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Dr. Markus Waldeck 2006-11-29 18:50:20 UTC
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:
Comment 1 Remko Lodder freebsd_committer freebsd_triage 2006-11-29 20:16:00 UTC
State Changed
From-To: open->closed

please refer to the audit trail to see why i close this pr.
Comment 2 Remko Lodder freebsd_committer freebsd_triage 2006-11-29 20:16:21 UTC
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 */
Comment 3 Dr. Markus Waldeck 2006-11-30 07:49:52 UTC
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 für Modem und ISDN: http://www.gmx.net/de/go/smartsurfer