Bug#905244: fstab-decode.8: Some formatting fixes in the manual

[Dmitry Bogatov]

Jesse, what do you think?

[2018-08-02 01:07] Bjarni Ingi Gislason <bjarniig at rhi.hi.is>
> 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=IS
> O-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
>
-- 
        Note, that I send and fetch email in batch, once every 24 hours.
                 If matter is urgent, try https://t.me/kaction
                                                                             --