Merge ~mclemenceau/casper:master into casper:master

[Matthieu Clemenceau]

document more cmdline options available (LP: #1875548)

Proposed update to casper man page to reflect some undocumented cmdline options
In (LP: #1875548) people wonder how to disable the boot file system check.
The options wasn't documented anywhere.
I reviewed casper sources and identified cmdline options that were not documented in the man page.

[Dimitri John Ledkov (xnox)]

Really good!

review: Approve

[Dimitri John Ledkov (xnox)]

If the git changelog was formatted like this:

"""
Update manpage with undocumented cmdline options

LP: #1875548
"""

gbp dch (from git-buildpackage) could have been used to autogenerate debian/changelog.

Also, style wise. Normally one just ends the changelog entry with "(LP: #NNNN)" or "LP: #NNNN" without explicitely making it a sentence i.e. "Resolve (LP: #NNNN)". It is widely understood that LP: # closes a bug number.

review: Approve (just an fyi for the future)

diff --git a/debian/changelog b/debian/changelog
index 7946eec..e520a6b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+casper (1.446ubuntu1) UNRELEASED; urgency=medium
+
+  * Updated cmdline options in casper manpage documentation. Resolve (LP: #1875548)
+
+ -- Matthieu Clemenceau <[e-mail]>  Tue, 12 May 2020 16:29:57 -0500
+
 casper (1.446) groovy; urgency=medium
 
   * control: add fdisk dependency
diff --git a/debian/manpage/casper.7 b/debian/manpage/casper.7
index 303afa1..3ee0629 100644
--- a/debian/manpage/casper.7
+++ b/debian/manpage/casper.7
@@ -18,10 +18,13 @@ This enables a special "serial" login shell (experimental).
 .B xdebconf
 uses xdebconfigurator, if present on the rootfs, to configure X instead of the standard procedure (experimental).
 .TP
+.BI fsck.mode=skip
+Let you skip the file system check on boot.
+.TP
 .BI "hostname=" HOSTNAME " , userfullname=" USERFULLNAME " , username=" USERNAME
 Those parameters lets you override values read from the config file.
 .TP
-.BI "{keyb|kbd-chooser/method}=" KEYBOARD " , {klayout|console-setup/layoutcode}=" LAYOUT " , {kvariant|console-setup/variantcode}=" VARIANT " , {kmodel|console-setup/modelcode}=" CODE " ,  koptions=" OPTIONS
+.BI "{keyb|kbd-chooser/method}=" KEYBOARD " , {klayout|console-setup/layoutcode|keyboard-configuration/layoutcode}=" LAYOUT " , {kvariant|console-setup/variantcode|keyboard-configuration/variantcode}=" VARIANT " , {kmodel|console-setup/modelcode|keyboard-configuration/modelcode}=" CODE " ,  koptions=" OPTIONS
 Configure the running keyboard as specified, if this one misses casper behaves as if "keyb=us" was specified. It will be interfered from "locale=" if locale is only 2 lowecase letters as a special case. You could also specify console layout, variant, code, and options (no defaults).
 .TP
 .BI ip= IFACE,ADDRESS,NETMASK,GATEWAY [ :IFACE,ADDRESS,NETMASK,GATEWAY "]*"
@@ -42,13 +45,16 @@ Sets the path to the live filesystem on the medium. By default, it is set to "/c
 .BI "layerfs-path=" PATH
 Sets the path to the leaf layer of an overlay-compatible multi-layer live filesystem on the medium. By default, it is not set and multi layer is disabled and falls back to the default behaviour of casper. A relative path uses "live-mediate-path" as root directory. All the layer images of the same hierarchy must be in the same directory.
 .TP
-.BI "locale=" LOCALE " | debian-installer/locale=" LOCALE
-Configure the running locale as specified, if not present the live-media rootfs configured locale will be used and if also this one misses casper behave as "locale=en_US.UTF-8" was specified. If only 2 lowercase letter are specified (like "it"), the "maybe wanted" locale is generated (like it:IT.UTF-8), in this case if also "keyb=" is unspecified is set with those 2 lowercase letters (keyb=it).
+.BI "locale=" LOCALE " | debian-installer/locale=" LOCALE | debian-installer/language=" LANG
+Configure the running locale as specified, if not present the live-media rootfs configured locale will be used and if also this one misses casper behave as "locale=en_US.UTF-8" was specified. If only 2 lowercase letter are specified (like "it"), the "maybe wanted" locale is generated (like it:IT.UTF-8), in this case if also "keyb=" is unspecified is set with those 2 lowercase letters (keyb=it). if debian-installer/language is set, it will choose the appropriate locale corresponding to this language (it,fr,us,...) 
+.TP
+.BI debian-installer/driver-update=
+Add a ubiquity hook to install driver-updates to the target system.
 .TP
 .BR "netboot[=" nfs "|" cifs "|" url ]
 This tells casper to perform a network mount. The parameter "nfsroot=" (with optional "nfsopts="), should specify where is the location of the root filesystem.  With no args, will try cifs first, and if it fails nfs. If url method is chosen, "url=" parameter should point to the location of the ".iso" that will be downloaded and mounted. Note "url=" on the commandline alone, by default sets "netboot=url" method too.
 .TP
-.BR "url=" URL
+.BI preseed/url|url= URL
 This tells casper the download location of the installer ISO. The ISO will be downloaded and mounted. Networking is required for this option to work, which can be configured with "ip=" option. Note, setting this option, will also set "netboot=url" method.
 .TP
 .B persistent
@@ -60,10 +66,13 @@ disables the above mentioned "persistent" feature, useful if the bootloader (lik
 .BI "persistent-path=" PATH
 Casper will look for persistency files in the root directory of a partition. With this parameter, the path can be configured so that you can have multiple directories on the same partition to store persistency files.
 .TP
-.B "showmounts"
+.B serialtty=tty
+Redirect output to tty of choice for debugging purposes in live sessions
+.TP
+.B showmounts|show-cow
 This parameter will make casper to show on "/" the ro filesystems (mostly compressed) on /casper. This is not enabled by default because could lead to problems by applications like "mono" which store binary paths on installation.
 .TP
-.B textonly
+.B textonly|automatic-ubiquity|only-ubiquity|noninteractive
 Start up to text-mode shell prompts, disabling the graphical user interface.
 .TP
 .BI "todisk=" DEVICE 
@@ -94,6 +103,16 @@ may be told to generate a UUID by setting CASPER_GENERATE_UUID=1 when building t
 .TP
 .BI noprompt
 Do not prompt to eject the CD on reboot.
+.TP
+.BI access=[v1|v2|v3|m1|m2]
+Adding this parameter will tune the graphic configuration to different accessibility needs.
+access=v1 for Lesser Visual Impairment, access=v2 for Moderate Visual Impairment, access=v3 for Blindness, access=m1 for Minor motor difficulties and access and m2 for Motor difficulties with pointing devices.
+.TP
+.BI braille=ask
+Adding this parameter will enable graphic configuration for screen reader.
+.TP
+.BI xforcevesa
+Create basic xorg.conf to force VESA mode only which could help if no suitable video driver is available 
 
 .SH FILES
 .B /etc/casper.conf