Package: file
Version: 1:5.44-3
Severity: minor
Tags: patch

Dear Maintainer,

here are some notes and fixes for the man page.

####

Input file is file.1

Output from "mandoc -T lint file.1":

  Not in the patch

mandoc: file.1:52:2: STYLE: useless macro: Tn
mandoc: file.1:97:2: STYLE: useless macro: Tn

  In the patch

mandoc: file.1:391:9: STYLE: no blank before trailing delimiter: Em Note:
mandoc: file.1:521:33: WARNING: undefined escape, printing literally: \ 
#######

Change '-' (\-) to '\(en' (en-dash) for a numeric range.

file.1:628:2007-2011, to improve MIME support, merge MIME and non-MIME magic,

#####

Mark a full stop (.) with "\&",
if it does not mean an end of a sentence.
This is a preventive action,
the paragraph could be reshaped, e.g., after changes.

When typing, one does not always notice when the line wraps after the
period.
There are too many examples of input lines in manual pages,
that end with an abbreviation point.

This marking is robust, and independent of the position on the line.

It corresponds to "\ " in TeX, and to "@:" in Texinfo.


386:i.e. when the
688:Make file -ki work, i.e. give multiple MIME types.
696:types (e.g. have a magic value for !:mime which causes the resulting

#####

Output from "test-nroff -man -b -ww -z":

[ "test-groff" is a developmental version of "groff" ]

Input file is ./file.1

Output from test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z :

troff: backtrace: file '/tmp/chk_manuals.temp.A0PKLx':521
troff:/tmp/chk_manuals.temp.A0PKLx:521: warning: escape character ignored 
before a tab character

####

--- file.1      2023-06-20 15:09:55.000000000 +0000
+++ file.1.new  2023-06-20 20:28:01.000000000 +0000
@@ -383,12 +383,12 @@ option disables sandboxing which is enab
 This option is needed for
 .Nm
 to execute external decompressing programs,
-i.e. when the
+i.e.\& when the
 .Fl z
 option is specified and the built-in decompressors are not available.
 On systems where sandboxing is not available, this option has no effect.
 .Pp
-.Em Note:
+.Em Note :
 This Debian version of file was built without seccomp support, so this option
 has no effect.
 .It Fl v , Fl Fl version
@@ -518,7 +518,7 @@ is that this version treats any white sp
 as a delimiter, so that spaces in pattern strings must be escaped.
 For example,
 .Bd -literal -offset indent
-\*[Gt]10       string  language impress\       (imPRESS data)
+\*[Gt]10       string  language impress        (imPRESS data)
 .Ed
 .Pp
 in an existing magic file would have to be changed to
@@ -625,7 +625,7 @@ of non-ASCII files.
 .Pp
 Altered by Reuben Thomas
 .Aq r...@sc3d.org ,
-2007-2011, to improve MIME support, merge MIME and non-MIME magic,
+2007\(en2011, to improve MIME support, merge MIME and non-MIME magic,
 support directories as well as files of magic, apply many bug fixes,
 update and fix a lot of magic, improve the build system, improve the
 documentation, and rewrite the Python bindings in pure Python.
@@ -685,7 +685,7 @@ pointers to relative offsets from the st
 .Pp
 Add syntax for relative offsets after current level (Debian bug #466037).
 .Pp
-Make file -ki work, i.e. give multiple MIME types.
+Make file \-ki work, i.e.\& give multiple MIME types.
 .Pp
 Add a zip library so we can peek inside Office2007 documents to
 print more details about their contents.
@@ -693,7 +693,7 @@ print more details about their contents.
 Add an option to print URLs for the sources of the file descriptions.
 .Pp
 Combine script searches and add a way to map executable names to MIME
-types (e.g. have a magic value for !:mime which causes the resulting
+types (e.g.\& have a magic value for !:mime which causes the resulting
 string to be looked up in a table).
 This would avoid adding the same magic repeatedly for each new
 hash-bang interpreter.


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

Kernel: Linux 6.1.27-1 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages file depends on:
ii  libc6      2.36-9
ii  libmagic1  1:5.44-3

file recommends no packages.

file suggests no packages.

-- no debconf information

Reply via email to