Handbook typos

Gilles Kirouac gkirouac at myriade.ca
Wed Jul 20 22:33:57 UTC 2016


Dear writer

About the FreeBSD Handbook
Revision: 48895

Here is a quotation of paragr 17.4.1 p 308

=========
user as  /mnt/username . In the following example, replace  username 
with the login name of the user and  usergroup
with the user's primary group:
# mkdir /mnt/ username
# chown username :usergroup  /mnt/username
Suppose a USB thumbdrive is plugged in, and a device  /dev/da0s1 
appears. If the device is formatted with a FAT
le system, the user can mount it using:
% mount -t msdosfs -o -m=644,-M=755 /dev/da0s1 /mnt/ username
Before the device can be unplugged, it must be unmounted first:
% umount /mnt/ username
After device removal, the system message bu er will show messages 
similar to the following:
=========

There are three occurrences of an invalid space (I think) after /mnt/:
the first # line
both % lines

Right?

While copying/pasting, I also found that there is a non ascii character 
after "with a FAT", in the words "first" and "buffer".


Is the blank intended in 19.4.2:
   /dev/zvol/ poolname/dataset


Good work!

Gilles Kirouac, Quebec, Qc

P.S. I am new to Freebsd. I like the Handbook, because it seems 
up-to-date and strikes a balance between too little and too many 
details. However it is always good to expose concepts first. For 
instance, in zfs, what is a dataset? I had to scan the book to 
understand and still... For now I assume that it is something created 
with zfs create. But many datasets appear created by the install 
procedure. So it is not so clearcut. Not before 19.8 are ZFS features 
exposed in a rather reference format. I would hope that the definition 
of pool, vdev, dataset be more clearly exposed early in the chapter.


More information about the freebsd-doc mailing list