From nobody@FreeBSD.ORG Mon Jan 10 21:47:46 2000 Return-Path: Received: by hub.freebsd.org (Postfix, from userid 32767) id 53BD7153EC; Mon, 10 Jan 2000 21:47:46 -0800 (PST) Message-Id: <20000111054746.53BD7153EC@hub.freebsd.org> Date: Mon, 10 Jan 2000 21:47:46 -0800 (PST) From: bobj@atlantic.net Sender: nobody@FreeBSD.ORG To: freebsd-gnats-submit@FreeBSD.org Subject: Misc. typos etc. from Handbook X-Send-Pr-Version: www-1.0 >Number: 16050 >Category: docs >Synopsis: Misc. typos etc. from Handbook >Confidential: no >Severity: non-critical >Priority: medium >Responsible: jim >State: closed >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Jan 10 21:50:00 PST 2000 >Closed-Date: Wed Jan 12 16:09:37 PST 2000 >Last-Modified: Wed Jan 12 16:10:27 PST 2000 >Originator: Bob Johnson >Release: www.freebsd.org web pages as of 10JAN00 >Organization: >Environment: N/A >Description: Started reading handbook from beginning. Didn't get far, but noted following typos and other miscellaneous observations. Sorry, don't have facilities or time at present to reference SGML source, so these are web page references: http://www.freebsd.org/handbook/introduction.html "A full complement of C, C++, Fortran Perl development tools." should be "A full complement of C, C++, Fortran, and Perl development tools." (insert the word "and") http://www.freebsd.org/handbook/history.html "Those plans came to a rude halt when Bill Jolitz suddenly decided to withdraw his sanction from the project and without any clear indication of what would be done instead." should be "Those plans came to a rude halt when Bill Jolitz suddenly decided to withdraw his sanction from the project without any clear indication of what would be done instead." (delete the word "and") http://www.freebsd.org/handbook/relnotes.html "FreeBSD is a freely available, full source 4.4BSD-Lite2 based release for Intel i386/i486/Pentium/PentiumPro/Pentium II (or compatible) and DEC Alpha based computer systems." Should "Pentium III" be added to this list? http://www.freebsd.org/handbook/relnotes.html " To compile a port, you simply change to the directory of the program you wish to install, type make all followed by make install after successful compilation and let the system do the rest." Is "make all" necessary? Doesn't "make install" do an implicit "make all"? If so, why make things more complicated by turning one step into two? same page: "(Almost) every port is also provided as a pre-compiled ``package'' which can be installed with a simple command (pkg_add) by those who do not wish to compile their own ports from source. " Might want to mention that it is usually not necessary to compile from source, and using pkg_add is usually preferred. Then again, that may be more detail than is appropriate on this page. http://www.freebsd.org/handbook/install.html "If you plan on installing via anonymous FTP then the installation floppies are all you need to download and create" would be improved if phrased as "If you plan to install via anonymous FTP then the installation floppies are all you need to download and create" (i.e. change "on installing" to "to install"). (same page, i.e. http://www.freebsd.org/handbook/install.html) I think that the introductory material for Chapter 2 (i.e. everthing on this page before the start of section 2.1) has grown to be not introductory. It seems to me that most of it actually belongs in Section 2.2, "Preparing for the Installation". >How-To-Repeat: Read referenced web pages. >Fix: As described, if deemed appropriate. If you're happy then I'm happy. >Release-Note: >Audit-Trail: Responsible-Changed-From-To: freebsd-doc->jim Responsible-Changed-By: jim Responsible-Changed-When: Mon Jan 10 22:20:04 PST 2000 Responsible-Changed-Why: I'll take this. State-Changed-From-To: open->closed State-Changed-By: jim State-Changed-When: Wed Jan 12 16:09:37 PST 2000 State-Changed-Why: Fixes committed, thanks! >Unformatted: