[Pkg-sysvinit-devel] Bug#905244: fstab-decode.8: Some formatting fixes in the manual

[Bjarni Ingi Gislason]

Package: sysvinit-utils
Version: 2.88dsf-59.10
Severity: minor
Tags: patch

  Summary:

Separate an ellipsis from the preceding string with a space.

Add a missing italic correction or use a macro.

Make a '"' being an argument to a macro

####

  Details:

Input file is fstab-decode.8

Test nr. 10:

Separate an ellipsis from the preceding string with a space
character, if it does not mean a continuation of it.

See a manual of style about the difference between "abc..." and
"abc ...".

25:\fB fstab-decode\fR \fICOMMAND\fR [\fIARGUMENT\fR]...

#####


Test nr. 21:

Use a macro to change to the italic font, instead of \fI [1], if
possible.
The macros have the italic corrections, but "\c" removes them.

  Or

add the italic corrections.
[1] man-pages(7) [package "manpages"]

25:\fB fstab-decode\fR \fICOMMAND\fR [\fIARGUMENT\fR]...
29:decodes escapes in the specified \fIARGUMENT\fRs
30:and uses them to run \fICOMMAND\fR.
41:Otherwise it exits with the status returned by \fICOMMAND\fR.

#####

  Make a quotation mark (") to be an argument to a macro.

  This fixes bug #567071

###

  Patch:

--- fstab-decode.8	2017-09-08 19:18:37.000000000 +0000
+++ fstab-decode.8.new	2018-08-01 23:51:30.000000000 +0000
@@ -22,11 +22,11 @@
 fstab-decode \- run a command with fstab-encoded arguments
 
 .SH SYNOPSIS
-\fB fstab-decode\fR \fICOMMAND\fR [\fIARGUMENT\fR]...
+\fB fstab-decode\fR \fICOMMAND\fR [\,\fIARGUMENT\fR \&.\|.\|.\&]
 
 .SH DESCRIPTION
 .B fstab-decode
-decodes escapes in the specified \fIARGUMENT\fRs
+decodes escapes in the specified \fIARGUMENT\/\fRs
 and uses them to run \fICOMMAND\fR.
 The argument escaping uses the same rules as path escaping in
 \fB/etc/fstab\fR,
@@ -42,4 +42,4 @@ Otherwise it exits with the status retur
 
 .SH EXAMPLES
 
-.B fstab-decode umount $(awk '$3 == "vfat" { print $2 }' /etc/fstab)
+.B fstab-decode umount $(awk '$3 == """vfat""" { print $2 }' /etc/fstab)


-- System Information:
Debian Release: buster/sid
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 4.17.8-3 (SMP w/2 CPU cores)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages sysvinit-utils depends on:
ii  init-system-helpers  1.51
ii  libc6                2.27-5
ii  util-linux           2.32-0.1

sysvinit-utils recommends no packages.

sysvinit-utils suggests no packages.

-- no debconf information

-- 
Bjarni I. Gislason