Linux console tools development discussion
 help / color / mirror / Atom feed
* [kbd] Problems in codepage.1, loadkeys.1
@ 2018-06-12 19:16 esr
  2018-10-02 20:36 ` Alexey Gladkov
  0 siblings, 1 reply; 2+ messages in thread
From: esr @ 2018-06-12 19:16 UTC (permalink / raw)
  To: kbd

[-- Attachment #1: Type: text/plain, Size: 708 bytes --]

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

[-- Attachment #2: Type: text/plain, Size: 879 bytes --]

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

[-- Attachment #3: Type: text/plain, Size: 330 bytes --]

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

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [kbd] Problems in codepage.1, loadkeys.1
  2018-06-12 19:16 [kbd] Problems in codepage.1, loadkeys.1 esr
@ 2018-10-02 20:36 ` Alexey Gladkov
  0 siblings, 0 replies; 2+ messages in thread
From: Alexey Gladkov @ 2018-10-02 20:36 UTC (permalink / raw)
  To: Linux console tools development discussion

On Tue, Jun 12, 2018 at 03:16:13PM -0400, esr@thyrsus.com wrote:
> 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

Applied. Thanks!

> 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

> 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

> _______________________________________________
> kbd mailing list
> kbd@lists.altlinux.org
> https://lists.altlinux.org/mailman/listinfo/kbd


-- 
Rgrds, legion



^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2018-10-02 20:36 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2018-06-12 19:16 [kbd] Problems in codepage.1, loadkeys.1 esr
2018-10-02 20:36 ` Alexey Gladkov

Linux console tools development discussion

This inbox may be cloned and mirrored by anyone:

	git clone --mirror http://lore.altlinux.org/kbd/0 kbd/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 kbd kbd/ http://lore.altlinux.org/kbd \
		kbd@lists.altlinux.org kbd@lists.altlinux.ru kbd@lists.altlinux.com
	public-inbox-index kbd

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://lore.altlinux.org/org.altlinux.lists.kbd


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git