From: David Merrill <david@lupercalia.net> To: LDP Weekly News <news@linuxdoc.org>, Linux Weekly News <lwn@lwn.net>, Michael Hall <mhall@internet.com> Subject: LDPWN for 2002-01-15 Date: Tue, 15 Jan 2002 22:33:14 -0500 LDP Weekly News 2002-01-15 by David Merrill Online Editing, Wiki-style We are working to provide simple online editing functions for authors who desire to use it, something similar to a WikiWikiWeb. It won't have all the functionality that a true Wiki has, but it will provide tracking of recent changes and the ability to diff between versions as well as a diff from the authoritative cvs version. Because we have had feedback from authors who are concerned about having to learn something new, or having to track changes to two versions, the web interface will be completely optional at the request of the author. Authors who like using the cvs or mailing their updates by email may continue to do so as usual. I hope to have at least some minimal functionality to report in next week's LDPWN. Thanks go to Martin Wheeler for the original idea. Is It DocBook, Or Is It Text? A side project that came out of the original "Wiki" idea is a utility that converts from a very simple Wiki-style text format into DocBook, the very large and complex XML DTD that we use to store our documentation. It's hard to explain, so here is an example. Here is a trivial DocBook fragment in standard DocBook format: <sect1><title id='intro'>Introduction</title> <para> Welcome to the <ulink url='http://www.linuxdoc.org'> <citetitle>Linux Documentation Project</citetitle> </ulink> </para> </sect1> Even in this extremely simple example, you can see that DocBook can be verbose. Some would say that is a great understatement. :-) That's one of the reasons many authors continue to work in LinuxDoc, which is simpler but less powerful. In the simplified text format, this becomes: =Introduction|intro= Welcome to the [[http://www.linuxdoc.org|Linux Documentation Project]] The simplified text format will not even begin to cover all of the many tags that DocBook provides. That would be a losing battle. Rather than fight that losing battle, we're allowing for DocBook to be inserted inline into the text. Unfortunately we have not yet figured out a way to do it the other way around -- you won't be able to insert the text hints inside any DocBook structures. New Documents * Linux IPv6 HOWTO http://linuxdoc.org/HOWTO/Linux+IPv6-HOWTO/ Version 0.15, Peter Bieringer * Linux+Win9x+Grub HOWTO http://www.linuxdoc.org/HOWTO/Linux+Win9x+Grub-HOWTO/ Version 1.0, Joel Rosen * The Indic Fonts HOWTO http://www.linuxdoc.org/HOWTO/Indic-Fonts-HOWTO/ Version 0.1, Maninder Bali Updated Documents * Apache Compile HOWTO (Linux edition) http://www.linuxdoc.org/HOWTO/Apache-Compile-HOWTO/ Version 1.9.7, Luc de Louw, luc@delouw.ch * C++ Programming HOW-TO http://www.linuxdoc.org/HOWTO/C++Programming-HOWTO.html Version 40.9, Al Dev, alavoor@yahoo.com * C-C++ Beautifier HOW-TO http://www.linuxdoc.org/HOWTO/C-C++Beautifier-HOWTO.html Version 15.3, Al Dev, alavoor@yahoo.com * CDServer-HOWTO http://www.linuxdoc.org/HOWTO/CDServer-HOWTO/ Version 1.40, Randolph Tata, randy@talcon.com * CPU Design HOW-TO http://www.linuxdoc.org/HOWTO/CPU-Design-HOWTO.html Version 12.0, Al Dev, alavoor@yahoo.com * CVS-RCS- HOW-TO document for Linux (Source Code Control System) http://www.linuxdoc.org/HOWTO/CVS-RCS-HOWTO.html Version 21.7, Al Dev, alavoor@yahoo.com * Diskless Nodes HOW-TO document for Linux http://www.linuxdoc.org/HOWTO/Diskless-HOWTO.html Version 22.4, Al Dev, alavoor@yahoo.com, Gero Kuhlmann, gero@gkmniix.han.de, Ken Yap, ken.yap@acm.org, Markus Gutschke, markus+etherboot@gutschke.com, Robert Nemkin, buci@math.klte.hu * Java Decompiler HOW-TO http://www.linuxdoc.org/HOWTO/Java-Decompiler-HOWTO.html Version 4.0, Al Dev, alavoor@yahoo.com * LILO, Linux Crash Rescue HOW-TO http://www.linuxdoc.org/HOWTO/LILO-crash-rescue-HOWTO.html Version 10.1, Al Dev, alavoor@yahoo.com * Linux Assembly HOWTO http://www.linuxdoc.org/HOWTO/Assembly-HOWTO/ Version 2002/01/12, Konstantin Boldyshev, konst@linuxassembly.org * Linux Frequently Asked Questions with Answers http://www.linuxdoc.org/FAQ/Linux-FAQ/ Version 1.20, Robert Kiesling, rkiesling@mainmatter.com * Linux IP Masquerade HOWTO http://www.linuxdoc.org/HOWTO/IP-Masquerade-HOWTO.html Version 2.00.010502, David Ranch, dranch@trinnet.net * Linux RAID FAQ http://www.linuxdoc.org/FAQ/Linux-RAID-FAQ/ Version 0.0.10, Gregory Leblanc, gleblanc (at) cu-portland.edu * Modem Dialup NT HOWTO http://linuxdoc.org/HOWTO/Modem-Dialup-NT-HOWTO.html Version 1.2, Al Dev, alavoor@yahoo.com * PHP HOW-TO http://www.linuxdoc.org/HOWTO/PHP-HOWTO.html Version 25.9, Al Dev, alavoor@yahoo.com * Process Monitor HOW-TO for Linux http://www.linuxdoc.org/HOWTO/Process-Monitor-HOWTO.html Version 11.1, Al Dev, alavoor@yahoo.com * RPM for Unix HOW-TO http://linuxdoc.org/HOWTO/RPM-for-Unix-HOWTO.html Version 1.5, Al Dev, alavoor@yahoo.com * Secure Programming for Linux and Unix HOWTO http://www.linuxdoc.org/HOWTO/Secure-Programs-HOWTO/ Version 2.92, David A. Wheeler * The Linux Bootdisk HOWTO http://www.linuxdoc.org/HOWTO/Bootdisk-HOWTO/ Version 4.5, Tom Fawcett, bootdisk-howto@linuxdoc.org * The Linux Gamers HOWTO http://www.linuxdoc.org/HOWTO/Linux-Gamers-HOWTO/ Version 0.9.4, Peter Jay Salzman, p@dirac.org * The Linux Kernel HOWTO http://www.linuxdoc.org/HOWTO/Kernel-HOWTO.html Version 3.1, Brian Ward, bri@cs.uchicago.edu * Transparent Proxy with Linux and Squid mini-HOWTO http://linuxdoc.org/HOWTO/mini/TransparentProxy.html Version 1.13, Daniel Kiracofe, drk@unxsoft.com * Vim Color Editor HOW-TO (Vi Improved with syntax color highlighting http://www.linuxdoc.org/HOWTO/Vim-HOWTO.html Version 17.3, Al Dev, alavoor@yahoo.com Unmaintained Documents These documents have been abandoned by their maintainers and many of them have not been updated in some time. If you're willing to become the maintainer for one of them, please join the LDP discussion list at lists.linuxdoc.org and post a message indicating your interest. * Battery Powered Linux Mini-HOWTO http://www.linuxdoc.org/HOWTO/mini/Battery-Powered.html Version * Brief Introduction to Alpha Systems and Processors http://www.linuxdoc.org/HOWTO/Alpha-HOWTO.html Version 0.11 * Enterprise Java for Linux HOWTO http://www.linuxdoc.org/HOWTO/Enterprise-Java-for-Linux-HOWTO.html Version 0.2 * HOW-TO for inHouse IntraNet http://www.linuxdoc.org/HOWTO/mini/Netscape+Proxy.html Version * Installing Linux on ZIP disk using ppa ZIP Drive Mini-Howto http://www.linuxdoc.org/HOWTO/mini/Install-From-ZIP.html Version 0.7 * LINUX PLIP MINI-HOWTO http://www.linuxdoc.org/HOWTO/mini/PLIP.html Version 2.1 * Linux Benchmarking HOWTO http://www.linuxdoc.org/HOWTO/Benchmarking-HOWTO.html Version 0.12 * Linux Swap Space Mini-HOWTO http://www.linuxdoc.org/HOWTO/mini/Swap-Space.html Version 1.42 * Linux Threads Frequently Asked Questions (FAQ) http://www.linuxdoc.org/FAQ/Threads-FAQ/ Version * Linux simple fax printer server mini-HOWTO (faxsrv-mini-HOWTO) http://www.linuxdoc.org/HOWTO/mini/Fax-Server.html Version 1.0 * NFS-Root Mini-Howto http://www.linuxdoc.org/HOWTO/mini/NFS-Root.html Version 8 * News Leafsite mini-HOWTO http://www.linuxdoc.org/HOWTO/mini/News-Leafsite.html Version 0.4 * SoundBlaster AWE 32/64 HOWTO http://www.linuxdoc.org/HOWTO/mini/Soundblaster-AWE.html Version 1.2 * Spanish Linux HOWTO http://www.linuxdoc.org/HOWTO/Spanish-HOWTO.html Version 0.1 * The Ftape FAQ http://www.linuxdoc.org/FAQ/Ftape-FAQ.html Version 0.2 * The Hebrew HOWTO http://www.linuxdoc.org/HOWTO/Hebrew-HOWTO.html Version 0.4 * The LBX Mini-HOWTO http://www.linuxdoc.org/HOWTO/mini/LBX.html Version 1.04 * The Linux ""Linux-DOS-Win95-OS2"" mini-HOWTO http://www.linuxdoc.org/HOWTO/mini/Linux+DOS+Win95+OS2.html Version 1.3.1 * The Linux 3Dfx HOWTO http://www.linuxdoc.org/HOWTO/3Dfx-HOWTO.html Version 1.16 * The Linux Busmouse HOWTO http://www.ibiblio.org/pub/Linux/docs/HOWTO/unmaintained/Busmouse- HOWTO/ Version 2.0 * The Linux Intranet Server HOWTO http://www.linuxdoc.org/HOWTO/Intranet-Server-HOWTO.html Version 2.12 * The dosemu HOWTO http://www.linuxdoc.org/HOWTO/DOSEMU-HOWTO.html Version * Token-Ring mini-HOWTO http://www.linuxdoc.org/HOWTO/mini/Token-Ring.html Version 4.1 * UMSDOS HOW-TO http://www.linuxdoc.org/HOWTO/UMSDOS-HOWTO.html Version 1.2 * Visible bell mini-Howto http://www.linuxdoc.org/HOWTO/mini/Visual-Bell.html Version 2.3 * X11-big-cursor MINIHOWTO http://www.linuxdoc.org/HOWTO/mini/X-Big-Cursor.html Version 2 * mini-HOWTO install qmail with MH http://www.linuxdoc.org/HOWTO/mini/Qmail+MH.html Version 1.4 About the LDP The Linux Documentation Project is developing free, high quality documentation for the GNU/Linux operating system. This includes the creation of HOWTOs and Guides, and collaboration with other documentation groups. If you've always wanted to help Linux reach Total World Domination(tm), but you're not a programmer, there's still something you can do. Help the LDP! The LDP keeps a page of resources for authors at http://www.linuxdoc.org/authors/. Contributions are always welcome. For more LDP Weekly News, go to http://www.linuxdoc.org/ldpwn/ -- David C. Merrill http://www.lupercalia.net Linux Documentation Project david@lupercalia.net Collection Editor & Coordinator http://www.linuxdoc.org Arrakis teaches the attitude of the knife -- chopping off what's incomplete and saying: "Now, it's complete because it's ended here." -- from "Collected Sayings of Muad'Dib" by the Princess Irulan