From ad2a42ce9eb83ed54c39c31c5f44afeeb2b515a6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jan=20H=C3=B6ppner?= Date: Tue, 14 May 2024 10:12:26 +0200 Subject: [PATCH] dasdfmt: Fix missing hyphen escapes in the man page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hyphens are converted by groff to a different unicode character leading to failing command execution of copy-pasted options or examples. Ensure that all hyphens are properly escaped. Reviewed-by: Stefan Haberland Signed-off-by: Jan Höppner Signed-off-by: Steffen Eiden --- dasdfmt/dasdfmt.8 | 64 +++++++++++++++++++++++------------------------ 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/dasdfmt/dasdfmt.8 b/dasdfmt/dasdfmt.8 index eb004756..aa520c18 100644 --- a/dasdfmt/dasdfmt.8 +++ b/dasdfmt/dasdfmt.8 @@ -7,11 +7,11 @@ dasdfmt \- formatting of DASD (ECKD) disk drives. .SH SYNOPSIS -\fBdasdfmt\fR [-h] [-t] [-v] [-y] [-p] [-P] [-m \fIstep\fR] +\fBdasdfmt\fR [\-h] [\-t] [\-v] [\-y] [\-p] [\-P] [\-m \fIstep\fR] .br - [-r \fIcylinder\fR] [-b \fIblksize\fR] [-l \fIvolser\fR] [-d \fIlayout\fR] + [\-r \fIcylinder\fR] [\-b \fIblksize\fR] [\-l \fIvolser\fR] [\-d \fIlayout\fR] .br - [-L] [-V] [-F] [-k] [-C] [-M \fImode\fR] \fIdevice\fR + [\-L] [\-V] [\-F] [\-k] [\-C] [\-M \fImode\fR] \fIdevice\fR .SH DESCRIPTION \fBdasdfmt\fR formats a DASD (ECKD) disk drive to prepare it @@ -26,26 +26,26 @@ Any device node created by udev for kernel 2.6 can be used .SH OPTIONS .TP -\fB-h\fR or \fB--help\fR +\fB\-h\fR or \fB\-\-help\fR Print usage and exit. .TP -\fB-t\fR or \fB--test\fR +\fB\-t\fR or \fB\-\-test\fR Disables any modification of the disk drive. .br \fBdasdfmt\fR just prints out, what it \fBwould\fR do. .TP -\fB-v\fR +\fB\-v\fR Increases verbosity. .TP -\fB-y\fR +\fB\-y\fR Start formatting without further user-confirmation. .TP -\fB--norecordzero\fR +\fB\-\-norecordzero\fR Remove permission for subsystem to format write record zero. .br This is an expert option: Per default in recent dasd drivers, subsystems are @@ -54,32 +54,32 @@ to remove this permission. .br .TP -\fB-L\fR or \fB--no_label\fR +\fB\-L\fR or \fB\-\-no_label\fR Omit the writing of a disk label after formatting. .br This makes only sense for the 'ldl' disk layout. .br -The '-L' option has to be specified after the '-d ldl' option. +The '\-L' option has to be specified after the '\-d ldl' option. .br -e.g. dasdfmt -d ldl -L /dev/... +e.g. dasdfmt \-d ldl \-L /dev/... .TP -\fB-V\fR or \fB--version\fR +\fB\-V\fR or \fB\-\-version\fR Print version number and exit. .TP -\fB-F\fR or \fB--force\fR +\fB\-F\fR or \fB\-\-force\fR Formats the device without performing sanity checking. .TP -\fB-C\fR or \fB--check_host_count\fR +\fB\-C\fR or \fB\-\-check_host_count\fR Force dasdfmt to check the host access open count to ensure the device is not online on another operating system instance .TP -\fB-d\fR \fIlayout\fR or \fB--disk_layout\fR=\fIlayout\fR +\fB\-d\fR \fIlayout\fR or \fB\-\-disk_layout\fR=\fIlayout\fR Formats the device with compatible disk layout or linux disk layout. \fIlayout\fR is either \fIcdl\fR for the compatible disk layout (default) or \fIldl\fR for the linux disk layout. @@ -95,24 +95,24 @@ Do not use this option if you are using a 3270 console, running in background or redirecting the output to a file. .TP -\fB-P\fR or \fB--percentage\fR +\fB\-P\fR or \fB\-\-percentage\fR Print one line for each formatted cylinder showing the number of the cylinder and percentage of formatting process. Intended to be used by higher level interfaces. .TP -\fB-m\fR \fIstep\fR or \fB--hashmarks\fR=\fIstep\fR +\fB\-m\fR \fIstep\fR or \fB\-\-hashmarks\fR=\fIstep\fR Print a hashmark every \fIstep\fR cylinders. The value \fIstep\fR has to be within range [1,1000], otherwise it will be set to the default, which is 10. .br You can use this option to see the progress of formatting in case you -are not able to use the progress bar option -p, e.g. with a 3270 +are not able to use the progress bar option \-p, e.g. with a 3270 terminal. .br -The value will be at least as big as the -r or --requestsize value. +The value will be at least as big as the \-r or \-\-requestsize value. .br .TP -\fB-M\fR \fImode\fR or \fB--mode\fR=\fImode\fR +\fB\-M\fR \fImode\fR or \fB\-\-mode\fR=\fImode\fR Specify the \fImode\fR to be used to format the device. Valid modes are: .RS .IP full @@ -122,12 +122,12 @@ Format the first two tracks and write label and partition information. .br Use this option for DASD ESE volumes to take the benefits of thin provisioning. In this case, a full space release precedes the formatting step. If this space -release fails, then the formatting also fails. Specify the \fB--no-discard\fR +release fails, then the formatting also fails. Specify the \fB\-\-no\-discard\fR option to omit the space release. .br For non-ESE volumes use this option only if you are sure that the target DASD already contains a regular format with the specified blocksize. A blocksize can -optionally be specified using \fB-b\fR (\fB--blocksize\fR). +optionally be specified using \fB\-b\fR (\fB\-\-blocksize\fR). .IP expand Format all unformatted tracks at the end of the target DASD. This mode assumes @@ -135,20 +135,20 @@ that tracks at the beginning of the DASD volume have already been correctly formatted, while a consecutive set of tracks at the end are unformatted. You can use this mode to make added space available for Linux use after dynamically increasing the size of a DASD volume. A blocksize can optionally be specified -using \fB-b\fR (\fB--blocksize\fR). +using \fB\-b\fR (\fB\-\-blocksize\fR). .RE .TP -\fB--check\fR +\fB\-\-check\fR Perform a complete format check on a DASD volume. A blocksize can be specified -with \fB-b\fR (\fB--blocksize\fR). +with \fB\-b\fR (\fB\-\-blocksize\fR). .TP -\fB--no-discard\fR +\fB\-\-no\-discard\fR Omit a full space release when formatting a thin-provisioned DASD ESE volume. .TP -\fB-r\fR \fIcylindercount\fR or \fB--requestsize\fR=\fIcylindercount\fR +\fB\-r\fR \fIcylindercount\fR or \fB\-\-requestsize\fR=\fIcylindercount\fR Number of cylinders to be processed in one formatting step. The value must be an integer in the range 1 - 255. .br @@ -158,19 +158,19 @@ devices, counting the base device and all alias devices. .br .TP -\fB-b\fR \fIblksize\fR or \fB--blocksize\fR=\fIblksize\fR +\fB\-b\fR \fIblksize\fR or \fB\-\-blocksize\fR=\fIblksize\fR Specify blocksize to be used. \fIblksize\fR must be a positive integer and always be a power of two. The recommended blocksize is 4096 bytes. .TP -\fB-l\fR \fIvolser\fR or \fB--label\fR=\fIvolser\fR +\fB\-l\fR \fIvolser\fR or \fB\-\-label\fR=\fIvolser\fR Specify the volume serial number or volume identifier to be written to disk after formatting. If no label is specified, a sensible default is used. \fIvolser\fR is interpreted as ASCII string and is automatically converted to uppercase and then to EBCDIC. .br -e.g. -l LNX001 or --label=DASD01 +e.g. \-l LNX001 or \-\-label=DASD01 .br The \fIvolser\fR identifies by serial number the volume. A volume serial @@ -192,11 +192,11 @@ NOTE: Try to avoid using special characters in the volume serial. This may cause In case you really have to use special characters, make sure you are using quotes. In addition there is a special handling for the '$' sign. Please specify it using '\\$' if necessary. .br -e.g. -l 'a@b\\$c#' to get A@B$C# +e.g. \-l 'a@b\\$c#' to get A@B$C# .br .TP -\fB-k\fR or \fB--keep_volser\fR +\fB\-k\fR or \fB\-\-keep_volser\fR Keeps the Volume Serial Number when writing the Volume Label. This is useful if the volume already has a Serial Number that should not be overwritten. .br