From nobody@FreeBSD.org  Wed May  3 21:42:13 2000
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id 492FD37BFA8
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  3 May 2000 21:42:13 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id VAA33895;
	Wed, 3 May 2000 21:42:12 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Message-Id: <200005040442.VAA33895@freefall.freebsd.org>
Date: Wed, 3 May 2000 21:42:12 -0700 (PDT)
From: bobj@atlantic.net
Sender: nobody@FreeBSD.org
To: freebsd-gnats-submit@FreeBSD.org
Subject: Information on SSH hard to find in Handbook
X-Send-Pr-Version: www-1.0

>Number:         18379
>Category:       docs
>Synopsis:       Information on SSH hard to find in Handbook
>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 May  3 21:50:01 PDT 2000
>Closed-Date:    Mon Jun 25 06:58:38 PDT 2001
>Last-Modified:  Mon Jun 25 07:03:58 PDT 2001
>Originator:     Bob Johnson
>Release:        n/a
>Organization:
>Environment:
n/a
>Description:
The FreeBSD Handbook (as of 3 May 00) at http://www.freebsd.org/handbook/
does not list SSH in the Table of Contents, although other security 
tools such as SSL are in the TOC.  This makes it difficult for someone 
reading the Handbook to locate information on SSH, even though the 
information is there.
>How-To-Repeat:
Read the Table of Contents for the Handbook.  Also look at 
Section 8.3, "Securing FreeBSD" (including its subsections), 
and note that it contains a fair amount of information on SSH.

>Fix:
Although a complete solution would require re-writing part of the 
handbook, an adequate interim solution would be to rename 
Section 8.3 from "Securing FreeBSD" to "Securing FreeBSD: SSH 
and Other Tools" (or some similar title that mentions SSH).


>Release-Note:
>Audit-Trail:

From: Ben Smithurst <ben@FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org, bobj@atlantic.net
Cc:  
Subject: Re: docs/18379: Information on SSH hard to find in Handbook
Date: Sat, 15 Jul 2000 18:10:22 +0100

 > Description
 >
 >      The FreeBSD Handbook (as of 3 May 00) at
 >      http://www.freebsd.org/handbook/ does not list SSH in the Table
 >      of Contents, although other security tools such as SSL are in the
 >      TOC.  This makes it difficult for someone reading the Handbook to
 >      locate information on SSH, even though the information is there.
 >
 > How-To-Repeat
 >
 >      Read the Table of Contents for the Handbook.  Also look at
 >      Section 8.3, "Securing FreeBSD" (including its subsections), and
 >      note that it contains a fair amount of information on SSH.
 >
 > Fix
 >
 >      Although a complete solution would require re-writing part of the
 >      handbook, an adequate interim solution would be to rename Section
 >      8.3 from "Securing FreeBSD" to "Securing FreeBSD: SSH and Other
 >      Tools" (or some similar title that mentions SSH).
 
 I think Nik (and maybe other docproj people) are looking at indexing
 the Handbook so you could just lookup "ssh" there.  Adding "SSH" to
 the title seems like a bit of a special case hack, and it shouldn't be
 too difficult to find, since people looking for "ssh" will probably be
 at least vaguely interested in the whole "Security" section anyway.
 Perhaps someone else has thoughts on this?
 
 If you want to break up that section into two parts, one about SSH, and
 one about the other stuff already covered, that might be better. :-)
 
 -- 
 Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
 FreeBSD Documentation Project /
 

From: Bob Johnson <bobj@ufl.edu>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/18379: Information on SSH hard to find in Handbook
Date: Thu, 22 Feb 2001 15:50:26 -0500

 I have a draft document describing SSH and its usage that I wrote as a response 
 to this PR.  It is available for review at http://www.afn.org/~ambient/sshfreebsd.rtf 
 or http://www.afn.org/~ambient/sshfreebsd.html.  The RTF version has better 
 formatting.
 
 At this point I am soliciting comments before I clean it up and submit it for 
 inclusion in the Handbook, although if the Handbook maintainers want to take 
 it and run with it as is, that's fine with me.
 
 My primary interest at this point is to try to catch factual errors.  A few 
 things in the document are there on faith; I haven't tested them yet.  I still 
 need to work on completing parts of it (I will probably get rid of some of the 
 configuration stuff because that is adequately covered in the man pages).
 
 Note I am the original submitter of the PR: my email address has changed.
State-Changed-From-To: open->closed 
State-Changed-By: nik 
State-Changed-When: Mon Jun 25 06:58:38 PDT 2001 
State-Changed-Why:  
Lots of info about ssh was recently committed to the Handbook.  See 

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/openssh.html 

for more.  Thanks for the PR. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=18379 
>Unformatted:
