bootparam.7: Minor formatting fixes + fixes to kernel source file paths

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

man7/bootparam.7

@@ -82,7 +82,8 @@ separated parameters per keyword.
 keyword with up to an additional 10 parameters in unusually
 complicated situations, assuming the setup function supports it.)
 
-Most of the sorting goes on in linux/init/main.c.
+Most of the sorting is coded in the kernel source file
+.IR init/main.c .
 First, the kernel
 checks to see if the argument is any of the special arguments 'root=',
 \&'nfsroot=', 'nfsaddrs=', 'ro', 'rw', 'debug' or 'init'.
@@ -176,7 +177,9 @@ select the second floppy drive as the root device, one would
 use 'root=/dev/fd1'.
 
 The root device can be specified symbolically or numerically.
-A symbolic specification has the form /dev/XXYN, where XX designates
+A symbolic specification has the form
+.I /dev/XXYN,
+where XX designates
 the device type ('hd' for ST-506 compatible hard disk, with Y in
 \&'a'-'d'; 'sd' for SCSI compatible disk, with Y in 'a'-'e';
 \&'ad' for Atari ACSI disk, with Y in 'a'-'e',
@@ -197,7 +200,9 @@ The '/dev/' part is purely conventional.
 
 The more awkward and less portable numeric specification of the above
 possible root devices in major/minor format is also accepted.
-(E.g., /dev/sda3 is major 8, minor 3, so you could use 'root=0x803' as an
+(E.g.,
+.I /dev/sda3
+is major 8, minor 3, so you could use 'root=0x803' as an
 alternative.)
 .TP
 .BR "'rootfstype=...'"
@@ -323,7 +328,8 @@ may be logged to disk.
 Messages with a priority above
 .I console_loglevel
 are also printed on the console.
-(For these levels, see \fI<linux/kernel.h>\fP.)
+(For these levels, see
+.IR <linux/kernel.h> .)
 By default this variable is set to log anything more important than
 debug messages.
 This boot argument will cause the kernel to also
@@ -389,8 +395,10 @@ a 'ramdisk=N' parameter to tell its size.
 (This could also be set in the kernel image at compile time.)
 These days ram disks use the buffer cache, and grow dynamically.
 For a lot of information in conjunction with the new ramdisk
-setup), see
-.IR /usr/src/linux/Documentation/ramdisk.txt .
+setup), see the kernel source file
+.IR Documentation/blockdev/ramdisk.txt 
+.RI ( Documentation/ramdisk.txt
+in older kernels).
 
 There are four parameters, two boolean and two integral.
 .TP
@@ -423,12 +431,18 @@ These days it is possible to compile the kernel to use initrd.
 When this feature is enabled, the boot process will load the kernel
 and an initial ramdisk; then the kernel converts initrd into
 a "normal" ramdisk, which is mounted read-write as root device;
-then /linuxrc is executed; afterward the "real" root file system is mounted,
-and the initrd file system is moved over to /initrd; finally
-the usual boot sequence (e.g., invocation of /sbin/init) is performed.
+then
+.I /linuxrc
+is executed; afterward the "real" root file system is mounted,
+and the initrd file system is moved over tocw
+.IR /initrd ;
+finally
+the usual boot sequence (e.g., invocation of
+.IR /sbin/init )
+is performed.
 
-For a detailed description of the initrd feature, see
-.IR /usr/src/linux/Documentation/initrd.txt .
+For a detailed description of the initrd feature, see the kernel source file
+.IR Documentation/initrd.txt .
 
 The 'noinitrd' option tells the kernel that although it was compiled for
 operation with initrd, it should not go through the above steps, but
@@ -593,7 +607,7 @@ value, if nonzero, tells the driver not to reset the SCSI bus when
 setting up the host adapter at boot.
 .TP
 .B "AdvanSys SCSI Hosts configuration ('advansys=')"
-The AdvanSys driver can accept up to four i/o addresses that will be
+The AdvanSys driver can accept up to four I/O addresses that will be
 probed for an AdvanSys SCSI card.
 Note that these values (if used) do
 not effect EISA or PCI probing in any way.
@@ -614,9 +628,9 @@ level of the debugging messages to any of 16 levels of verbosity.
 .BI BusLogic= N1,N2,N3,N4,N5,S1,S2,...
 .IP
 For an extensive discussion of the BusLogic command line parameters,
-see
-.I /usr/src/linux/drivers/scsi/BusLogic.c
-(lines 3149-3270 in the kernel version I am looking at).
+see the kernel source file
+.IR drivers/scsi/BusLogic.c .
+.\" (lines 3149-3270 in the kernel version I am looking at).
 The text
 below is a very much abbreviated extract.
 
