Discussion:
Handbook typos
(too old to reply)
Gilles Kirouac
2016-07-20 22:33:49 UTC
Permalink
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.
Warren Block
2016-07-21 00:35:22 UTC
Permalink
Post by Gilles Kirouac
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
# 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
% mount -t msdosfs -o -m=644,-M=755 /dev/da0s1 /mnt/ username
% umount /mnt/ username
After device removal, the system message bu er will show messages similar to
=========
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.
Post by Gilles Kirouac
While copying/pasting, I also found that there is a non ascii character after
"with a FAT", in the words "first" and "buffer".
/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
Loading...