Date: Tue, 29 Jan 2013 09:34:39 -0500 From: Eitan Adler <eadler@freebsd.org> To: freebsd-doc@freebsd.org Subject: Fwd: More FAQ stuff (of varying significance) in Chapters 1 - 5 Message-ID: <CAF6rxgkW=_Zo1JRbXaEQ5yuAh4Ozg45VLj08tUD%2BDUJ2z6ZyPA@mail.gmail.com> In-Reply-To: <5104d0bc.6p6uM6F5A0GRngfz%perryh@pluto.rain.com> References: <5104d0bc.6p6uM6F5A0GRngfz%perryh@pluto.rain.com>
next in thread | previous in thread | raw e-mail | index | archive | help
With permission I forward this email. Can you please follow up with patches? I have about zero to negative time to deal with this. ---------- Forwarded message ---------- From: <perryh@pluto.rain.com> Date: 27 January 2013 02:01 Subject: More FAQ stuff (of varying significance) in Chapters 1 - 5 To: eadler@freebsd.org The beginning of the Introduction mentions Usenet. The ranks of those who have been around long enough to know what _that_ means are shrinking daily :) In the third bullet point of "1.8. What is FreeBSD-CURRENT?", Subversion feels as if it could stand to be linked somewhere (since some newcomers may not know what is). IIRC the mentions of "9.1-STABLE" in the second paragraph of "1.9. What is the FreeBSD-STABLE concept?" should be "9-STABLE". 1.8 says "Official snapshots are generated on a regular basis ..." 1.10 says they "are made daily". While both may be accurate, the contrast seems a bit odd. Not directly to do with the FAQ, but noticed at the end of Chapter 1: should "Writing FreeBSD Problem Reports" be incorporated into the Handbook to increase its visibility? 2.3 still mentions newsgroups. In the last paragraph of 2.4, "Each ... is" is incorrect since the word "each" is singular. Given the rest of the sentence, the easiest fix would be to drop "Each of" and write the sentence as "These channels are distinct ..." The first sentence of 3.16 looks odd: a _larger_ block size results in a _smaller_ theoretical filesystem size limit? I wonder if one of those "TB" might be the wrong unit. The last paragraph of 4.3.6 might mention whether pass is included in GENERIC. Better to remove "for a more complete list" from 4.5.1 since there's no list for the Hardware Notes to be more complete than. In 2. of the first numbered list in 5.2, -CURRENT should be capitalized. Doesn't this list need a "3. Faulty hardware." entry (and change "either" to "one of" in the line above the list)? In 1. of the second numbered list in 5.2, the close parenthesis should be after "other hardware" rather than at the end of the sentence. 5.3 might mention that GENERIC _is_ a debugging kernel (per 3.12). Re 5.4: dunno if we may by now have a tunable for VM_KMEM_SIZE_MAX (in which case one would not need to build a custom kernel). [If we don't, I'll look into adding one.] Should the second bullet of 5.8 mention that screen is a port (and thus not in the base distribution)? The last "sentence" (fragment) of the second paragraph of 5.11 should probably say "FreeBSD chose the one with the highest 'quality' value." 5.12 amounts to a duplicate of 3.8, which has more detailed instructions. -- Eitan Adler Source, Ports, Doc committer Bugmeister, Ports Security teams
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAF6rxgkW=_Zo1JRbXaEQ5yuAh4Ozg45VLj08tUD%2BDUJ2z6ZyPA>