Blame SOURCES/0073-documentation-line-wrap.patch

a56a5e
From 81564fcefcf1554fa3a0f2145b9e18d149228344 Mon Sep 17 00:00:00 2001
966cef
From: Harald Hoyer <harald@redhat.com>
966cef
Date: Thu, 9 Jan 2014 12:17:01 +0100
966cef
Subject: [PATCH] documentation: line wrap
966cef
966cef
---
966cef
 dracut.8.asc         |  16 ++++---
966cef
 dracut.asc           |  12 +++--
966cef
 dracut.bootup.7.asc  |   3 +-
966cef
 dracut.cmdline.7.asc | 125 ++++++++++++++++++++++++++++++++-------------------
966cef
 dracut.conf.5.asc    |  18 +++++---
966cef
 dracut.modules.7.asc |  45 +++++++++++--------
966cef
 dracut.usage.asc     |  45 ++++++++++++-------
966cef
 mkinitrd.8.asc       |   4 +-
966cef
 8 files changed, 165 insertions(+), 103 deletions(-)
966cef
966cef
diff --git a/dracut.8.asc b/dracut.8.asc
966cef
index 2ea6744..b294675 100644
966cef
--- a/dracut.8.asc
966cef
+++ b/dracut.8.asc
966cef
@@ -33,9 +33,9 @@ For a complete list of kernel command line options see *dracut.cmdline*(7).
966cef
 If you are dropped to an emergency shell, while booting your initramfs,
966cef
 the file _/run/initramfs/rdsosreport.txt_ is created, which can be safed to a
966cef
 (to be mounted by hand) partition (usually /boot) or a USB stick.
966cef
-Additional debugging info can be produced by adding **rd.debug** to the kernel command line.
966cef
-_/run/initramfs/rdsosreport.txt_ contains all logs and the output of some tools.
966cef
-It should be attached to any report about dracut problems.
966cef
+Additional debugging info can be produced by adding **rd.debug** to the kernel
966cef
+command line. _/run/initramfs/rdsosreport.txt_ contains all logs and the output
966cef
+of some tools. It should be attached to any report about dracut problems.
966cef
 
966cef
 USAGE
966cef
 -----
966cef
@@ -362,7 +362,8 @@ will not be able to boot. Equivalent to "lzma --compress=lzma -9"
966cef
 [WARNING]
966cef
 ====
966cef
 Make sure your kernel has xz decompression support compiled in, otherwise you
966cef
-will not be able to boot. Equivalent to "lzma --compress=xz --check=crc32 --lzma2=dict=1MiB"
966cef
+will not be able to boot. Equivalent to
966cef
+"lzma --compress=xz --check=crc32 --lzma2=dict=1MiB"
966cef
 ====
966cef
 
966cef
 **--lzo**::
966cef
@@ -423,8 +424,8 @@ will not be able to boot.
966cef
 ----
966cef
 
966cef
 **--regenerate-all**::
966cef
-    Regenerate all initramfs images at the default location with the kernel versions found on the system.
966cef
-    Additional parameters are passed through.
966cef
+    Regenerate all initramfs images at the default location with the kernel
966cef
+    versions found on the system. Additional parameters are passed through.
966cef
 
966cef
 FILES
966cef
 -----
966cef
@@ -452,7 +453,8 @@ _/etc/conf.d/_::
966cef
     set in the configuration files.
966cef
 
966cef
 _/etc/cmdline_::
