Handbook typos

[Warren Block]

On Wed, 20 Jul 2016, Gilles Kirouac wrote:

> 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?

Well, not in the HTML version.  Are you looking at HTML, PDF, or some 
other output format?

The conversion from one format to another might introduce artifacts like 
extra spaces or other characters.

> 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.

Many of the ZFS terms are defined at the end of the ZFS chapter:
https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/zfs-term.html