Date: Tue, 24 Jul 2012 18:00:01 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: doc@freebsd.org Subject: FDP and compound words Message-ID: <alpine.BSF.2.00.1207241758220.63105@wonkity.com>
next in thread | raw e-mail | index | archive | help
This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. ---902635197-1427711892-1343174311=:63105 Content-Type: TEXT/PLAIN; CHARSET=ISO-8859-15; format=flowed Content-Transfer-Encoding: 8BIT Content-ID: <alpine.BSF.2.00.1207241758371.63105@wonkity.com> The FDP word list at http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style-word-list.html specifies the formats for several words that are often used as a single compound word in our documentation. For example: file system disk label mail server name server web server Actually, I think the single-word versions of at least the first two are more correct. Some searching found this: http://en.wikipedia.org/wiki/Compound_noun_and_adjective There's an excellent example: "darkroom". A darkroom is a different thing than a dark room. To me, filesystem and disklabel are singular. A filesystem is a thing, a single object, while a file system is a group of files and directories. I'm sure there's a name for the difference between the single- and double-word versions, but don't know it. Many one-word versions are enshrined in code, like the use of "nameserver" in resolv.conf. I propose changing the FDP recommendations for the two-word versions above to the single-word versions. Statistics from SGML files in /usr/doc/en_US.ISO8859-1: 628 "file system", 513 "filesystem" 28 "disk label", 65 "disklabel" 50 "mail server", 3 "mailserver" 56 "name server", 21 "nameserver" 74 "web server", 13 "webserver" Some two-word instances separated by line breaks were probably missed. After the changes to the FDP, textproc/igor can be updated to detect the two-word versions. Note: no changes are planned to "cabaņa de bicicletas", "Fahrradraum", or "Fahrradschuppen". ---902635197-1427711892-1343174311=:63105--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.00.1207241758220.63105>