966cef
-    Can contain additional command line options. Deprecated, better use /etc/cmdline.d/*.conf.
966cef
+    Can contain additional command line options. Deprecated, better use
966cef
+    /etc/cmdline.d/*.conf.
966cef
 
966cef
 _/etc/cmdline.d/*.conf_::
966cef
     Can contain additional command line options.
966cef
diff --git a/dracut.asc b/dracut.asc
966cef
index 031b201..b047a33 100644
966cef
--- a/dracut.asc
966cef
+++ b/dracut.asc
966cef
@@ -125,12 +125,14 @@ started looks like <<dracutbootup7>>.
966cef
 
966cef
 == Dracut on shutdown
966cef
 
966cef
-On a systemd driven system, the dracut initramfs is also used for the shutdown procedure.
966cef
+On a systemd driven system, the dracut initramfs is also used for the shutdown
966cef
+procedure.
966cef
 
966cef
 The following steps are executed during a shutdown:
966cef
 
966cef
 * systemd switches to the shutdown.target
966cef
-* systemd starts /lib/systemd/system/shutdown.target.wants/dracut-shutdown.service
966cef
+* systemd starts
966cef
+  /lib/systemd/system/shutdown.target.wants/dracut-shutdown.service
966cef
 * dracut-shutdown.service executes /usr/lib/dracut/dracut-initramfs-restore
966cef
   which unpacks the initramfs to /run/initramfs
966cef
 * systemd finishes shutdown.target
966cef
@@ -138,8 +140,10 @@ The following steps are executed during a shutdown:
966cef
 * systemd tries to unmount everything and mounts the remaining read-only
966cef
 * systemd checks, if there is a /run/initramfs/shutdown executable
966cef
 * if yes, it does a pivot_root to /run/initramfs and executes ./shutdown.
966cef
-  The old root is then mounted on /oldroot. /usr/lib/dracut/modules.d/99shutdown/shutdown.sh is the shutdown executable.
966cef
-* shutdown will try to umount every /oldroot mount and calls the various shutdown hooks from the dracut modules
966cef
+  The old root is then mounted on /oldroot.
966cef
+  /usr/lib/dracut/modules.d/99shutdown/shutdown.sh is the shutdown executable.
966cef
+* shutdown will try to umount every /oldroot mount and calls the various
966cef
+  shutdown hooks from the dracut modules
966cef
 
966cef
 This ensures, that all devices are disassembled and unmounted cleanly.
966cef
 
966cef
diff --git a/dracut.bootup.7.asc b/dracut.bootup.7.asc
966cef
index c35af19..d7edc1e 100644
966cef
--- a/dracut.bootup.7.asc
966cef
+++ b/dracut.bootup.7.asc
966cef
@@ -11,7 +11,8 @@ dracut.bootup - boot ordering in the initramfs
966cef
 DESCRIPTION
966cef
 -----------
966cef
 
966cef
-This flow chart illustrates the ordering of the services, if systemd is used in the dracut initramfs.
966cef
+This flow chart illustrates the ordering of the services, if systemd is used in
966cef
+the dracut initramfs.
966cef
 ----
966cef
 
966cef
                                     systemd-journal.socket
966cef
diff --git a/dracut.cmdline.7.asc b/dracut.cmdline.7.asc
966cef
index 6a5fc8f..8ac5341 100644
966cef
--- a/dracut.cmdline.7.asc
966cef
+++ b/dracut.cmdline.7.asc
966cef
@@ -72,14 +72,14 @@ rootfstype=ext3
966cef
     See also ro option.
966cef
 
966cef
 **rootfallback=**__<path to blockdevice>__::
966cef
-    specify the block device to use as the root filesystem, if the normal root cannot be found.
966cef
-    This can only be a simple block device with a simple file system, for which the filesystem
966cef
-    driver is either compiled in, or added manually to the initramfs.
966cef
-    This parameter can be specified multiple times.
966cef
+    specify the block device to use as the root filesystem, if the normal root
966cef
+    cannot be found. This can only be a simple block device with a simple file
966cef
+    system, for which the filesystem driver is either compiled in, or added
966cef
+    manually to the initramfs. This parameter can be specified multiple times.
966cef
 
966cef
 **rd.auto** **rd.auto=1**::
966cef
-    enable autoassembly of special devices like cryptoLUKS, dmraid, mdraid or lvm.
966cef
-    Default is off as of dracut version >= 024.
966cef
+    enable autoassembly of special devices like cryptoLUKS, dmraid, mdraid or
966cef
+    lvm. Default is off as of dracut version >= 024.
966cef
 
966cef
 **rd.fstab=0**::
966cef
     do not honor special mount options for the root filesystem found in
966cef
@@ -132,9 +132,10 @@ Misc
966cef
 [[dracutkerneldebug]]
966cef
 Debug
966cef
 ~~~~~
966cef
-If you are dropped to an emergency shell, the file _/run/initramfs/rdsosreport.txt_ is created,
966cef
-which can be safed to a (to be mounted by hand) partition (usually /boot) or a USB stick.
966cef
-Additional debugging info can be produced by adding **rd.debug** to the kernel command line.
966cef
+If you are dropped to an emergency shell, the file 
966cef
+_/run/initramfs/rdsosreport.txt_ is created, which can be safed to a (to be
966cef
+mounted by hand) partition (usually /boot) or a USB stick. Additional debugging
966cef
+info can be produced by adding **rd.debug** to the kernel command line.
966cef
 _/run/initramfs/rdsosreport.txt_ contains all logs and the output of some tools.
966cef
 It should be attached to any report about dracut problems.
966cef
 
966cef
@@ -146,13 +147,15 @@ It should be attached to any report about dracut problems.
966cef
 
966cef
 **rd.debug**::
966cef
     set -x for the dracut shell.
966cef
-    If systemd is active in the initramfs, all output is logged to the systemd journal,
966cef
-    which you can inspect with "journalctl -ab".
966cef
-    If systemd is not active, the logs are written to dmesg and _/run/initramfs/init.log_.
966cef
+    If systemd is active in the initramfs, all output is logged to the systemd
966cef
+    journal, which you can inspect with "journalctl -ab".
966cef
+    If systemd is not active, the logs are written to dmesg and
966cef
+    _/run/initramfs/init.log_.
966cef
     If "quiet" is set, it also logs to the console.
966cef
 
966cef
 **rd.memdebug=[0-3]**::
966cef
-    Print memory usage info at various points, set the verbose level from 0 to 3. +
966cef
+    Print memory usage info at various points, set the verbose level from 0 to 3.
966cef
++    
966cef
     Higher level means more debugging output:
966cef
 +
966cef
 ----
966cef
@@ -258,10 +261,10 @@ crypto LUKS
966cef
     This parameter can be specified multiple times.
966cef
 
966cef
 **rd.luks.allow-discards=**__<luks uuid>__::
966cef
-    Allow  using  of discards (TRIM) requests for LUKS partitions with the given UUID.
966cef
-    Any "luks-" of the LUKS UUID is removed before comparing to _<luks uuid>_.
966cef
-    The comparisons also matches, if _<luks uuid>_ is only the beginning of the
966cef
-    LUKS UUID, so you don't have to specify the full UUID.
966cef
+    Allow  using  of discards (TRIM) requests for LUKS partitions with the given
966cef
+    UUID. Any "luks-" of the LUKS UUID is removed before comparing to
966cef
+    _<luks uuid>_. The comparisons also matches, if _<luks uuid>_ is only the
966cef
+    beginning of the LUKS UUID, so you don't have to specify the full UUID.
966cef
     This parameter can be specified multiple times.
966cef
 
966cef
 **rd.luks.allow-discards**::
966cef
@@ -273,11 +276,21 @@ crypto LUKS
966cef
 crypto LUKS - key on removable device support
966cef
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
966cef
 **rd.luks.key=**__<keypath>__:__<keydev>__:__<luksdev>__::
966cef
-    _keypath_ is a path to key file to look for. It's REQUIRED. When _keypath_ ends with '.gpg' it's considered to be key encrypted symmetrically with GPG. You will be prompted for password on boot. GPG support comes with 'crypt-gpg' module which needs to be added explicitly.
966cef
-+
966cef
-_keydev_ is a device on which key file resides. It might be kernel name of devices (should start with "/dev/"), UUID (prefixed with "UUID=") or label (prefix with "LABEL="). You don't have to specify full UUID. Just its beginning will suffice, even if its ambiguous. All matching devices will be probed. This parameter is recommended, but not required. If not present, all block devices will be probed, which may significantly increase boot time.
966cef
-+
966cef
-If _luksdev_ is given, the specified key will only be applied for that LUKS device. Possible values are the same as for _keydev_. Unless you have several LUKS devices, you don't have to specify this parameter. The simplest usage is:
966cef
+    _keypath_ is a path to key file to look for. It's REQUIRED. When _keypath_
966cef
+    ends with '.gpg' it's considered to be key encrypted symmetrically with GPG.
966cef
+    You will be prompted for password on boot. GPG support comes with
966cef
+    'crypt-gpg' module which needs to be added explicitly.
966cef
++
966cef
+_keydev_ is a device on which key file resides. It might be kernel name of
966cef
+devices (should start with "/dev/"), UUID (prefixed with "UUID=") or label
966cef
+(prefix with "LABEL="). You don't have to specify full UUID. Just its beginning
966cef
+will suffice, even if its ambiguous. All matching devices will be probed.
966cef
+This parameter is recommended, but not required. If not present, all block
966cef
+devices will be probed, which may significantly increase boot time.
966cef
++
966cef
+If _luksdev_ is given, the specified key will only be applied for that LUKS
966cef
+device. Possible values are the same as for _keydev_. Unless you have several
966cef
+LUKS devices, you don't have to specify this parameter. The simplest usage is:
966cef
 +
966cef
 [listing]
966cef
 .Example
966cef
@@ -325,7 +338,8 @@ MD RAID
966cef
     ignore mdadm.conf included in initramfs
966cef
 
966cef
 **rd.md.waitclean=1**::
966cef
-    wait for any resync, recovery, or reshape activity to finish before continuing
966cef
+    wait for any resync, recovery, or reshape activity to finish before
966cef
+    continuing
966cef
 
966cef
 **rd.md.uuid=**__<md raid uuid>__::
966cef
     only activate the raid sets with the given UUID. This parameter can be
966cef
@@ -366,8 +380,8 @@ Network
966cef
 
966cef
 [IMPORTANT]
966cef
 =====================
966cef
-It is recommended to either bind an interface to a MAC with the **ifname** argument,
966cef
-or to use the systemd-udevd predictable network interface names.
966cef
+It is recommended to either bind an interface to a MAC with the **ifname**
966cef
+argument, or to use the systemd-udevd predictable network interface names.
966cef
 
966cef
 Predictable network interface device names based on:
966cef
 
966cef
@@ -376,7 +390,8 @@ Predictable network interface device names based on:
966cef
 - physical/geographical location of the hardware
966cef
 - the interface's MAC address
966cef
 
966cef
-See: http://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames
966cef
+See:
966cef
+http://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames
966cef
 
966cef
 Two character prefixes based on the type of interface:
966cef
 
966cef
@@ -423,9 +438,9 @@ USB Android phone::
966cef
 =====================
966cef
 
966cef
 **ip=**__{dhcp|on|any|dhcp6|auto6|ibft}__::
966cef
-    dhcp|on|any::: get ip from dhcp server from all interfaces. If root=dhcp, loop
966cef
-    sequentially through all interfaces (eth0, eth1, ...) and use the first with
966cef
-    a valid DHCP root-path.
966cef
+    dhcp|on|any::: get ip from dhcp server from all interfaces. If root=dhcp,
966cef
+    loop sequentially through all interfaces (eth0, eth1, ...) and use the first
966cef
+    with a valid DHCP root-path.
966cef
 
966cef
     auto6::: IPv6 autoconfiguration
966cef
 
966cef
@@ -448,8 +463,8 @@ same <interface>.
966cef
     explicit network configuration. If you want do define a IPv6 address, put it
966cef
     in brackets (e.g. [2001:DB8::1]). This parameter can be specified multiple
966cef
     times. __<peer>__ is optional and is the address of the remote endpoint
966cef
-    for pointopoint interfaces and it may be followed by a slash and a decimal number,
966cef
-    encoding the network prefix length.
966cef
+    for pointopoint interfaces and it may be followed by a slash and a decimal
966cef
+    number, encoding the network prefix length.
966cef
 +
966cef
 =====================
966cef
 <macaddr>::: optionally **set** <macaddr> on the <interface>. This
966cef
@@ -458,7 +473,8 @@ same <interface>.
966cef
 =====================
966cef
 
966cef
 **ifname=**__<interface>__:__<MAC>__::
966cef
-    Assign network device name <interface> (ie "bootnet") to the NIC with MAC <MAC>.
966cef
+    Assign network device name <interface> (ie "bootnet") to the NIC with
966cef
+    MAC <MAC>.
966cef
 +
966cef
 WARNING: Do **not** use the default kernel naming scheme for the interface name,
966cef
 as it can conflict with the kernel names. So, don't use "eth[0-9]+" for the
966cef
@@ -479,16 +495,18 @@ interface name. Better name it "bootnet" or "bluesocket".
966cef
 
966cef
 **vlan=**__<vlanname>__:__<phydevice>__::
966cef
     Setup vlan device named <vlanname> on <phydeivce>.
966cef
-    We support the four styles of vlan names: VLAN_PLUS_VID (vlan0005), VLAN_PLUS_VID_NO_PAD (vlan5),
966cef
-    DEV_PLUS_VID (eth0.0005), DEV_PLUS_VID_NO_PAD (eth0.5)
966cef
+    We support the four styles of vlan names: VLAN_PLUS_VID (vlan0005),
966cef
+    VLAN_PLUS_VID_NO_PAD (vlan5), DEV_PLUS_VID (eth0.0005),
966cef
+    DEV_PLUS_VID_NO_PAD (eth0.5)
966cef
 
966cef
 **bond=**__<bondname>__[:__<bondslaves>__:[:__<options>__]]::
966cef
     Setup bonding device <bondname> on top of <bondslaves>.
966cef
     <bondslaves> is a comma-separated list of physical (ethernet) interfaces.
966cef
-    <options> is a comma-separated list on bonding options (modinfo bonding for details)
966cef
-    in format compatible with initscripts. If <options> includes multi-valued arp_ip_target option,
966cef
-    then its values should be separated by semicolon.
966cef
-    Bond without parameters assumes bond=bond0:eth0,eth1:mode=balance-rr
966cef
+    <options> is a comma-separated list on bonding options (modinfo bonding for
966cef
+    details) in format compatible with initscripts. If <options> includes
966cef
+    multi-valued arp_ip_target option, then its values should be separated by
966cef
+    semicolon. Bond without parameters assumes
966cef
+    bond=bond0:eth0,eth1:mode=balance-rr
966cef
 
966cef
 **team=**__<teammaster>__:__<teamslaves>__::
966cef
     Setup team device <teammaster> on top of <teamslaves>.
966cef
@@ -496,7 +514,8 @@ interface name. Better name it "bootnet" or "bluesocket".
966cef
 
966cef
 **bridge=**__<bridgename>__:__<ethnames>__::
966cef
     Setup bridge <bridgename> with <ethnames>. <ethnames> is a comma-separated
966cef
-    list of physical (ethernet) interfaces. Bridge without parameters assumes bridge=br0:eth0
966cef
+    list of physical (ethernet) interfaces. Bridge without parameters assumes
966cef
+    bridge=br0:eth0
966cef
 
966cef
 NFS
966cef
 ~~~
966cef
@@ -534,7 +553,9 @@ CIFS
966cef
 as part of the root, then they must be passed on the command line through
966cef
 cifsuser/cifspass.
966cef
 +
966cef
-WARNING: Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path.
966cef
+WARNING: Passwords specified on the kernel command line are visible for all
966cef
+users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
966cef
+network, when using DHCP with DHCP root-path.
966cef
 
966cef
 **cifsuser**=__<username>__::
966cef
     Set the cifs username, if not specified as part of the root.
966cef
@@ -542,7 +563,9 @@ WARNING: Passwords specified on the kernel command line are visible for all user
966cef
 **cifspass**=__<password>__::
966cef
     Set the cifs password, if not specified as part of the root.
966cef
 +
966cef
-WARNING: Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path.
966cef
+WARNING: Passwords specified on the kernel command line are visible for all
966cef
+users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
966cef
+network, when using DHCP with DHCP root-path.
966cef
 
966cef
 iSCSI
966cef
 ~~~~~
966cef
@@ -555,7 +578,9 @@ iSCSI
966cef
     fields. See
966cef
     link:$$http://tools.ietf.org/html/rfc4173#section-5$$[rfc4173].
966cef
 +
966cef
-WARNING: Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path.
966cef
+WARNING: Passwords specified on the kernel command line are visible for all
966cef
+users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
966cef
+network, when using DHCP with DHCP root-path.
966cef
 +
966cef
 [listing]
966cef
 .Example
966cef
@@ -590,12 +615,18 @@ If servername is an IPv6 address, it has to be put in brackets:
966cef
 netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0
966cef
 --
966cef
 +
966cef
-WARNING: Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path. You may want to use rd.iscsi.firmware.
966cef
+WARNING: Passwords specified on the kernel command line are visible for all
966cef
+users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
966cef
+network, when using DHCP with DHCP root-path.
966cef
+You may want to use rd.iscsi.firmware.
966cef
 
966cef
 **root=**__???__ **rd.iscsi.initiator=**__<initiator>__ **rd.iscsi.target.name=**__<target name>__  **rd.iscsi.target.ip=**__<target ip>__ **rd.iscsi.target.port=**__<target port>__ **rd.iscsi.target.group=**__<target group>__ **rd.iscsi.username=**__<username>__ **rd.iscsi.password=**__<password>__ **rd.iscsi.in.username=**__<in username>__ **rd.iscsi.in.password=**__<in password>__::
966cef
     manually specify all iscsistart parameter (see **+iscsistart --help+**)
966cef
 +
966cef
-WARNING: Passwords specified on the kernel command line are visible for all users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the network, when using DHCP with DHCP root-path. You may want to use rd.iscsi.firmware.
966cef
+WARNING: Passwords specified on the kernel command line are visible for all
966cef
+users via the file _/proc/cmdline_ and via dmesg or can be sniffed on the
966cef
+network, when using DHCP with DHCP root-path.
966cef
+You may want to use rd.iscsi.firmware.
966cef
 
966cef
 **root=**_???_ **netroot=**iscsi **rd.iscsi.firmware=1**::
966cef
  will read the iscsi parameter from the BIOS firmware
966cef
@@ -715,7 +746,8 @@ ecryptfskey=/etc/keys/ecryptfs-trusted.blob
966cef
 
966cef
 Deprecated, renamed Options
966cef
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
966cef
-Here is a list of options, which were used in dracut prior to version 008, and their new replacement.
966cef
+Here is a list of options, which were used in dracut prior to version 008, and
966cef
+their new replacement.
966cef
 
966cef
 rdbreak:: rd.break
966cef
 
966cef
@@ -849,7 +881,8 @@ _/etc/conf.d/_::
966cef
     set in the configuration files.
966cef
 
966cef
 _/etc/cmdline_::
966cef
-    Can contain additional command line options. Deprecated, better use /etc/cmdline.d/*.conf.
966cef
+    Can contain additional command line options. Deprecated, better use
966cef
+    /etc/cmdline.d/*.conf.
966cef
 
966cef
 _/etc/cmdline.d/*.conf_::
966cef
     Can contain additional command line options.
966cef
diff --git a/dracut.conf.5.asc b/dracut.conf.5.asc
966cef
index 30b7e03..5c94118 100644
966cef
--- a/dracut.conf.5.asc
966cef
+++ b/dracut.conf.5.asc
966cef
@@ -10,17 +10,19 @@ dracut.conf - configuration file(s) for dracut
966cef
 
966cef
 SYNOPSIS
966cef
 --------
966cef
-_/etc/dracut.conf_ _/etc/dracut.conf.d/*.conf_  _/usr/lib/dracut/dracut.conf.d/*.conf_
966cef
+_/etc/dracut.conf_ _/etc/dracut.conf.d/*.conf_
966cef
+_/usr/lib/dracut/dracut.conf.d/*.conf_
966cef
 
966cef
 Description
966cef
 -----------
966cef
 _dracut.conf_ is loaded during the initialisation phase of dracut. Command line
966cef
 parameter will overwrite any values set here.
966cef
 
966cef
-_*.conf_ files are read from /usr/lib/dracut/dracut.conf.d and /etc/dracut.conf.d.
966cef
-Files with the same name in /etc/dracut.conf.d will replace files in /usr/lib/dracut/dracut.conf.d.
966cef
-The files are then read in alphanumerical order and will overwrite parameters set in
966cef
-_/etc/dracut.conf_. Each line specifies an attribute and a value. A '#'
966cef
+_*.conf_ files are read from /usr/lib/dracut/dracut.conf.d and
966cef
+/etc/dracut.conf.d. Files with the same name in /etc/dracut.conf.d will replace
966cef
+files in /usr/lib/dracut/dracut.conf.d.
966cef
+The files are then read in alphanumerical order and will overwrite parameters
966cef
+set in _/etc/dracut.conf_. Each line specifies an attribute and a value. A '#'
966cef
 indicates the beginning of a comment; following characters, up to the end of the
966cef
 line are not interpreted.
966cef
 
966cef
@@ -84,7 +86,8 @@ Configuration files must have the extension .conf; other extensions are ignored.
966cef
 
966cef
 [WARNING]
966cef
 ====
966cef
-If chrooted to another root other than the real root device, use --fstab and provide a valid _/etc/fstab_.
966cef
+If chrooted to another root other than the real root device, use --fstab and
966cef
+provide a valid _/etc/fstab_.
966cef
 ====
966cef
 
966cef
 *use_fstab=*"__{yes|no}__"::
966cef
@@ -163,7 +166,8 @@ If chrooted to another root other than the real root device, use --fstab and pro
966cef
     See dracut/modules.d/10i18n/README for a detailed description.
966cef
 
966cef
 *i18n_default_font=*"__<fontname>__"::
966cef
-    The font <fontname> to install, if not specified otherwise. Default is "LatArCyrHeb-16".
966cef
+    The font <fontname> to install, if not specified otherwise.
966cef
+    Default is "LatArCyrHeb-16".
966cef
 
966cef
 *i18n_install_all=*"__{yes|no}__"::
966cef
     Install everything regardless of generic or hostonly mode.
966cef
diff --git a/dracut.modules.7.asc b/dracut.modules.7.asc
966cef
index 17acdb4..e94670f 100644
966cef
--- a/dracut.modules.7.asc
966cef
+++ b/dracut.modules.7.asc
966cef
@@ -96,8 +96,8 @@ This hooks (initqueue/settled) gets executed every time udev has settled.
966cef
 
966cef
 ==== Initqueue timeout
966cef
 
966cef
-This hooks (initqueue/timeout) gets executed, when the main loop counter becomes half of the
966cef
-rd.retry counter.
966cef
+This hooks (initqueue/timeout) gets executed, when the main loop counter becomes
966cef
+half of the rd.retry counter.
966cef
 
966cef
 ==== Initqueue finished
966cef
 
966cef
@@ -133,7 +133,8 @@ needed anymore.
966cef
 Init (or systemd) kills all udev processes, cleans up the environment,
966cef
 sets up the arguments for the real init process and finally calls switch_root.
966cef
 switch_root removes the whole filesystem hierarchy of the initramfs,
966cef
-chroot()s to the real root device and calls /sbin/init with the specified arguments.
966cef
+chroot()s to the real root device and calls /sbin/init with the specified
966cef
+arguments.
966cef
 
966cef
 To ensure all files in the initramfs hierarchy can be removed, all processes
966cef
 still running from the initramfs should not have any open file descriptors left.
966cef
@@ -225,50 +226,56 @@ depends on.
966cef
 
966cef
 === module-setup.sh: cmdline()
966cef
 
966cef
-This function should print the kernel command line options needed to boot the current
966cef
-machine setup. It should start with a space and should not print a newline.
966cef
+This function should print the kernel command line options needed to boot the
966cef
+current machine setup. It should start with a space and should not print a
966cef
+newline.
966cef
 
966cef
 === module-setup.sh: install()
966cef
 
966cef
-The install() function is called to install everything non-kernel related. To install
966cef
-binaries, scripts, and other files, you can use the functions mentioned in <<creation>>.
966cef
+The install() function is called to install everything non-kernel related.
966cef
+To install binaries, scripts, and other files, you can use the functions
966cef
+mentioned in <<creation>>.
966cef
 
966cef
 To address a file in the current module directory, use the variable "$moddir".
966cef
 
966cef
 === module-setup.sh: installkernel()
966cef
 
966cef
-In installkernel() all kernel related files should be installed. You can use all of the functions
966cef
-mentioned in <<creation>> to install files.
966cef
+In installkernel() all kernel related files should be installed. You can use all
966cef
+of the functions mentioned in <<creation>> to install files.
966cef
 
966cef
 === [[creation]]Creation Functions
966cef
 
966cef
 ==== inst_multiple [-o] <file> [ <file> ...]
966cef
 
966cef
-installs multiple binaries and files. If executables are specified without a path, dracut
966cef
-will search the path PATH=/usr/sbin:/sbin:/usr/bin:/bin for the binary. If the option "-o"
966cef
-is given as the first parameter, a missing file does not lead to an error.
966cef
+installs multiple binaries and files. If executables are specified without a
966cef
+path, dracut will search the path PATH=/usr/sbin:/sbin:/usr/bin:/bin for the
966cef
+binary. If the option "-o" is given as the first parameter, a missing file does
966cef
+not lead to an error.
966cef
 
966cef
 ==== inst <src> [<dst>]
966cef
 
966cef
-installs _one_ file <src> either to the same place in the initramfs or to an optional <dst>.
966cef
+installs _one_ file <src> either to the same place in the initramfs or to an
966cef
+optional <dst>.
966cef
 
966cef
 ==== inst_hook <hookdir> <prio> <src>
966cef
 
966cef
-installs an executable/script <src> in the dracut hook <hookdir> with priority <prio>.
966cef
+installs an executable/script <src> in the dracut hook <hookdir> with priority
966cef
+<prio>.
966cef
 
966cef
 ==== inst_rules <udevrule> [ <udevrule> ...]
966cef
 
966cef
-installs one ore more udev rules. Non-existant udev rules are reported, but do not let dracut fail.
966cef
+installs one ore more udev rules. Non-existant udev rules are reported, but do
966cef
+not let dracut fail.
966cef
 
966cef
 ==== instmods <kernelmodule> [ <kernelmodule> ... ]
966cef
 
966cef
 instmods should be used only in the installkernel() function.
966cef
 
966cef
-instmods installs one or more kernel modules in the initramfs. <kernelmodule> can also be a whole
966cef
-subsystem, if prefixed with a "=", like "=drivers/net/team".
966cef
+instmods installs one or more kernel modules in the initramfs. <kernelmodule>
966cef
+can also be a whole subsystem, if prefixed with a "=", like "=drivers/net/team".
966cef
 
966cef
-instmods will not install the kernel module, if $hostonly is set and the kernel module is not currently
966cef
-needed by any /sys/*...*/uevent MODALIAS.
966cef
+instmods will not install the kernel module, if $hostonly is set and the kernel
966cef
+module is not currently needed by any /sys/*...*/uevent MODALIAS.
966cef
 To install a kernel module regardless of the hostonly mode use the form:
