Bug 16050 - Misc. typos etc. from Handbook
Summary: Misc. typos etc. from Handbook
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: Jim Mock
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2000-01-11 05:50 UTC by bobj
Modified: 2000-01-13 00:10 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description bobj 2000-01-11 05:50:00 UTC
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".

Fix: 

As described, if deemed appropriate.  If you're happy then I'm happy.
How-To-Repeat: Read referenced web pages.
Comment 1 Jim Mock freebsd_committer freebsd_triage 2000-01-11 06:20:04 UTC
Responsible Changed
From-To: freebsd-doc->jim

I'll take this. 
Comment 2 Jim Mock freebsd_committer freebsd_triage 2000-01-13 00:09:37 UTC
State Changed
From-To: open->closed

Fixes committed, thanks!