<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!-- Hey, emacs!  Edit this file in -*- html-fill -*- mode! -->
<!-- This file was generated by make.  Do not edit -->
<!-- $Id: dear-reviewer-1,v 2.3 2002/04/07 01:28:22 grog Exp grog $ -->

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta name="generator" content="HTML Tidy, see www.w3.org" />

    <title>Review chapters of ``The Complete FreeBSD'', fourth edition</title>
  </head>

  <body>
    <h1>Review chapters of ``The Complete FreeBSD'', fourth edition</h1>
    <!-- page body -->

    <center>
      <font size="-1">Last update: Sun Dec 29 03:03:06 UTC 2002 <!-- -*- html-fill -*- -->
       <!-- $Id: dear-reviewer-1a,v 1.2 2002/04/14 05:08:39 grog Exp $ -->
      </font>
    </center>

    <p>
    This directory contains draft files for the upcoming fourth edition of ``The Complete
    FreeBSD''. This is not freely available information. You should not be here unless you are a
    reviewer.</p>

    <p>
    If you are a reviewer, please:</p>

    <ul>
      <li>
      respect the confidentiality of this site. Don't give the URL to anybody else.</li>

      <li>
        <p>
        use the texts only for review purposes. Assuming reasonable review feedback, you'll get
        a free copy of the book on publication, so there's no need to keep the drafts unless you're
        an incurable packrat.</p>
      </li>

      <li>
        <p>
        review! The chapters you should be looking at are shown as ``review draft'' in the <a
        href="STATUS.txt">status</a> files included in this directory. I prefer feedback as
        comments in the .txt files.</p>
      </li>
    </ul>

    <p>If you are not a reviewer, please <a href="mailto:grog@lemis.com">
    contact me</a> and let me
    know that the cover has been broken. You, too, can be a reviewer! All you have to do is to
    contact me and promise to respect the conditions shown above.</p>

    <h2>Draft status</h2>
    The status indications in the <a href="STATUS.txt">status</a> file have approximately the
    following meanings: 

    <ul>
      <li>
      Draft: I'm working on it, but it's not done yet.</li>

      <li>
        <p>
        Review draft: I've worked on it, and I think it's good enough to look at now. The text
        may not be properly laid out yet (expect widows and orphans, maybe partial pages not
        intentionally left blank, and missing cross-references to other chapters), but the content
        should be correct. Complain if it isn't. Don't worry about the missing cross-references:
        I'll fix them at the very end. The formatter spits out error messages, so I won't miss
        one.</p>

        <p>
        Some of the chapters were marked ``review draft'' while the book was still targetted at
        4.x. They may need substantial changes for 5.x. If you see any such discrepancy, check the
        modification date of the chapter: if it's before, say, September 2002, don't worry too
        much.</p>
      </li>

      <li>
        <p>
        Final draft: It's been reviewed, I've applied comments by the reviewers, and I think
        it's ready to print. With the exception of some small format issues, it should look
        correct. The format issues relate to some bugs in my build environment which cause comments
        to get indented incorrectly. They'll be gone in the final book.</p>
      </li>

      <li>
        <p>
        4th edition: It's gone to print.</p>
      </li>
    </ul>

    <h2>How to submit feedback</h2>
    It's up to you how you submit feedback, but I find it easiest if you read the PDF version
    (since there could be format issues) and mark up the text version of the chapter. You can
    remove extraneous data if you want. Quote the text as in mail and add your own comments without
    quotes. For example: 
<pre>
&gt; Your mileage may vary.  During the review phase of an earlier edition of this
&gt; book, one of the reviewers stated that he was very happy with his machine,
&gt; which has a 486-33 processor, 16 MB main memory, and 1 MB memory on his
&gt; display board.  He said that it ran a lot faster than his Pentium 100 at work,
&gt; which ran Microsoft.  The moral: if your hardware doesn't measure up to the
&gt; recommended specification, don't be discouraged.  Try it out anyway.