966cef
 ----
966cef
 hostonly='' instmods <kernelmodule>
966cef
diff --git a/dracut.usage.asc b/dracut.usage.asc
966cef
index 6d37920..0b874e6 100644
966cef
--- a/dracut.usage.asc
966cef
+++ b/dracut.usage.asc
966cef
@@ -43,7 +43,8 @@ pieces. At least keep a copy of a general purpose image (and corresponding
966cef
 kernel) as a fallback to rescue your system.
966cef
 
966cef
 === Inspecting the Contents
966cef
-To see the contents of the image created by dracut, you can use the lsinitrd tool.
966cef
+To see the contents of the image created by dracut, you can use the lsinitrd
966cef
+tool.
966cef
 ----
966cef
 # lsinitrd | less
966cef
 ----
966cef
@@ -105,10 +106,11 @@ the grub menu.
966cef
 The kernel command line can also be provided by the dhcp server with the
966cef
 root-path option. See <<NetworkBoot>>.
966cef
 
966cef
-For a full reference of all kernel command line parameters, see *dracut.cmdline*(5).
966cef
+For a full reference of all kernel command line parameters,
966cef
+see *dracut.cmdline*(5).
966cef
 
966cef
-To get a quick start for the suitable kernel command line on your system, use the
966cef
-__--print-cmdline__ option:
966cef
+To get a quick start for the suitable kernel command line on your system,
966cef
+use the __--print-cmdline__ option:
966cef
 ----
