From owner-freebsd-doc@freebsd.org Wed Jul 20 22:33:57 2016 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 787FCBA0380 for ; Wed, 20 Jul 2016 22:33:57 +0000 (UTC) (envelope-from gkirouac@myriade.ca) Received: from smtpsvr01.riq.net (smtpsvr01.riq.net [204.19.44.14]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 598BE11EF for ; Wed, 20 Jul 2016 22:33:57 +0000 (UTC) (envelope-from gkirouac@myriade.ca) Received: from smtpsvr01.riq.net (localhost [127.0.0.1]) by smtpsvr01.riq.net (Postfix) with ESMTP id BDC2410065E for ; Wed, 20 Jul 2016 18:33:49 -0400 (EDT) Received: from [192.168.1.7] (modemcable091.71-163-184.mc.videotron.ca [184.163.71.91]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtpsvr01.riq.net (Postfix) with ESMTPSA id 7DEC0100069 for ; Wed, 20 Jul 2016 18:33:49 -0400 (EDT) To: freebsd-doc@freebsd.org From: Gilles Kirouac Subject: Handbook typos Message-ID: <52c0efef-c0e1-005f-5b96-ceec079ae5dc@myriade.ca> Date: Wed, 20 Jul 2016 18:33:49 -0400 User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.1.1 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV using ClamSMTP X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 20 Jul 2016 22:33:57 -0000 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.