I think you should add a paragraph stating that minimum system
requirements are very dependent *what* work you want to do.
</pre>

    <p>
    When sending feedback, please refer to the chapter title, not the chapter number: the latter
    may change between the time you review the chapter and the time I look at the review. Also,
    page numbers don't help very much, since they keep changing. Context is better.</p>

    <p>One thing that makes it <i>
    very</i> difficult is badly wrapped text, such as described at <a
    href="http://www.lemis.com/email/email-format.html">Internet mail: formats</a>. If you have to
    use an MUA which performs this kind of mutilation, it would be better to look for an
    alternative way to supply feedback.</p>

    <h2>How I handle your feedback</h2>
    You'll get feedback from me for everything you send in. If you don't, I've lost it. The trouble
    is, I won't look at your feedback immediately. It might take up to a month before I look at it:
    I'll look at it next time I look at the chapter. Don't wait the month, though: I might look at
    it very soon, and then your comments might come too late. 

    <h2>Files in this directory</h2>
    <a href="toc.pdf">Preface and table of contents in PDF format</a> 
    <br />
     <a href="toc.txt">Preface and table of contents in ASCII</a>
    <br />
    <br />
     

    <p><a href="introduction.pdf">
    Chapter 1 (introduction) in PDF format</a>
    <br />
     <a href="introduction.txt">Chapter 1 (introduction) in ASCII</a></p>

    <p><a href="concepts.pdf">
    Chapter 2 (concepts) in PDF format</a>
    <br />
     <a href="concepts.txt">Chapter 2 (concepts) in ASCII</a></p>

    <p><a href="evolution.pdf">
    Chapter 3 (evolution) in PDF format</a>
    <br />
     <a href="evolution.txt">Chapter 3 (evolution) in ASCII</a></p>

    <p><a href="quickinstall.pdf">
    Chapter 4 (quickinstall) in PDF format</a>
    <br />
     <a href="quickinstall.txt">Chapter 4 (quickinstall) in ASCII</a></p>

    <p><a href="shareinstall.pdf">
    Chapter 5 (shareinstall) in PDF format</a>
    <br />
     <a href="shareinstall.txt">Chapter 5 (shareinstall) in ASCII</a></p>

    <p><a href="install.pdf">
    Chapter 6 (install) in PDF format</a>
    <br />
     <a href="install.txt">Chapter 6 (install) in ASCII</a></p>

    <p><a href="postinstall.pdf">
    Chapter 7 (postinstall) in PDF format</a>
    <br />
     <a href="postinstall.txt">Chapter 7 (postinstall) in ASCII</a></p>

    <p><a href="desktop.pdf">
    Chapter 8 (desktop) in PDF format</a>
    <br />
     <a href="desktop.txt">Chapter 8 (desktop) in ASCII</a></p>

    <p><a href="unixref.pdf">
    Chapter 9 (unixref) in PDF format</a>
    <br />
     <a href="unixref.txt">Chapter 9 (unixref) in ASCII</a></p>

    <p><a href="ports.pdf">
    Chapter 10 (ports) in PDF format</a>
    <br />
     <a href="ports.txt">Chapter 10 (ports) in ASCII</a></p>

    <p><a href="extras.pdf">
    Chapter 11 (extras) in PDF format</a>
    <br />
     <a href="extras.txt">Chapter 11 (extras) in ASCII</a></p>

    <p><a href="netintro.pdf">
    Chapter 12 (netintro) in PDF format</a>
    <br />
     <a href="netintro.txt">Chapter 12 (netintro) in ASCII</a></p>

    <p><a href="netsetup.pdf">
    Chapter 13 (netsetup) in PDF format</a>
    <br />
     <a href="netsetup.txt">Chapter 13 (netsetup) in ASCII</a></p>

    <p><a href="isp.pdf">
    Chapter 14 (isp) in PDF format</a>
    <br />
     <a href="isp.txt">Chapter 14 (isp) in ASCII</a></p>

    <p><a href="modems.pdf">
    Chapter 15 (modems) in PDF format</a>
    <br />
     <a href="modems.txt">Chapter 15 (modems) in ASCII</a></p>

    <p><a href="ppp.pdf">
    Chapter 16 (ppp) in PDF format</a>
    <br />
     <a href="ppp.txt">Chapter 16 (ppp) in ASCII</a></p>

    <p><a href="dns.pdf">
    Chapter 17 (dns) in PDF format</a>
    <br />
     <a href="dns.txt">Chapter 17 (dns) in ASCII</a></p>

    <p><a href="firewall.pdf">
    Chapter 18 (firewall) in PDF format</a>
    <br />
     <a href="firewall.txt">Chapter 18 (firewall) in ASCII</a></p>

    <p><a href="netdebug.pdf">
    Chapter 19 (netdebug) in PDF format</a>
    <br />
     <a href="netdebug.txt">Chapter 19 (netdebug) in ASCII</a></p>

    <p><a href="netclient.pdf">
    Chapter 20 (netclient) in PDF format</a>
    <br />
     <a href="netclient.txt">Chapter 20 (netclient) in ASCII</a></p>

    <p><a href="netserver.pdf">
    Chapter 21 (netserver) in PDF format</a>
    <br />
     <a href="netserver.txt">Chapter 21 (netserver) in ASCII</a></p>

    <p><a href="mua.pdf">
    Chapter 22 (mua) in PDF format</a>
    <br />
     <a href="mua.txt">Chapter 22 (mua) in ASCII</a></p>

    <p><a href="mta.pdf">
    Chapter 23 (mta) in PDF format</a>
    <br />
     <a href="mta.txt">Chapter 23 (mta) in ASCII</a></p>

    <p><a href="xtheory.pdf">
    Chapter 24 (xtheory) in PDF format</a>
    <br />
     <a href="xtheory.txt">Chapter 24 (xtheory) in ASCII</a></p>

    <p><a href="starting.pdf">
    Chapter 25 (starting) in PDF format</a>
    <br />
     <a href="starting.txt">Chapter 25 (starting) in ASCII</a></p>

    <p><a href="configfiles.pdf">
    Chapter 26 (configfiles) in PDF format</a>
    <br />
     <a href="configfiles.txt">Chapter 26 (configfiles) in ASCII</a></p>

    <p><a href="filesys.pdf">
    Chapter 27 (filesys) in PDF format</a>
    <br />
     <a href="filesys.txt">Chapter 27 (filesys) in ASCII</a></p>

    <p><a href="disks.pdf">
    Chapter 28 (disks) in PDF format</a>
    <br />
     <a href="disks.txt">Chapter 28 (disks) in ASCII</a></p>

    <p><a href="vinum.pdf">
    Chapter 29 (vinum) in PDF format</a>
    <br />
     <a href="vinum.txt">Chapter 29 (vinum) in ASCII</a></p>

    <p><a href="burncd.pdf">
    Chapter 30 (burncd) in PDF format</a>
    <br />
     <a href="burncd.txt">Chapter 30 (burncd) in ASCII</a></p>

    <p><a href="tapes.pdf">
    Chapter 31 (tapes) in PDF format</a>
    <br />
     <a href="tapes.txt">Chapter 31 (tapes) in ASCII</a></p>

    <p><a href="printers.pdf">
    Chapter 32 (printers) in PDF format</a>
    <br />
     <a href="printers.txt">Chapter 32 (printers) in ASCII</a></p>

    <p><a href="current.pdf">
    Chapter 33 (current) in PDF format</a>
    <br />
     <a href="current.txt">Chapter 33 (current) in ASCII</a></p>

    <p><a href="upgrading.pdf">
    Chapter 34 (upgrading) in PDF format</a>
    <br />
     <a href="upgrading.txt">Chapter 34 (upgrading) in ASCII</a></p>

    <p><a href="building.pdf">
    Chapter 35 (building) in PDF format</a>
    <br />
     <a href="building.txt">Chapter 35 (building) in ASCII</a></p>

    <p><a href="emulate.pdf">
    Chapter 36 (emulate) in PDF format</a>
    <br />
     <a href="emulate.txt">Chapter 36 (emulate) in ASCII</a></p>
  </body>
</html>