966cef
 # dracut --print-cmdline
966cef
  root=UUID=8b8b6f91-95c7-4da2-831b-171e12179081 rootflags=rw,relatime,discard,data=ordered rootfstype=ext4
966cef
@@ -183,7 +185,8 @@ logical partition would contain:
966cef
 rd.luks=0 rd.lvm=0 rd.md=0 rd.dm=0
966cef
 ----
966cef
 
966cef
-This turns off every automatic assembly of LVM, MD raids, DM raids and crypto LUKS.
966cef
+This turns off every automatic assembly of LVM, MD raids, DM raids and
966cef
+crypto LUKS.
966cef
 
966cef
 Of course, you could also omit the dracut modules in the initramfs creation
966cef
 process, but then you would lose the posibility to turn it on on demand.
966cef
@@ -193,12 +196,14 @@ process, but then you would lose the posibility to turn it on on demand.
966cef
 === Injecting custom Files
966cef
 To add your own files to the initramfs image, you have several possibilities.
966cef
 
966cef
-The --include option let you specify a source path and a target path. For example
966cef
+The --include option let you specify a source path and a target path.
966cef
+For example
966cef
 ----
966cef
 # dracut --include cmdline-preset /etc/cmdline.d/mycmdline.conf initramfs-cmdline-pre.img
