[PATCH] kernel Doc/ URL corrections

Correct lots of URLs in Documentation/ Also a few minor whitespace cleanups
and typo/spello fixes. Sadly there are still a lot of bad URLs remaining.

Signed-off-by: Randy Dunlap <rdunlap@xenotime.net>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>

authored by Randy Dunlap and committed by Linus Torvalds 98766fbe 6c52f137

+79 -76
+1 -1
Documentation/arm/VFP/release-notes.txt
··· 12 12 John R. Hauser using the TestFloat-2a test suite. Details of this 13 13 library and test suite can be found at: 14 14 15 - http://www.cs.berkeley.edu/~jhauser/arithmetic/SoftFloat.html 15 + http://www.jhauser.us/arithmetic/SoftFloat.html 16 16 17 17 The operations which have been tested with this package are: 18 18
-1
Documentation/dvb/faq.txt
··· 60 60 Metzler Bros. DVB development; alternate drivers and 61 61 DVB utilities, include dvb-mpegtools and tuxzap. 62 62 63 - http://www.linuxstb.org/ 64 63 http://sourceforge.net/projects/dvbtools/ 65 64 Dave Chapman's dvbtools package, including 66 65 dvbstream and dvbtune
+1 -1
Documentation/filesystems/affs.txt
··· 216 216 217 217 If you are interested in an Amiga Emulator for Linux, look at 218 218 219 - http://www-users.informatik.rwth-aachen.de/~crux/uae.html 219 + http://www.freiburg.linux.de/~uae/
+1 -2
Documentation/filesystems/ext2.txt
··· 369 369 e2fsprogs (e2fsck) http://e2fsprogs.sourceforge.net/ 370 370 Design & Implementation http://e2fsprogs.sourceforge.net/ext2intro.html 371 371 Journaling (ext3) ftp://ftp.uk.linux.org/pub/linux/sct/fs/jfs/ 372 - Hashed Directories http://kernelnewbies.org/~phillips/htree/ 373 372 Filesystem Resizing http://ext2resize.sourceforge.net/ 374 - Compression (*) http://www.netspace.net.au/~reiter/e2compr/ 373 + Compression (*) http://e2compr.sourceforge.net/ 375 374 376 375 Implementations for: 377 376 Windows 95/98/NT/2000 http://uranus.it.swin.edu.au/~jn/linux/Explore2fs.htm
+5 -5
Documentation/floppy.txt
··· 4 4 ========= 5 5 6 6 A FAQ list may be found in the fdutils package (see below), and also 7 - at http://fdutils.linux.lu/FAQ.html 7 + at <http://fdutils.linux.lu/faq.html>. 8 8 9 9 10 10 LILO configuration options (Thinkpad users, read this) ··· 217 217 The latest version can be found at fdutils homepage: 218 218 http://fdutils.linux.lu 219 219 220 - The fdutils-5.4 release can be found at: 221 - http://fdutils.linux.lu/fdutils-5.4.src.tar.gz 222 - http://www.tux.org/pub/knaff/fdutils/fdutils-5.4.src.tar.gz 223 - ftp://metalab.unc.edu/pub/Linux/utils/disk-management/fdutils-5.4.src.tar.gz 220 + The fdutils releases can be found at: 221 + http://fdutils.linux.lu/download.html 222 + http://www.tux.org/pub/knaff/fdutils/ 223 + ftp://metalab.unc.edu/pub/Linux/utils/disk-management/ 224 224 225 225 Reporting problems about the floppy driver 226 226 ==========================================
+1 -1
Documentation/ioctl-number.txt
··· 133 133 'l' 00-3F linux/tcfs_fs.h transparent cryptographic file system 134 134 <http://mikonos.dia.unisa.it/tcfs> 135 135 'l' 40-7F linux/udf_fs_i.h in development: 136 - <http://www.trylinux.com/projects/udf/> 136 + <http://sourceforge.net/projects/linux-udf/> 137 137 'm' all linux/mtio.h conflict! 138 138 'm' all linux/soundcard.h conflict! 139 139 'm' all linux/synclink.h conflict!
+35 -25
Documentation/kernel-docs.txt
··· 196 196 197 197 * Title: "Writing Linux Device Drivers" 198 198 Author: Michael K. Johnson. 199 - URL: http://people.redhat.com/johnsonm/devices.html 199 + URL: http://users.evitech.fi/~tk/rtos/writing_linux_device_d.html 200 200 Keywords: files, VFS, file operations, kernel interface, character 201 201 vs block devices, I/O access, hardware interrupts, DMA, access to 202 202 user memory, memory allocation, timers. ··· 284 284 285 285 * Title: "Linux Kernel Module Programming Guide" 286 286 Author: Ori Pomerantz. 287 - URL: http://www.tldp.org/LDP/lkmpg/mpg.html 287 + URL: http://tldp.org/LDP/lkmpg/2.6/html/index.html 288 288 Keywords: modules, GPL book, /proc, ioctls, system calls, 289 289 interrupt handlers . 290 290 Description: Very nice 92 pages GPL book on the topic of modules ··· 292 292 293 293 * Title: "Device File System (devfs) Overview" 294 294 Author: Richard Gooch. 295 - URL: http://www.atnf.csiro.au/~rgooch/linux/docs/devfs.txt 295 + URL: http://www.atnf.csiro.au/people/rgooch/linux/docs/devfs.html 296 296 Keywords: filesystem, /dev, devfs, dynamic devices, major/minor 297 297 allocation, device management. 298 298 Description: Document describing Richard Gooch's controversial ··· 316 316 317 317 * Title: "The Kernel Hacking HOWTO" 318 318 Author: Various Talented People, and Rusty. 319 - URL: 320 - http://www.lisoleg.net/doc/Kernel-Hacking-HOWTO/kernel-hacking-HOW 321 - TO.html 319 + Location: in kernel tree, Documentation/DocBook/kernel-hacking/ 320 + (must be built as "make {htmldocs | psdocs | pdfdocs}) 322 321 Keywords: HOWTO, kernel contexts, deadlock, locking, modules, 323 322 symbols, return conventions. 324 323 Description: From the Introduction: "Please understand that I ··· 331 332 originally written for the 2.3 kernels, but nearly all of it 332 333 applies to 2.2 too; 2.0 is slightly different". 333 334 334 - * Title: "ALSA 0.5.0 Developer documentation" 335 - Author: Stephan 'Jumpy' Bartels . 336 - URL: http://www.math.TU-Berlin.de/~sbartels/alsa/ 335 + * Title: "Writing an ALSA Driver" 336 + Author: Takashi Iwai <tiwai@suse.de> 337 + URL: http://www.alsa-project.org/~iwai/writing-an-alsa-driver/index.html 337 338 Keywords: ALSA, sound, soundcard, driver, lowlevel, hardware. 338 339 Description: Advanced Linux Sound Architecture for developers, 339 - both at kernel and user-level sides. Work in progress. ALSA is 340 - supposed to be Linux's next generation sound architecture. 340 + both at kernel and user-level sides. ALSA is the Linux kernel 341 + sound architecture in the 2.6 kernel version. 341 342 342 343 * Title: "Programming Guide for Linux USB Device Drivers" 343 344 Author: Detlef Fliegl. ··· 368 369 filesystems, IPC and Networking Code. 369 370 370 371 * Title: "Linux Kernel Mailing List Glossary" 371 - Author: John Levon. 372 - URL: http://www.movement.uklinux.net/glossary.html 372 + Author: various 373 + URL: http://kernelnewbies.org/glossary/ 373 374 Keywords: glossary, terms, linux-kernel. 374 375 Description: From the introduction: "This glossary is intended as 375 376 a brief description of some of the acronyms and terms you may hear ··· 377 378 378 379 * Title: "Linux Kernel Locking HOWTO" 379 380 Author: Various Talented People, and Rusty. 380 - URL: 381 - http://netfilter.kernelnotes.org/unreliable-guides/kernel-locking- 382 - HOWTO.html 381 + Location: in kernel tree, Documentation/DocBook/kernel-locking/ 382 + (must be built as "make {htmldocs | psdocs | pdfdocs}) 383 383 Keywords: locks, locking, spinlock, semaphore, atomic, race 384 384 condition, bottom halves, tasklets, softirqs. 385 385 Description: The title says it all: document describing the ··· 488 490 489 491 * Title: "Get those boards talking under Linux." 490 492 Author: Alex Ivchenko. 491 - URL: http://www.ednmag.com/ednmag/reg/2000/06222000/13df2.htm 493 + URL: http://www.edn.com/article/CA46968.html 492 494 Keywords: data-acquisition boards, drivers, modules, interrupts, 493 495 memory allocation. 494 496 Description: Article written for people wishing to make their data ··· 496 498 overview on writing drivers, from the naming of functions to 497 499 interrupt handling. 498 500 Notes: Two-parts article. Part II is at 499 - http://www.ednmag.com/ednmag/reg/2000/07062000/14df.htm 501 + URL: http://www.edn.com/article/CA46998.html 500 502 501 503 * Title: "Linux PCMCIA Programmer's Guide" 502 504 Author: David Hinds. ··· 527 529 definitive guide for hackers, virus coders and system 528 530 administrators." 529 531 Author: pragmatic/THC. 530 - URL: http://packetstorm.securify.com/groups/thc/LKM_HACKING.html 532 + URL: http://packetstormsecurity.org/docs/hack/LKM_HACKING.html 531 533 Keywords: syscalls, intercept, hide, abuse, symbol table. 532 534 Description: Interesting paper on how to abuse the Linux kernel in 533 535 order to intercept and modify syscalls, make ··· 535 537 write kernel modules based virus... and solutions for admins to 536 538 avoid all those abuses. 537 539 Notes: For 2.0.x kernels. Gives guidances to port it to 2.2.x 538 - kernels. Also available in txt format at 539 - http://www.blacknemesis.org/hacking/txt/cllkm.txt 540 + kernels. 540 541 541 542 BOOKS: (Not on-line) 542 543 ··· 554 557 ISBN: 0-59600-008-1 555 558 Notes: Further information in 556 559 http://www.oreilly.com/catalog/linuxdrive2/ 557 - 560 + 561 + * Title: "Linux Device Drivers, 3nd Edition" 562 + Authors: Jonathan Corbet, Alessandro Rubini, and Greg Kroah-Hartman 563 + Publisher: O'Reilly & Associates. 564 + Date: 2005. 565 + Pages: 636. 566 + ISBN: 0-596-00590-3 567 + Notes: Further information in 568 + http://www.oreilly.com/catalog/linuxdrive3/ 569 + PDF format, URL: http://lwn.net/Kernel/LDD3/ 570 + 558 571 * Title: "Linux Kernel Internals" 559 572 Author: Michael Beck. 560 573 Publisher: Addison-Wesley. ··· 773 766 documents, FAQs... 774 767 775 768 * Name: "linux-kernel mailing list archives and search engines" 769 + URL: http://vger.kernel.org/vger-lists.html 776 770 URL: http://www.uwsg.indiana.edu/hypermail/linux/kernel/index.html 777 - URL: http://www.kernelnotes.org/lnxlists/linux-kernel/ 778 - URL: http://www.geocrawler.com 771 + URL: http://marc.theaimsgroup.com/?l=linux-kernel 772 + URL: http://groups.google.com/group/mlist.linux.kernel 773 + URL: http://www.cs.helsinki.fi/linux/linux-kernel/ 774 + URL: http://www.lib.uaa.alaska.edu/linux-kernel/ 779 775 Keywords: linux-kernel, archives, search. 780 776 Description: Some of the linux-kernel mailing list archivers. If 781 777 you have a better/another one, please let me know. 782 778 _________________________________________________________________ 783 779 784 - Document last updated on Thu Jun 28 15:09:39 CEST 2001 780 + Document last updated on Sat 2005-NOV-19
+1 -1
Documentation/mca.txt
··· 252 252 home page (URL below) for a perpetually out-of-date list. 253 253 254 254 ===================================================================== 255 - MCA Linux Home Page: http://glycerine.itsmm.uni.edu/mca/ 255 + MCA Linux Home Page: http://www.dgmicro.com/mca/ 256 256 257 257 Christophe Beauregard 258 258 chrisb@truespectra.com
+1 -4
Documentation/networking/driver.txt
··· 1 - Documents about softnet driver issues in general can be found 2 - at: 3 - 4 - http://www.firstfloor.org/~andi/softnet/ 1 + Document about softnet driver issues 5 2 6 3 Transmit path guidelines: 7 4
+1 -1
Documentation/networking/iphase.txt
··· 22 22 - All variants of Interphase ATM PCI (i)Chip adapter cards are supported, 23 23 including x575 (OC3, control memory 128K , 512K and packet memory 128K, 24 24 512K and 1M), x525 (UTP25) and x531 (DS3 and E3). See 25 - http://www.iphase.com/products/ClassSheet.cfm?ClassID=ATM 25 + http://www.iphase.com/site/iphase-web/?epi_menuItemID=e196f04b4b3b40502f150882e21046a0 26 26 for details. 27 27 - Only x86 platforms are supported. 28 28 - SMP is supported.
+2 -6
Documentation/networking/irda.txt
··· 3 3 programs can be found on http://irda.sourceforge.net/ 4 4 5 5 For more information about how to use the IrDA protocol stack, see the 6 - Linux Infared HOWTO (http://www.tuxmobil.org/Infrared-HOWTO/Infrared-HOWTO.html) 7 - by Werner Heuser <wehe@tuxmobil.org> 6 + Linux Infrared HOWTO by Werner Heuser <wehe@tuxmobil.org>: 7 + <http://www.tuxmobil.org/Infrared-HOWTO/Infrared-HOWTO.html> 8 8 9 9 There is an active mailing list for discussing Linux-IrDA matters called 10 10 irda-users@lists.sourceforge.net 11 - 12 - 13 - 14 -
+1 -2
Documentation/networking/ray_cs.txt
··· 29 29 will find them all. 30 30 31 31 Information on card services is available at: 32 - ftp://hyper.stanford.edu/pub/pcmcia/doc 33 - http://hyper.stanford.edu/HyperNews/get/pcmcia/home.html 32 + http://pcmcia-cs.sourceforge.net/ 34 33 35 34 36 35 Card services user programs are still required for PCMCIA devices.
+14 -14
Documentation/networking/vortex.txt
··· 11 11 Don is no longer the prime maintainer of this version of the driver. 12 12 Please report problems to one or more of: 13 13 14 - Andrew Morton <andrewm@uow.edu.au> 14 + Andrew Morton <akpm@osdl.org> 15 15 Netdev mailing list <netdev@vger.kernel.org> 16 16 Linux kernel mailing list <linux-kernel@vger.kernel.org> 17 17 ··· 274 274 275 275 Additional documentation is available at Don Becker's Linux Drivers site: 276 276 277 - http://www.scyld.com/network/vortex.html 277 + http://www.scyld.com/vortex.html 278 278 279 279 Donald Becker's driver development site: 280 280 281 - http://www.scyld.com/network 281 + http://www.scyld.com/network.html 282 282 283 283 Donald's vortex-diag program is useful for inspecting the NIC's state: 284 284 285 - http://www.scyld.com/diag/#pci-diags 285 + http://www.scyld.com/ethercard_diag.html 286 286 287 287 Donald's mii-diag program may be used for inspecting and manipulating 288 288 the NIC's Media Independent Interface subsystem: 289 289 290 - http://www.scyld.com/diag/#mii-diag 290 + http://www.scyld.com/ethercard_diag.html#mii-diag 291 291 292 292 Donald's wake-on-LAN page: 293 293 294 - http://www.scyld.com/expert/wake-on-lan.html 294 + http://www.scyld.com/wakeonlan.html 295 295 296 296 3Com's documentation for many NICs, including the ones supported by 297 297 this driver is available at ··· 305 305 Driver updates and a detailed changelog for the modifications which 306 306 were made for the 2.3/2,4 series kernel is available at 307 307 308 - http://www.uow.edu.au/~andrewm/linux/#3c59x-2.3 308 + http://www.zip.com.au/~akpm/linux/#3c59x-bc 309 309 310 310 311 311 Autonegotiation notes ··· 434 434 send all logs to the maintainer. 435 435 436 436 3) Download you card's diagnostic tool from Donald 437 - Backer's website http://www.scyld.com/diag. Download 438 - mii-diag.c as well. Build these. 437 + Becker's website <http://www.scyld.com/ethercard_diag.html>. 438 + Download mii-diag.c as well. Build these. 439 439 440 440 a) Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is 441 441 working correctly. Save the output. ··· 443 443 b) Run the above commands when the card is malfunctioning. Send 444 444 both sets of output. 445 445 446 - Finally, please be patient and be prepared to do some work. You may end up working on 447 - this problem for a week or more as the maintainer asks more questions, asks for more 448 - tests, asks for patches to be applied, etc. At the end of it all, the problem may even 449 - remain unresolved. 450 - 446 + Finally, please be patient and be prepared to do some work. You may 447 + end up working on this problem for a week or more as the maintainer 448 + asks more questions, asks for more tests, asks for patches to be 449 + applied, etc. At the end of it all, the problem may even remain 450 + unresolved.
+1 -1
Documentation/power/pci.txt
··· 335 335 PCI Local Bus Specification 336 336 PCI Bus Power Management Interface Specification 337 337 338 - http://pcisig.org 338 + http://www.pcisig.com 339 339
+2 -2
Documentation/scsi/ibmmca.txt
··· 1108 1108 A: You have to activate MCA bus support, first. 1109 1109 Q: Where can I find the latest info about this driver? 1110 1110 A: See the file MAINTAINERS for the current WWW-address, which offers 1111 - updates, info and Q/A lists. At this files' origin, the webaddress 1111 + updates, info and Q/A lists. At this file's origin, the webaddress 1112 1112 was: http://www.uni-mainz.de/~langm000/linux.html 1113 1113 Q: My SCSI-adapter is not recognized by the driver, what can I do? 1114 1114 A: Just force it to be recognized by kernel parameters. See section 5.1. ··· 1248 1248 -------------------- 1249 1249 The address of the IBM SCSI-subsystem supporting WWW-page is: 1250 1250 1251 - http://www.uni-mainz.de/~langm000/linux.html 1251 + http://www.staff.uni-mainz.de/mlang/linux.html 1252 1252 1253 1253 Here you can find info about the background of this driver, patches, 1254 1254 troubleshooting support, news and a bugreport form. Please check that
+2 -2
Documentation/usb/ibmcam.txt
··· 28 28 Xirlink "C-It" camera, also known as "IBM PC Camera". 29 29 The device uses proprietary ASIC (and compression method); 30 30 it is manufactured by Xirlink. See http://www.xirlink.com/ 31 - http://www.ibmpccamera.com or http://www.c-itnow.com/ for 32 - details and pictures. 31 + (renamed to http://www.veo.com), http://www.ibmpccamera.com, 32 + or http://www.c-itnow.com/ for details and pictures. 33 33 34 34 This very chipset ("X Chip", as marked at the factory) 35 35 is used in several other cameras, and they are supported
+2 -2
Documentation/usb/ov511.txt
··· 22 22 http://www.ovt.com/omniusbp.html 23 23 24 24 - A Video4Linux compatible frame grabber program (I recommend vidcat and xawtv) 25 - vidcat is part of the w3cam package: http://www.hdk-berlin.de/~rasca/w3cam/ 26 - xawtv is available at: http://www.in-berlin.de/User/kraxel/xawtv.html 25 + vidcat is part of the w3cam package: http://mpx.freeshell.net/ 26 + xawtv is available at: http://linux.bytesex.org/xawtv/ 27 27 28 28 HOW TO USE IT: 29 29
+3 -3
Documentation/usb/rio.txt
··· 46 46 -------------------- 47 47 48 48 The main page for the project is hosted at sourceforge.net in the following 49 - address: http://rio500.sourceforge.net You can also go to the sourceforge 50 - project page at: http://sourceforge.net/project/?group_id=1944 There is 51 - also a mailing list: rio500-users@lists.sourceforge.net 49 + URL: <http://rio500.sourceforge.net>. You can also go to the project's 50 + sourceforge home page at: <http://sourceforge.net/projects/rio500/>. 51 + There is also a mailing list: rio500-users@lists.sourceforge.net 52 52 53 53 Authors: 54 54 -------
+5 -2
Documentation/video4linux/zr36120.txt
··· 76 76 the zoran starts to work on a new and freshly broadcasted frame.... 77 77 78 78 For pointers I used the specs of both chips. Below are the URLs: 79 - http://www.zoran.com/ftp/download/devices/pci/ZR36120/36120data.pdf 80 - http://www-us.semiconductor.philips.com/acrobat/datasheets/SAA_7110_A_1.pdf 79 + http://www.zoran.com/ftp/download/devices/pci/ZR36120/36120data.pdf 80 + http://www-us.semiconductor.philips.com/acrobat/datasheets/SAA_7110_A_1.pdf 81 + Some alternatives for the Philips SAA 7110 datasheet are: 82 + http://www.datasheetcatalog.com/datasheets_pdf/S/A/A/7/SAA7110.shtml 83 + http://www.datasheetarchive.com/search.php?search=SAA7110&sType=part 81 84 82 85 The documentation has very little on absolute numbers or timings 83 86 needed for the various modes/resolutions, but there are other