From owner-freebsd-doc@FreeBSD.ORG Mon Mar 14 09:53:46 2005 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 BB38116A508 for ; Mon, 14 Mar 2005 09:53:46 +0000 (GMT) Received: from mail.allbsd.org (vlsi00.si.noda.tus.ac.jp [133.31.130.32]) by mx1.FreeBSD.org (Postfix) with ESMTP id 07AFE43D1D for ; Mon, 14 Mar 2005 09:53:46 +0000 (GMT) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p11053-adsau14honb8-acca.tokyo.ocn.ne.jp [220.106.47.53]) (authenticated bits=128) by mail.allbsd.org (8.13.1/8.13.1) with ESMTP id j2E9rhQc096672 for ; Mon, 14 Mar 2005 18:53:44 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (alph.allbsd.org [192.168.0.10]) by delta.allbsd.org (8.13.1/8.13.1) with ESMTP id j2E9rCPv009280 for ; Mon, 14 Mar 2005 18:53:12 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Mon, 14 Mar 2005 18:45:19 +0900 (JST) Message-Id: <20050314.184519.37599579.hrs@allbsd.org> 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.2 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(Mon_Mar_14_18_45_19_2005_246)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV 0.83/762/Mon Mar 14 08:35:33 2005 on gatekeeper.allbsd.org X-Virus-Status: Clean Subject: 5.4R TODO 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: Mon, 14 Mar 2005 09:53:47 -0000 ----Security_Multipart(Mon_Mar_14_18_45_19_2005_246)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi all, Although we have about 10 days only until the doc slush begins, I am considering sorting out the doc-related TODO items for 5.4R. The attached TODO list includes both of required and desired items. Any volunteers for these? -- | Hiroki SATO ---(begin here) - Manual page update * missing manual pages We need the following manual pages: gvinum(8) sx(4) drivers in the acpi_support directory: acpi_asus(4), acpi_ibm(4), acpi_panasonic(4) acpi_sony(4), and acpi_toshiba(4). * RFC derived manual page fix The following manual pages have to be MFC'd: gai_strerror(3) getaddrinfo(3) getnameinfo(3) inet6_opt_init(3) inet6_option_space(3) inet6_rth_space(3) inet6_rthdr_space(3) icmp6(4) ip6(4) * sound(4) related manual page fix sound(4), pcm(4), snd(4), and snd_*(4) drivers are still obscure to the users. They will not be simplified (unifying them to snd(4) and snd_*(4) drivers, for example) in 5.x, so some rewording of the manual pages which say "this ambiguity in the naming will be fixed soon" is needed and some explanation should be added into the handbook. - Migration Guide update The FreeBSD Migration Guide should be updated to reflect the reality of 5.4-RELEASE. I personally think this document is still needed because the number of people who will try to upgrade their boxes from 4.11R to 5.4R is not small since some review articles on the net have said "5.3-RELEASE is unstable". - IPv6 documentation prefix APNIC recommends use of IPv6 documentation prefix (2001:0db8::/32) in technical books, articles, and training material. Rewriting IPv6 addresses in our docs is needed similarly to example.{org,net,com} sample domain names. seealso: RFC 3849 http://www.apnic.net/info/faq/ipv6-documentation-prefix-faq.html - Handbook update * disk partitioning and the related utilities The section 16.3 "adding disks" includes some descriptions on disk partitions, fdisk, disklabel, and so on. However, it seems to assume i386 platform and 4.x and early 5.x releases (for example, we do not have the fdisk program on FreeBSD/sparc64). It needs more detailed explanations. * vinum(4) subsystem vinum(4) subsystem is likely to be replaced with GEOM based version, but we have both of them as well as gvinum(8) and vinum(8) userland utilities now. Some rewriting is needed in the section 17.7, 17.8, and 17.9, for example. * ntpd(8) program Some descriptions in the section 23.11 are a bit outdated. The rc.d/ntpd script is now the recommended way to start the server, and driftfile directive in the ntp.conf(5) is already specified as an command line option in $ntpd_flags by default in 5.x. * Kerberos IV and Kerberos 5 We can probably remove (or mark as obsolete) Kerberos IV in the section 14.8 because it is deprecated and encouraged not to use due to security issue. * IPsec The section 14.10 is based on 4.x and needs to be revised. * GBDE The description in the handbook (the section 16.15) is outdated. Specifically, a sample fstab(5) file and some description of $gdbe_swap_enable in rc.conf(5) are needed. * other GEOM-based userland utilities We need how-to document about geom(8), gmirror(8), gstripe(8), and graid3(8). ----(end here) ----Security_Multipart(Mon_Mar_14_18_45_19_2005_246)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.0 (FreeBSD) iD8DBQBCNV0vTyzT2CeTzy0RAo+7AJ9oEalgBe5MHDLUU5ogQSlJu7LFTgCfcrqX 1Ngg4xhTp6XWkE0Vvm5PPyo= =ljFh -----END PGP SIGNATURE----- ----Security_Multipart(Mon_Mar_14_18_45_19_2005_246)----