451 lines
14 KiB
Text
451 lines
14 KiB
Text
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" [
|
|
<!ENTITY base CDATA "..">
|
|
<!ENTITY date "$FreeBSD: www/en/docproj/current.sgml,v 1.56 2003/11/14 16:20:30 trhodes Exp $">
|
|
<!ENTITY stylesheet "&base;/projects/c99/style.css">
|
|
<!ENTITY title "FreeBSD Documentation Project: Current projects">
|
|
<!ENTITY % includes SYSTEM "../includes.sgml"> %includes;
|
|
<!ENTITY % developers SYSTEM "../developers.sgml"> %developers;
|
|
|
|
<!ENTITY imagebase "&base;/gifs">
|
|
|
|
<!-- Status levels -->
|
|
<!ENTITY status.blank " ">
|
|
<!ENTITY status.blocked "<img src='&imagebase;/blocked.png' width='22' height='22' alt='Blocked'>">
|
|
<!ENTITY status.done "<img src='&imagebase;/done.png' width='22' height='22' alt='Done'>">
|
|
<!ENTITY status.new "<img src='&imagebase;/not_started.png' width='22' height='22' alt='Not Started'>">
|
|
<!ENTITY status.n-a "<img src='&imagebase;/not_planned.png' width='22' height='22' alt='Not Planned'>">
|
|
<!ENTITY status.wip "<img src='&imagebase;/in_progress.png' width='22' height='22' alt='In progress'>">
|
|
]>
|
|
|
|
<html>
|
|
&header;
|
|
|
|
<p>Here are the projects currently under way (or being actively
|
|
contemplated on the freebsd-doc mailing list). I have also included some
|
|
that have not really been talked about, but would probably be a
|
|
good idea. Each project lists the contact person for that
|
|
project (if I know who it is).</p>
|
|
|
|
<p>If you think you can contribute to any of these, please do not
|
|
hesitate to stand up and be counted. You should talk to the
|
|
person responsible for that particular project, who can then bring you
|
|
up to speed on what is happening. If you have any ideas for a new
|
|
project then please email <a href="mailto:FreeBSD-doc@FreeBSD.org">
|
|
FreeBSD-doc@FreeBSD.org</a>.</p>
|
|
|
|
<ul>
|
|
<li><a href="#pr">Open documentation problem reports</a></li>
|
|
<li><a href="#handbook3">Handbook 3rd Printed Edition</a></li>
|
|
<li><a href="#handbook">Handbook 2nd Printed Edition (Completed)</a></li>
|
|
<li><a href="#freebsd4linux">FreeBSD for Linux users</a></li>
|
|
<li><a href="#handbooksection">Write a section in the Handbook and/or FAQ</a></li>
|
|
<li><a href="#newpapers">Write some new Papers</a></li>
|
|
<li><a href="#develbook">Write some chapters for the Developers Handbook</a></li>
|
|
<li><a href="#cgiscripts">CGI Scripts</a></li>
|
|
<li><a href="#multilingualwebscripts">Multilingual Web scripts</a></li>
|
|
<li><a href="#translations">Translations of the FreeBSD Documentation</a></li>
|
|
<li><a href="#search-enhancements">Search engine enhancements</a></li>
|
|
<li><a href="#tunables">Documenting the FreeBSD tunables</a></li>
|
|
<li><a href="#newkernelmanpages">Write section 9 manual pages</a></li>
|
|
<li><a href="#sec4manualpages">Write section 4 manual pages</a></li>
|
|
|
|
</ul>
|
|
|
|
<a name="pr"></a>
|
|
<h3><font color="#660000">Open documentation problem reports</font></h3>
|
|
|
|
<p>Current FreeBSD problems reports are tracked using the GNATS
|
|
database.
|
|
|
|
You can <a
|
|
href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=docs&responsible=.">view</a>
|
|
the open documentation problem reports.</p>
|
|
|
|
<a name="handbook3"></a>
|
|
<h3><font color="#660000">FreeBSD Handbook 3rd Edition</font></h3>
|
|
|
|
<p><b>Responsible:</b> Murray Stokely <<a
|
|
href="mailto:murray@FreeBSD.org">murray@FreeBSD.org</a>></p>
|
|
|
|
<p><b>Synopsis:</b> Work has begun to prepare the FreeBSD Handbook
|
|
for publication. See the complete <a href="handbook3.html">task
|
|
list</a> for information about how you can help.</p>
|
|
|
|
<a name="handbook"></a>
|
|
<h3><font color="#660000">FreeBSD Handbook 2nd Edition</font></h3>
|
|
|
|
<p><b>Responsible:</b> Murray Stokely <<a
|
|
href="mailto:murray@FreeBSD.org">murray@FreeBSD.org</a>></p>
|
|
|
|
<p><b>Synopsis:</b> This project is complete. The 2nd Edition
|
|
FreeBSD Handbook is available now from <a
|
|
href="http://www.freebsdmall.com">The FreeBSD Mall</a>. The
|
|
final manuscript is 653 pages, and the ISBN number is
|
|
1571763031. Thanks to everyone who contributed. Read the full
|
|
announcement <a
|
|
href="http://docs.freebsd.org/cgi/getmsg.cgi?fetch=0+0+archive/2001/freebsd-announce/20011028.freebsd-announce">here</a>.</p>
|
|
|
|
<p>The task list that we used during the development of this book
|
|
is still archived <a href="handbook.html">here</a> for
|
|
posterity.</p>
|
|
|
|
<a name="freebsd4linux"></a>
|
|
<h3><font color="#660000">FreeBSD for Linux users</font></h3>
|
|
|
|
<p><b>Responsible:</b> FreeBSD-doc
|
|
<<a href="mailto:FreeBSD-doc@FreeBSD.org">FreeBSD-doc@FreeBSD.org</a>></p>
|
|
|
|
<p><b>Synopsis:</b> Linux users coming to FreeBSD can be confused by
|
|
some of the differences between the systems (the different default
|
|
shells, how boot time configuration is performed, and so on).</p>
|
|
|
|
<a name="handbooksection"></a>
|
|
<h3><font color="#660000">Write a section in the Handbook and/or FAQ</font></h3>
|
|
|
|
<p><b>Responsible:</b> No one</p>
|
|
|
|
<p><b>Synopsis:</b> Chunks of the FAQ and Handbook have empty sections in
|
|
them. They need filling. If you have just had to use one of
|
|
these documents to complete a task, and found them lacking,
|
|
please find the time to write up your experiences as a
|
|
possible replacement.</p>
|
|
|
|
<p>Alternatively, if you have just had to do something that had no
|
|
entry in the FAQ and/or Handbook, please consider writing a
|
|
new section. Then submit it as outlined above.</p>
|
|
|
|
<a name="newpapers"></a>
|
|
<h3><font color="#660000">Write some new Papers</font></h3>
|
|
|
|
<h4><font color="#660000">The New SCSI layer for FreeBSD (CAM)</font></h4>
|
|
<p><b>Responsible:</b>
|
|
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>>,
|
|
<<a href="mailto:scsi@FreeBSD.org">scsi@FreeBSD.org</a>></p>
|
|
<p><b>Synopsis:</b> See <a href="http://www.FreeBSD.org/~gibbs/">
|
|
The Design and Implementation of the FreeBSD SCSI Subsystem</a>
|
|
for a first snapshot.</p>
|
|
|
|
<a name="develbook"></a>
|
|
<h3><font color="#660000">Write some chapters for the Developers Handbook</font></h3>
|
|
<p><b>Responsible:</b>
|
|
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>></p>
|
|
|
|
<p><b>Synopsis:</b></p>
|
|
<ul>
|
|
<li>The FreeBSD Developers Handbook is lacking in content, please help
|
|
us finish this book.</li>
|
|
</ul>
|
|
|
|
<a name="cgiscripts"></a>
|
|
<h3><font color="#660000">CGI Scripts</font></h3>
|
|
<p><b>Responsible:</b>
|
|
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>>,
|
|
Wolfram Schneider <<a href="mailto:wosch@FreeBSD.org">wosch@FreeBSD.org</a>></p>
|
|
|
|
<p><b>Synopsis:</b> Modify the CGI scripts url.cgi, ports.cgi,
|
|
pds.cgi and the script portindex to use the Perl <a
|
|
href="http://people.FreeBSD.org/~tom/portpm/">FreeBSD::Ports</a>
|
|
modules. These modules also need thorough testing.</p>
|
|
|
|
<a name="multilingualwebscripts"></a>
|
|
<h3><font color="#660000">Multilingual Web scripts</font></h3>
|
|
|
|
<p><b>Responsible:</b>
|
|
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>></p>
|
|
<p></p>
|
|
|
|
<p><b>Synopsis:</b></p>
|
|
|
|
<p>
|
|
Our main Web pages are written in (American) English. The <a
|
|
href="translations.html">FreeBSD Translations Projects</a>
|
|
translate the web pages, Handbook and FAQ to other languages.</p>
|
|
|
|
<p>
|
|
We must translate the cgi scripts and web build scripts too. The
|
|
scripts should support multiple languages, not only one.
|
|
Most scripts are written in perl.</p>
|
|
|
|
<ul>
|
|
<li>Merge the perl scripts <a
|
|
href="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/www/en/ports/portindex">www/en/ports/portindex</a>
|
|
and <a
|
|
href="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/www/ja/ports/portindex">www/ja/ports/portindex</a>
|
|
into one script. Add an option for English and Japanese output.
|
|
</li>
|
|
</ul>
|
|
|
|
|
|
<a name="translations"></a>
|
|
<h3><font color="#660000">Translations of the FreeBSD Documentation</font></h3>
|
|
<p><b>Responsible:</b>
|
|
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>></p>
|
|
<p>
|
|
Translate the FreeBSD documentation (Web pages, FAQ,
|
|
Handbook, Manual pages) into other languages. See the
|
|
<a href="translations.html">FreeBSD translations projects</a></p>
|
|
|
|
<a name="search-enhancements"></a>
|
|
<h3><font color="#660000">Search engine enhancements</font></h3>
|
|
<p><b>Responsible:</b>Eric Anderson <<a href="mailto:anderson@centtech.com">anderson@centtech.com</a>></p>
|
|
|
|
<p>When searching the website, the output from the search engine includes
|
|
the filename that was found, which might be something like
|
|
<tt>FAQ34.html</tt>.</p>
|
|
|
|
<p>It would be more useful if the results included the question text,
|
|
allowing the user to see whether or not the result was relevant.</p>
|
|
|
|
<a name="tunables"></a>
|
|
<h3><font color="#660000">Documenting FreeBSD Tunables.</font></h3>
|
|
<p><b>Responsible:</b>Tom Rhodes <<a href="mailto:trhodes@FreeBSD.org">trhodes@FreeBSD.org</a>></p>
|
|
|
|
<p>Many FreeBSD tunables are undocumented. Everyone knows how difficult
|
|
it can be to use an undocumented system, and thus this project was formed.
|
|
The initial goal here is to create a tool which can generate a manual page
|
|
with the tunables. Hence we need to generate this list from the source
|
|
code.</p>
|
|
|
|
<a name="newkernelmanpages"></a>
|
|
<h3><font color="#660000">Write section 9 manual pages</font></h3>
|
|
<p><b>Responsible:</b>
|
|
Tom Rhodes <<a href="mailto:trhodes@FreeBSD.org">trhodes@FreeBSD.org</a>>
|
|
and Hiten Pandya <<a href="mailto:hmp@FreeBSD.org">hmp@FreeBSD.org</a>></p>
|
|
<p><b>Synopsis:</b> Document kernel interfaces and functions.</p>
|
|
|
|
|
|
<a name="sec4manualpages"></a>
|
|
<h3><font color="#660000">Write section 4 manual pages</font></h3>
|
|
|
|
<p><b>Synopsis:</b> Write section 4 manual pages.</p>
|
|
|
|
<p>All drivers in FreeBSD should have a section 4 manual page,
|
|
but some does not yet.</p>
|
|
|
|
<table border="3" cellpadding="2" cellspacing="0" width="615">
|
|
<tr>
|
|
<th class="heading"> Task </th>
|
|
<th class="heading"> Description </th>
|
|
<th class="heading"> Responsible </th>
|
|
<th class="heading"> Last Updated </th>
|
|
<th class="heading"> Status </th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td colspan="5" class="section"> New section 4 manual pages </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> bs(4) </td>
|
|
<td> WD33C93 SCSI driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> cm(4) </td>
|
|
<td> SMC Arcnet network adapters</td>
|
|
<td> &a.trhodes; </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> ct(4) </td>
|
|
<td> WD33C93-based SCSI driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> ctx(4) </td>
|
|
<td> CORTEX-I Frame Grabber driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> emu10k1(4) </td>
|
|
<td> Soundblaster Pro driver</td>
|
|
<td> &a.trhodes;, &a.hmp;</td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.done; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> hea(4) </td>
|
|
<td> HARP ATM driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> hfa(4) </td>
|
|
<td> HARP ATM driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> idt(4) </td>
|
|
<td> NICStar ATM Adapter</td>
|
|
<td> &a.trhodes;, &a.bms; </td>
|
|
<td> 9 November 2003 </td>
|
|
<td> &status.done; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> ips(4) </td>
|
|
<td> IBM/Adaptec ServerRAID controller</td>
|
|
<td> &a.trhodes; </td>
|
|
<td> 11 November 2003 </td>
|
|
<td> &status.done; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> loran(4) </td>
|
|
<td> LORAN-C receiver driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> mss(4) </td>
|
|
<td> AD1848-compatible MSS/WSS driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> ncv(4) </td>
|
|
<td> NCR 53C500 SCSI driver (PC-98)</td>
|
|
<td> &a.trhodes; </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> nsp(4) </td>
|
|
<td> Workbit Ninja SCSI driver (PC-98)</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> nss(4) </td>
|
|
<td> NEC PC-98 sound support</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> ofwcons(4) </td>
|
|
<td> IEEE-1275 / Open Firmware</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> rc(4) </td>
|
|
<td> Riscom/8 audio driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> sab(4) </td>
|
|
<td> SAB82523 Dual UART driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> snc(4) </td>
|
|
<td> Nat. Semi. DP8393X NIC driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> spigot(4) </td>
|
|
<td> SPIGOT Video Capture driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> uaudio(4) </td>
|
|
<td> USB Audio driver</td>
|
|
<td> &a.hmp; </td>
|
|
<td> 10 November 2003 </td>
|
|
<td> &status.done; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> wdc(4) </td>
|
|
<td> </td>
|
|
<td> &a.rushani; </td>
|
|
<td> 8 November 2003 </td>
|
|
<td> &status.done; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> xrpu(4) </td>
|
|
<td> Xilinx FPGA/RPU driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td> zs(4) </td>
|
|
<td> Zilog UART driver</td>
|
|
<td> </td>
|
|
<td> 7 November 2003 </td>
|
|
<td> &status.new; </td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br><br>
|
|
|
|
<table border="3" cellpadding="2" cellspacing="0">
|
|
<tr>
|
|
<th colspan="2" class="heading">Legend</th>
|
|
<tr>
|
|
<td> &status.new; </td>
|
|
<td> Not yet started </td>
|
|
</tr><tr>
|
|
<td> &status.blocked; </td>
|
|
<td> Blocked awaiting completion of another task </td>
|
|
</tr><tr>
|
|
<td> &status.wip; </td>
|
|
<td> Work in progress </td>
|
|
</tr><tr>
|
|
<td> &status.done; </td>
|
|
<td> Task completed </td>
|
|
</tr><tr>
|
|
<td> &status.n-a; </td>
|
|
<td> Not planned </td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<p></p><a href="docproj.html">FreeBSD Documentation Project Home</a>
|
|
&footer
|
|
</body>
|
|
</html>
|