From owner-freebsd-doc@FreeBSD.ORG Tue Aug 17 15:27:51 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0BCF816A4CE for ; Tue, 17 Aug 2004 15:27:51 +0000 (GMT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [222.146.51.150]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9EA8743D2D for ; Tue, 17 Aug 2004 15:27:50 +0000 (GMT) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p62199-adsao12honb4-acca.tokyo.ocn.ne.jp [220.96.144.199]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id ABB261A79 for ; Wed, 18 Aug 2004 00:27:49 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) by delta.allbsd.org (8.12.9p2/8.12.9) with ESMTP id i7HFRTA2018041 for ; Wed, 18 Aug 2004 00:27:30 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Wed, 18 Aug 2004 00:25:04 +0900 (JST) Message-Id: <20040818.002504.07648782.hrs@eos.ocn.ne.jp> To: doc@FreeBSD.org From: Hiroki Sato X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 4.0.65 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Wed_Aug_18_00_25_04_2004_580)--" Content-Transfer-Encoding: 7bit Subject: TODO items for 5.3R X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Aug 2004 15:27:51 -0000 ----Security_Multipart(Wed_Aug_18_00_25_04_2004_580)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi all, As you know, src/ tree is now frozen and we are working for making 5.3R as good as we can. Here are our TODO items for doc for the moment: - sound(4) related manual pages The snd(4) and pcm(4) drivers has been renamed but their manual pages are still old. Probably sound(4) have to be added and pcm(4), csa(4), gusc(4), sbc(4), and uaudio(4) should be revised. Other manual pages which refer to pcm(4) (if any) should possibly be revised, too. In addition, we need to update section of the supported card. In FDP docs, pcm(4) appears in books/handbook/multimedia, books/faq/book.sgml, and so on. So, some sort of additional explanation and rewrite are needed. blackend@ is now working on rewriting sections of sound card and video playback in books/handbook/multimedia. - Early Adopter's Guide Xin LI pointed out that FreeBSD 5.3-RELEASE is the first stable release on 5.X and it is (hopefully) not for early adopters. Early Adopter's Guide is still useful, but contains a bit old information. I suggest to rewrite some parts of it and publish it as "4.X to 5.X Migration Guide", which focuses difference between 4.X and 5.X. - Hardware Notes simon@ recently committed a script for automatically generated hardware notes, and he is working on trimming entries in the old hardware notes and adding them into foo(4) manual pages. This should be finished as much as we can. - Installation Notes Some parts are outdated. doc/70485 has been committed, but more work is needed to reflect the realities. bmah@ pointed out that we should have "quick-start" installation guide for each platform instead of the current ones because they become too long and difficult to be maintained. - "5.X" will be -STABLE We think 5.X is the mainstream now, so sentences like "if you are using 5.X..." have to be removed, and "if you are using 4.X..." should be added instead. And although I am not sure if sections for Kerberos 4 and Vinum are reasonably applicable to 5.X, they should possibly be revised. - X.org The handbook includes a section "The X Window System," but this is mainly for XFree86. Although the difference is not so large from the point of view of configuration, we should mention both of X.org and XFree86. - rc.d scripts Ch.11.4 and 11.5 of the handbook must be updated to mention the new rc.d scripts and some ports use /etc/rc.conf for their configuration. - kernel configuration section and IPsec section Ch.8 and Ch.14.10 of the handbook must be updated since some parts are outdated. Yes, I know some PRs have already been submitted for these items, but I would like to clarify what we have to do here. I am looking into the PR database and sorting them now. Comments? If you have other additional items and/or comments, please let me know. Anyway, we need more of volunteers to work on them. If you are interested, please submit your patch/suggestion to doc@FreeBSD.org via send-pr. Thanks. -- | Hiroki SATO ----Security_Multipart(Wed_Aug_18_00_25_04_2004_580)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQBBIiNSTyzT2CeTzy0RAr9LAKDaAzsE5t5fwDSYT55Hhyqh8VRObwCghlHb MDsinfMqJMnGSlvBOOSadPc= =v8Jz -----END PGP SIGNATURE----- ----Security_Multipart(Wed_Aug_18_00_25_04_2004_580)----