@@ -639,7 +653,7 @@ ER:None, ER:<Per-Target-Spec>), and over Host Adapter Probing
 (NoProbe, NoProbeISA, NoSortPCI).
 .TP
 .B "EATA/DMA configuration"
-The default list of i/o ports to be probed can be changed by
+The default list of I/O ports to be probed can be changed by
 .IP
 .BI eata= iobase,iobase,...\fP.
 .TP
@@ -670,8 +684,8 @@ where S is a comma-separated string of items keyword[:value].
 Recognized keywords (possibly with value) are:
 ioport:addr, noreset, nosync:x, period:ns, disconnect:x,
 debug:x, proc:x.
-For the function of these parameters, see
-.IR /usr/src/linux/drivers/scsi/in2000.c .
+For the function of these parameters, see the kernel source file
+.IR drivers/scsi/in2000.c .
 .TP
 .B "NCR5380 and NCR53C400 configuration"
 The boot arg is of the form
@@ -700,8 +714,8 @@ Recognized keywords are: mpar (master_parity), spar (scsi_parity),
 disc (disconnection), specf (special_features), ultra (ultra_scsi),
 fsn (force_sync_nego), tags (default_tags), sync (default_sync),
 verb (verbose), debug (debug), burst (burst_max).
-For the function of the assigned values, see
-.IR /usr/src/linux/drivers/scsi/ncr53c8xx.c .
+For the function of the assigned values, see the kernel source file
+.IR drivers/scsi/ncr53c8xx.c .
 .TP
 .B "NCR53c406a configuration"
 .IP
@@ -746,7 +760,7 @@ The valid values for
 are as follows: 0xcc000, 0xc8000, 0xdc000, 0xd8000.
 .TP
 .B "UltraStor 14F/34F configuration"
-The default list of i/o ports to be probed can be changed by
+The default list of I/O ports to be probed can be changed by
 .IP
 .BI eata= iobase,iobase,... .
 .TP
@@ -762,8 +776,8 @@ where S is a comma-separated string of options.
 Recognized options are
 nosync:bitmask, nodma:x, period:ns, disconnect:x, debug:x,
 clock:x, next.
-For details, see
-.IR /usr/src/linux/drivers/scsi/wd33c93.c .
+For details, see the kernel source file
+.IR drivers/scsi/wd33c93.c .
 .SS Hard disks
 .TP
 .B "IDE Disk/CD-ROM Driver Parameters"
@@ -881,8 +895,8 @@ xd=2,5,0x320,3
 .IP
 .BI ez= iobase[,irq[,rep[,nybble]]]
 .SS IBM MCA bus devices
-See also
-.IR /usr/src/linux/Documentation/mca.txt .
+See also the kernel source file
+.IR Documentation/mca.txt .
 .TP
 .B "PS/2 ESDI hard disks"
 It is possible to specify the desired geometry at boot time:
@@ -1174,7 +1188,7 @@ Syntax:
 .IP
 teles=iobase,irq,membase,protocol,teles_id
 .IP
-where iobase is the i/o port address of the card, membase is the
+where iobase is the I/O port address of the card, membase is the
 shared memory base address of the card, irq is the interrupt channel
 the card uses, and teles_id is the unique ASCII string identifier.
 .SS Serial port drivers
@@ -1184,8 +1198,8 @@ Syntax:
 .IP
 riscom=iobase1[,iobase2[,iobase3[,iobase4]]]
 .IP
-More details can be found in
-.IR /usr/src/linux/Documentation/riscom8.txt .
+More details can be found in the kernel source file
+.IR Documentation/riscom8.txt .
 .TP
 .B "The DigiBoard Driver ('digi=')"
 If this option is used, it should have precisely six parameters.
@@ -1209,8 +1223,8 @@ digi=E,PC/Xi,D,16,200,D0000
 .br
 digi=1,0,0,16,0x200,851968
 .IP
-More details can be found in
-.IR /usr/src/linux/Documentation/digiboard.txt .
+More details can be found in the kernel source file
+.IR Documentation/digiboard.txt .
 .TP
 .B "The Baycom Serial/Parallel Radio Modem"
 Syntax:
@@ -1306,5 +1320,5 @@ Braille machines.
 Large parts of this man page have been derived from the
 Boot Parameter HOWTO (version 1.0.1) written by Paul Gortmaker.
 More information may be found in this (or a more recent) HOWTO.
-An up-to-date source of information is
-.IR /usr/src/linux/Documentation/kernel-parameters.txt .
+An up-to-date source of information is the kernel source file
+.IR Documentation/kernel-parameters.txt .