From owner-freebsd-doc Thu Oct 22 09:44:31 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id JAA19245 for freebsd-doc-outgoing; Thu, 22 Oct 1998 09:44:31 -0700 (PDT) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from pluto.plutotech.com (mail.plutotech.com [206.168.67.137]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id JAA19240 for ; Thu, 22 Oct 1998 09:44:29 -0700 (PDT) (envelope-from kelly@plutotech.com) Received: from plutotech.com (tampopo.plutotech.com [206.168.67.161]) by pluto.plutotech.com (8.8.7/8.8.5) with ESMTP id KAA20730; Thu, 22 Oct 1998 10:43:56 -0600 (MDT) Message-ID: <362F60C9.31DF0537@plutotech.com> Date: Thu, 22 Oct 1998 10:43:53 -0600 From: Sean Kelly Organization: Pluto Technologies X-Mailer: Mozilla 4.04 [en] (X11; I; FreeBSD 3.0-CURRENT i386) MIME-Version: 1.0 To: rneswold@mcs.net CC: doc@FreeBSD.ORG Subject: Re: New document available... References: <19981007231536.A17680@drmemory.fnal.gov> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > I've placed a document on the web to help new FreeBSD users. > ... > http://www.mcs.net/~rneswold/www/fbsd-init.html I like it! If others on the list haven't visited yet, do take a look. It feels just right as a technical document: it's not overly austere, yet not too informal, either. You've followed the rule of having text after every heading---something many software engineers don't understand. And you clearly know your way around Docbook. Would you also post the SGML source? That might help other people approach the DTD and start developing more documents. Some comments from my compulsive editing habits: ** In the Customizations section, check spelling of "dependant." ** In Increasing the number of lines/Just do it, refer to the figures directly, if you're going to use formal figures. If you're saying "the following...", then use informal, unnumbered figures. Both of these sections bring up an issue: maybe /etc/rc.i386 should set up these properties for all the vtys? In /etc/rc.conf, you can set the video mode, character size, and mouse properties, but they apply only to ttyv0. There might be a software fix for this, in this case. ** In Moving /tmp to Memory, another benefit of using MFS is the system performs better when you have processes using memory-mapped files in /tmp; changes to the memory-mapped file don't have to be backed out onto disk, since the file itself lives in a memory filesystem. Anyway, well done! Okay, so who's going to add a link to this document from the FreeBSD web pages? --Sean To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message