966cef
 ----
966cef
 will create an initramfs image, where the file cmdline-preset will be copied
966cef
-inside the initramfs to _/etc/cmdline.d/mycmdline.conf_. --include can only be specified once.
966cef
+inside the initramfs to _/etc/cmdline.d/mycmdline.conf_. --include can only
966cef
+be specified once.
966cef
 
966cef
 
966cef
 ----
966cef
@@ -261,8 +266,8 @@ server about the ip adress for the machine. The dhcp server can also serve an
966cef
 additional root-path, which will set the root device for dracut. With this
966cef
 mechanism, you have static configuration on your client machine and a
966cef
 centralized boot configuration on your TFTP/DHCP server. If you can't pass a
966cef
-kernel command line, then you can inject _/etc/cmdline.d/mycmdline.conf_, with a method described
966cef
-in <<Injecting>>.
966cef
+kernel command line, then you can inject _/etc/cmdline.d/mycmdline.conf_, with a
966cef
+method described in <<Injecting>>.
966cef
 
966cef
 ==== Reducing the Image Size
966cef
 
966cef
@@ -306,10 +311,11 @@ dracut be unable to locate your root device
966cef
 . Add ''rd.shell rd.debug log_buf_len=1M'' to the kernel command line so that
966cef
 dracut shell commands are printed as they are executed
