en_US.ISO8859-1/htdocs/docproj/handbook3.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
"http://www.FreeBSD.org/XML/doc/share/sgml/xhtml10-freebsd.dtd" [
<!ENTITY title "FreeBSD Documentation Project: Handbook 3rd Edition">

<!ENTITY done "<font xmlns='http://www.w3.org/1999/xhtml' color='green'>Done</font>">
<!ENTITY inprogress "<font xmlns='http://www.w3.org/1999/xhtml' color='blue'>In Progress</font>">
<!ENTITY notstarted "<font xmlns='http://www.w3.org/1999/xhtml' color='red'>Not Started</font>">
]>

<html xmlns="http://www.w3.org/1999/xhtml">
    <head>
      <title>&title;</title>

      <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
    </head>

    <body class="navinclude.docs">

   <h1>FreeBSD Handbook 3rd Edition</h1>

   <p>The 3rd Edition FreeBSD Handbook will be published in two
     volumes, each over 400 pages.  Volume I (User Guide) will cover
     the basics, while Volume II (Administrator's Guide) will cover
     system administration and more advanced topics.</p>

   <p>If you would like to get involved with the production of this
     edition, please send email to the -doc mailing list.  Thanks!</p>

<table class="tblbasic">
<tr><th>Task</th><th>Responsible</th><th>Last updated</th><th>Status</th></tr>
<tr>
  <td>Create new callout images for the numbers 1 - 25 as the default images with the DocBook stylesheets only go from 1-9 and then fall back on text numbers.  This looks bad when we have more than 9 callouts in the text, such as the Security Advisories section of the Security chapter.  Update: Numbers up to 15 added from DocBook CVS.</td>
  <td>&a.murray;</td>
  <td>July 12, 2004</td>
  <td>&done;</td>
</tr>

<tr>
  <td>Rewrite firewall section to cover pf, ipf and ipfw.</td>
  <td>&a.trhodes;</td>
  <td>July 22, 2004</td>
  <td>&inprogress;</td>
</tr>

<tr>
  <td>Write a proper synopsis for the Vinum chapter.</td>
  <td>&a.ceri;, via a patch from Kevin Kinsey</td>
  <td>July 29, 2004</td>
  <td>&done;</td>
</tr>

<tr>
  <td>Advanced Network Chapter is almost 100 pages and should be split up.  Update: new Network Servers chapter split off separately.</td>
  <td>&a.murray;</td>
  <td>July 13, 2004</td>
  <td>&done;</td>
</tr>

<tr>
  <td>Review recently added HTTP Server section.</td>
  <td>--</td>
  <td>July 20, 2004</td>
  <td>&notstarted;</td>
</tr>

<tr>
  <td>Review recently added FTP Server section.</td>
  <td>--</td>
  <td>July 20, 2004</td>
  <td>&notstarted;</td>
</tr>

<tr>
  <td>Add information about setting up a secure web server to the
    Apache section.  Generating the certificate, getting the
    certificate signed, etc..</td>
  <td>&a.murray;</td>
  <td>July 20, 2004</td>
  <td>&notstarted;</td>
</tr>

<tr>
  <td>Add a section about running a Windows file server with Samba to Network Servers chapter.</td>
  <td>--</td>
  <td>July 20, 2004</td>
  <td>&notstarted;</td>
</tr>

<tr>
  <td>Update the DHCP section of the Network Servers chapter to describe omshell and recent DHCP 3.X features now in the base system.  UPDATE: omshell is pretty technical and I don't think we really need to get into it in the Handbook?  Thoughts?</td>
  <td> --</td>
  <td>July 13, 2004</td>
  <td>&inprogress;</td>
</tr>

<tr>
  <td>Information about running an FTP server should be added to the Network Servers chapter.</td>
  <td> &a.murray; </td>
  <td>July 21, 2004</td>
  <td>&done;</td>
</tr>

<tr>
  <td>Add a type attribute to localhost URLs so that these can be
  omitted from the printed output.</td>
  <td>&a.murray;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>

<tr>
  <td>Add &lt;colspecs&gt; to tables as necessary to enhance the print output.</td>
  <td>&a.murray;</td>
  <td>May 18, 2003</td>
  <td>&inprogress;</td>
</tr>
<tr>
  <td>Remove all ASCII artwork</td>
  <td>&a.murray;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Update chapter on using modern versions of GNOME</td>
  <td>&a.marcus;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Fix cross-referencing tags to look better in the print
  output.</td>
  <td>&a.murray;</td>
  <td>May 18, 2003</td>
  <td>&inprogress;</td>
</tr>
<tr>
  <td>Standardize spelling of technical terms</td>
  <td>&a.trhodes;</td>
  <td>May 18, 2003</td>
  <td>&inprogress;</td>
</tr>
<tr>
  <td>Make sure all filenames, commands, applications, hostnames, etc
  are marked up properly</td>
  <td>&a.blackend;</td>
  <td>May 18, 2003</td>
  <td>&inprogress;</td>
</tr>
<tr>
  <td>Update appendix of contributing authors.</td>
  <td>&a.chern;</td>
  <td>July 20, 2004</td>
  <td>&inprogress;</td>
</tr>
<tr>
  <td>Update PPP/SLIP chapter</td>
  <td>&a.trhodes;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Clean up the IPSec section</td>
  <td>&a.hmp;, &a.chern;</td>
  <td>October 26, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Add simple illustrations at the beginning of each Part.</td>
  <td>&nbsp;</td>
  <td>May 18, 2003</td>
  <td>&notstarted;</td>
</tr>
<tr>
  <td>Add admonition graphics for Note, Caution, Warning, Tip.</td>
  <td>&a.hrs;</td>
  <td>May 18, 2003</td>
  <td>&inprogress;</td>
</tr>
<tr>
  <td>Design the cover.</td>
  <td>Ben Hansen</td>
  <td>July 20, 2004</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Update content in introduction chapter for post 5.0 world.</td>
  <td>&nbsp;</td>
  <td>May 18, 2003</td>
  <td>&notstarted;</td>
</tr>
<tr>
  <td>Make front matter look better</td>
  <td>&a.murray;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td><strong>Review the book for grammatical errors.</strong></td>
  <td>Everyone!</td>
  <td>May 18, 2003</td>
  <td>&inprogress;</td>
</tr>
<tr>
  <td>Implement automated spellchecker for entire Handbook.  Chern
  wrote some Tcl scripts and posted them to doc@ around the time of
  the second edition work.  This could be a starting point.</td>
  <td>&nbsp;</td>
  <td>May 18, 2003</td>
  <td>&notstarted;</td>
</tr>
<tr>
  <td>Make sure all section titles are capitalized properly</td>
  <td>&a.ceri;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Remove gratuitous Q/A sections in favor of more formal
  text. (see the end of the ports/packages chapter)</td>
  <td>&a.trhodes;</td>
  <td>May 18, 2003</td>
  <td>&inprogress;</td>
</tr>
<tr>
  <td>Add more information about ACPI.</td>
  <td>&a.trhodes; and &a.njl;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Add information about Kerberos5 and adjust Kerberos4 information
  accordingly.</td>
  <td>&a.trhodes;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Update Preface.</td>
  <td>&a.murray;</td>
  <td>July 20, 2004</td>
  <td>&inprogress;</td>
</tr>
<tr>
  <td>Update bibliography with newer editions, etc.</td>
  <td>&nbsp;</td>
  <td>May 18, 2003</td>
  <td>&notstarted;</td>
</tr>
<tr>
  <td>Add more indexterms throughout the book.  Reorganize some
  existing indexterms.  See the "make indexcheck" functionality for
  help finding areas of the book where indexterms are sparse.</td>
  <td>&nbsp;</td>
  <td>May 18, 2003</td>
  <td>&notstarted;</td>
</tr>
<tr>
  <td>Write an introduction for the Serial Communications chapter
  (note the big "XXX - Write me!" comment).  The current Synopsis can
  probably be adapted for this.</td>
  <td>&nbsp;</td>
  <td>May 19, 2003</td>
  <td>&notstarted;</td>
</tr>
<tr>
  <td>The Mini-Cartridge section in the disks chapter still needs to
  be written.  Update: section removed.</td>
  <td>&a.murray;</td>
  <td>July 20, 2004</td>
  <td>&done;</td>
</tr>

<tr>
  <td>Add information about network configuration to the install chapter.</td>
  <td>&a.trhodes;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Add some documentation on cron(8).</td>
  <td>&a.trhodes;</td>
  <td>May 18, 2003</td>
  <td>&done;</td>
</tr>
<tr>
  <td>Fill undefined glossary terms.</td>
  <td>Everyone!</td>
  <td>August 16, 2004</td>
  <td>&notstarted;</td>
</tr>
<tr>
  <td>Send everything to the printer.</td>
  <td>&a.murray;</td>
  <td>&nbsp;</td>
  <td>&notstarted;</td>
</tr>
</table>


</body>
</html>