From owner-freebsd-doc Thu May 31 5: 5:33 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ezwv.com (hermes.ezwv.com [208.163.10.16]) by hub.freebsd.org (Postfix) with ESMTP id C4CC637B42C; Thu, 31 May 2001 04:41:28 -0700 (PDT) (envelope-from rpratt@ezwv.com) Received: from k6-2.weeble.com (ip206102033126.dlup.ezwv.com [206.102.33.126]) by mail.ezwv.com (8.9.3/8.9.3) with SMTP id HAA04794; Thu, 31 May 2001 07:41:27 -0400 Content-Type: text/plain; charset="iso-8859-1" From: Randy Pratt To: bmah@FreeBSD.ORG Subject: Re: Illustrated Installation Guide Date: Thu, 31 May 2001 07:42:18 -0400 X-Mailer: KMail [version 1.2] References: <01053012311102.00379@k6-2.weeble.com> <200105301918.f4UJIr277909@bmah-freebsd-0.cisco.com> In-Reply-To: <200105301918.f4UJIr277909@bmah-freebsd-0.cisco.com> MIME-Version: 1.0 Message-Id: <01053022065804.00379@k6-2.weeble.com> Content-Transfer-Encoding: 8bit Cc: Nik Clayton , Murray Stokely , freebsd-doc@FreeBSD.ORG 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 On Wednesday 30 May 2001 15:18, you wrote: > If memory serves me right, Randy Pratt wrote: > > I finished the first pass of the installation guide in sgml format. Since > > this is my first attempt, I'm sure there's still work that needs to be > > done (sgml and content). > > Nicely done sir! > > Hope you don't mind a couple nitpicks: I appreciate the nitpicks...after all, I need to learn to use things right. > 1. You used elements in a few places where it's not > quite appropriate (look for the first couple or three times this gets > used). Told you this was a nitpik. Absolutely. I forgot to go back and fix those after I found keycap's intended use for _keys_ that are pressed on the keyboard. > 2. There's a few places where you refer to programs such as ifconfig, > et al. Usually we use &man entities for this (so ifconfig would be > written &man.ifconfig.8;). This makes hyperlinks to HTML-ized manpages > work. Hmm.. I used &man.moused.8 in Chapter 22. Mouse Settings and shows up as "moused(8)" but not as a hyperlink. Perhaps I have something else amiss locally. > Don't know if you have tried this yet, but I thought the PDF version of > your file looked pretty nifty too.... > > % make FORMATS=pdf > % acroread book.pdf Excellent. I didn't install JadeTeX and teTeX since I was installing docproj via ftp. I'll pick that up when the cd's arrive. > I personally would love to see this document replace the installation > guide in RELNOTESng. About the only thing that it has that your preview > does not is how one goes about actually obtaining the distribution. In > any case, we ought to have more pointers to your document. I've also been slacking on publicizing the document. There's a myriad of links across the web to its present location but that's easily changed. The documents should be where they do potential new users the most good. Randy To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message