966cef
 . The file /run/initramfs/rdsosreport.txt is generated,
966cef
-which contains all the logs and the output of all significant tools, which are mentioned later.
966cef
+which contains all the logs and the output of all significant tools, which are
966cef
+mentioned later.
966cef
 
966cef
-If you want to save that output, simply mount /boot by hand or insert an USB stick and mount that.
966cef
-Then you can store the output for later inspection.
966cef
+If you want to save that output, simply mount /boot by hand or insert an USB
966cef
+stick and mount that. Then you can store the output for later inspection.
966cef
 
966cef
 [[information-to-include-in-your-report]]
966cef
 === Information to include in your report
966cef
@@ -420,7 +426,8 @@ title Fedora (2.6.29.5-191.fc11.x86_64)
966cef
   initrd /dracut-2.6.29.5-191.fc11.x86_64.img
966cef
 ----
966cef
 +
966cef
-. If system boot fails, you will be dropped into a shell as seen in the example below.
966cef
+. If system boot fails, you will be dropped into a shell as seen in the example
966cef
+below.
966cef
 +
966cef
 ----
966cef
 No root device found
966cef
@@ -429,7 +436,8 @@ Dropping to debug shell.
966cef
 #
966cef
 ----
966cef
 +
966cef
-. Use this shell prompt to gather the information requested above (see <<all-bug-reports>>).
966cef
+. Use this shell prompt to gather the information requested above
966cef
+(see <<all-bug-reports>>).
966cef
 
