Package: unicode
Version: 2.7-1
Severity: minor
Tags: patch
Dear Maintainer,
remove space at end of lines.
Fix warnings from test-groff.
Reduce space between words or start the sentence on a
new line.
Change a two-fonts macro to an one-font macro for a
single argument.
Change a HYPHEN-MINUS (code 0x55, 2D) to a dash
(minus) if it matches " -[:alpha:]" or \[aq]-[:alpha:] (for options).
Split long lines (> 80).
See man-pages(7) for guidelines.
###
Details:
Input file is paracode.1
Output from "mandoc -T lint paracode.1"
mandoc: paracode.1:7:19: STYLE: whitespace at end of input line
mandoc: paracode.1:32:79: STYLE: whitespace at end of input line
#####
Test nr. 2:
Enable and fix warnings from 'test-groff'.
[ "test-groff" is a developmental version of "groff" ]
Output from test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z :
<paracode.1>:26 (macro BI): only 1 argument, but more are expected
troff: backtrace: file '<paracode.1>':32
#####
Test nr. 12:
Reduce space between words.
44:paracode -t cherokee <input >output
46:paracode -r -t mirror <input >output
#####
Test nr. 16:
Use the correct macro for the font change of a single argument.
26:.BI \-\-tables
65:.BI \-r
#####
Test nr. 25:
Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.
7:.RI [ -t tables ]
42:paracode -t cyrillic+greek+cherokee
44:paracode -t cherokee <input >output
46:paracode -r -t mirror <input >output
67:Display text in reverse order after conversion, best used together with -t
mirror.
#####
Test nr. 37:
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
paracode.1: line 14 length 82
\fBparacode\fP exploits the full power of the Unicode standard to convert the
text
paracode.1: line 15 length 84
into visually similar stream of glyphs, while using completely different
codepoints.
paracode.1: line 16 length 81
It is an excellent didactic tool demonstrating the principles and advanced use
of
paracode.1: line 67 length 82
Display text in reverse order after conversion, best used together with -t
mirror.
#####
Test nr. 63:
Name of a manual is set in bold, the section in roman.
70:iconv(1)
###
Patch:
--- paracode.1 2020-10-11 21:30:00.000000000 +0000
+++ paracode.1.new 2020-10-11 22:00:50.000000000 +0000
@@ -4,7 +4,8 @@
paracode \- command line Unicode conversion tool
.SH SYNOPSIS
.B paracode
-.RI [ -t tables ]
+.RB [ \-t
+.IR tables ]
string
.SH DESCRIPTION
This manual page documents the
@@ -12,40 +13,38 @@ This manual page documents the
command.
.PP
\fBparacode\fP exploits the full power of the Unicode standard to convert the
text
-into visually similar stream of glyphs, while using completely different
codepoints.
+into visually similar stream of glyphs,
+while using completely different codepoints.
It is an excellent didactic tool demonstrating the principles and advanced use
of
the Unicode standard.
.PP
\fBparacode\fP is a command line tool working as
a filter, reading standard input in UTF-8 encoding and writing to
standard output.
-
+.
.SH OPTIONS
.TP
.BI \-t tables
-.BI \-\-tables
+.B \-\-tables
Use given list of conversion tables, separated by a plus sign.
Special name 'all' selects all the tables.
-Note that selecting 'other', 'cyrillic_plus' and 'cherokee' tables (and 'all')
+Note that selecting 'other', 'cyrillic_plus' and 'cherokee' tables (and 'all')
makes use of rather esoteric characters, and not all fonts contain them.
-
Special table 'mirror' uses quite different character substitution,
is not selected automatically with 'all' and does not work well
with anything except plain ascii alphabetical characters.
Example:
-paracode -t cyrillic+greek+cherokee
-
-paracode -t cherokee <input >output
-
-paracode -r -t mirror <input >output
+paracode \-t cyrillic+greek+cherokee
+paracode \-t cherokee <input >output
+paracode \-r \-t mirror <input >output
Possible tables are:
@@ -60,16 +59,16 @@ other
cherokee
all
-
+.
.TP
-.BI \-r
-
-Display text in reverse order after conversion, best used together with -t
mirror.
+.B \-r
+Display text in reverse order after conversion,
+best used together with \-t mirror.
+.
.SH SEE ALSO
-iconv(1)
-
-
+.BR iconv (1)
+.
.SH AUTHOR
Radovan Garab\('ik <garabik @ kassiopeia.juls.savba.sk>
-- System Information:
Debian Release: bullseye/sid
APT prefers testing
APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)
Kernel: Linux 5.8.10-1 (SMP w/2 CPU threads)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages unicode depends on:
ii python3 3.8.2-3
Versions of packages unicode recommends:
ii unicode-data 13.0.0-2
unicode suggests no packages.
-- no debconf information
--
Bjarni I. Gislason
