From owner-freebsd-doc Mon Dec 16 20:24:23 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1460937B4D3; Mon, 16 Dec 2002 20:24:20 -0800 (PST) Received: from vectors.cx (manifold.vectors.cx [64.163.147.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7B28A43EA9; Mon, 16 Dec 2002 20:24:20 -0800 (PST) (envelope-from monkey@vectors.cx) Received: from vectors.cx (ab97535e8ced0bb36e6c214fc6e6aac9@localhost [127.0.0.1]) by vectors.cx (8.12.6/8.12.4) with ESMTP id gBH4QGfC019611; Mon, 16 Dec 2002 20:26:16 -0800 (PST) (envelope-from monkey@vectors.cx) Received: (from monkey@localhost) by vectors.cx (8.12.6/8.12.6/Submit) id gBH4QGEO019607; Mon, 16 Dec 2002 20:26:16 -0800 (PST) (envelope-from monkey) Date: Mon, 16 Dec 2002 20:26:16 -0800 From: Adam Weinberger To: Warren Block Cc: "Gary W. Swearingen" , Giorgos Keramidas , doc@FreeBSD.ORG Subject: Re: issues with fdp-primer book Message-ID: <20021217042616.GU311@vectors.cx> References: <7lof7lhirh.f7l@localhost.localdomain> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii; x-action=pgp-signed Content-Disposition: inline In-Reply-To: X-Editor: Vim 6.1 http://www.vim.org X-Mailer: Mutt 1.5 http://www.mutt.org X-PGP-Key: http://www.vectors.cx/pgp.key.txt X-URL: http://www.vectors.cx http://www.crackula.com User-Agent: Mutt/1.5.1i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 >> (12.16.2002 @ 1548 PST): Warren Block said, in 0.9K: << > The FDP primer warns about unnecessary repetition: don't say "the ls > command", say "ls". So... why not just make this: > > "PostScript and PDF output require TeX." >> end of "Re: issues with fdp-primer book" from Warren Block << Right. That's what I said awhile ago. There is so much passive voice in the fbsd documentation... passive voices and extraneous clauses. Make the verb active. Eliminate the clause. "TeX is required to make PDF and PostScript output work" is a lot more confusing, and wordy, than "PostScript and PDF output require TeX." # Adam - -- Adam Weinberger vectors.cx >> adam@vectors.cx FreeBSD.org << adamw@FreeBSD.ORG Bayer Berkeley >> adam.weinberger.b@bayer.com #vim:set ts=8: 8-char tabs prevent tooth decay. -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE9/qdoo8KM2ULHQ/0RAneKAJ9Aaaiqgrabi3ZEbJNfiGCpB0DwgQCZAVQT C26AqMLrrEnVrDVvQZP4HCE= =4SLu -----END PGP SIGNATURE----- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message