966cef
 [[accessing-the-root-volume-from-the-dracut-shell]]
966cef
 ==== Accessing the root volume from the dracut shell
966cef
@@ -439,8 +447,10 @@ root volume is configured. Common scenarios include:
966cef
 
966cef
 * A block device (e.g. _/dev/sda7_)
966cef
 * A LVM logical volume (e.g. _/dev/VolGroup00/LogVol00_)
966cef
-* An encrypted device (e.g. _/dev/mapper/luks-4d5972ea-901c-4584-bd75-1da802417d83_)
966cef
-* A network attached device (e.g. netroot=iscsi:@192.168.0.4::3260::iqn.2009-02.org.fedoraproject:for.all)
966cef
+* An encrypted device
966cef
+  (e.g. _/dev/mapper/luks-4d5972ea-901c-4584-bd75-1da802417d83_)
966cef
+* A network attached device
966cef
+  (e.g. _netroot=iscsi:@192.168.0.4::3260::iqn.2009-02.org.example:for.all_)
966cef
 
966cef
 The exact method for locating and preparing will vary. However, to continue with
966cef
 a successful boot, the objective is to locate your root volume and create a
966cef
@@ -522,5 +532,6 @@ To do this from an already booted system:
966cef
 # touch /run/initramfs/.need_shutdown
966cef
 ----
966cef
 
966cef
-This will give you a dracut shell after the system pivot'ed back in the initramfs.
966cef
+This will give you a dracut shell after the system pivot'ed back in the
966cef
+initramfs.
966cef
 
966cef
diff --git a/mkinitrd.8.asc b/mkinitrd.8.asc
966cef
index 25661c8..146a6d0 100644
966cef
--- a/mkinitrd.8.asc
966cef
+++ b/mkinitrd.8.asc
966cef
@@ -41,8 +41,8 @@ OPTIONS
966cef
 
966cef
 **--preload=<module>**::
966cef
      preload the kernel module <module> in the initramfs before any other kernel
966cef
-     modules are loaded. This can be used to ensure a certain device naming, which
966cef
-     should in theory be avoided and the use of symbolic links in /dev is
966cef
+     modules are loaded. This can be used to ensure a certain device naming,
966cef
+     which should in theory be avoided and the use of symbolic links in /dev is
966cef
      encouraged.
966cef
 
966cef
 **--nocompress**::