Date: Thu, 22 Oct 1998 10:43:53 -0600 From: Sean Kelly <kelly@plutotech.com> To: rneswold@mcs.net Cc: doc@FreeBSD.ORG Subject: Re: New document available... Message-ID: <362F60C9.31DF0537@plutotech.com> References: <19981007231536.A17680@drmemory.fnal.gov>
next in thread | previous in thread | raw e-mail | index | archive | help
> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?362F60C9.31DF0537>