[kbd] Problems in codepage.1, loadkeys.1

esr at thyrsus.com esr at thyrsus.com
Tue Jun 12 22:16:13 MSK 2018


This is automatically generated email about markup problems in a man
page for which you appear to be responsible.  If you are not the right
person or list, please tell me so I can correct my database.

See http://catb.org/~esr/doclifter/bugs.html for details on how and
why these patches were generated.  Feel free to email me with any
questions.  Note: These patches do not change the modification date of
any manual page.  You may wish to do that by hand.

I apologize if this message seems spammy or impersonal. The volume of
markup bugs I am tracking is over five hundred - there is no real
alternative to generating bugmail from a database and template.

--
                             Eric S. Raymond
-------------- next part --------------
Problems with codepage.1:

Broken command synopsis syntax.  This may mean you're using a
construction in the command synopsis other than the standard
[ ] | { }, or it may mean you have running text in the command synopsis
section (the latter is not technically an error, but most cases of it
are impossible to translate into DocBook markup), or it may mean the
command syntax fails to match the description.

The incorrect sytntax used to express option alternation cannot be lifted
to XML.  In addition, use of <> around the filename argument violates
the normal convention and is unparseable.

--- codepage.1-unpatched	2010-07-24 20:52:28.000000000 -0400
+++ codepage.1	2010-07-24 20:53:50.000000000 -0400
@@ -7,16 +7,16 @@
 .B codepage 
 [ 
 .I \-c 
-] | [ 
+| 
 .I \-l
-] | 
+| 
 .I \-L 
-] | [
+|
 .I \-a 
 | 
 .I nnn
 ] 
-.I <file.cpi>
+.I file.cpi
 
 .SH DESCRIPTION
 The
-------------- next part --------------
Problems with loadkeys.1:

Unbalanced group in command synopsis. You probably forgot
to open or close a [ ] or { } group properly.

--- loadkeys.1-unpatched	2018-05-16 19:54:23.148111507 -0400
+++ loadkeys.1	2018-05-16 19:57:02.391029285 -0400
@@ -7,7 +7,6 @@
 [
 .I -a --ascii
 ] [
-[
 .I -b --bkeymap
 ] [
 .I -c --clearcompose


More information about the kbd mailing list