Package: linkchecker
Version: 2.9-2
Severity: normal
You use a literal quotation mark (') in your man page but this gets
rendered as a special quotation mark in UTF-8 locales which the shell
doesn't accept. You need to use ' for text, but \(aq for shell
commands, see groff_char(7).
Attached is a patch fixing this as well as an IRC discussion about this
problem.
-- System Information:
Debian Release: 3.1
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.6.10-1-686
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Versions of packages linkchecker depends on:
ii python 2.3.5-2 An interactive high-level object-o
ii python2.4 2.4.1-1 An interactive high-level object-o
-- no debconf information
--
Martin Michlmayr
http://www.cyrius.com/
diff -urN linkchecker-2.9~/doc/de/linkchecker.1 linkchecker-2.9/doc/de/linkchecker.1
--- linkchecker-2.9~/doc/de/linkchecker.1 2005-05-06 14:03:15.878126408 +0100
+++ linkchecker-2.9/doc/de/linkchecker.1 2005-05-06 14:05:32.821307880 +0100
@@ -31,7 +31,7 @@
Keine Verbindungen zu mailto: Rechnern, nur die Syntax wird geprüft. Alle
anderen Verknüpfungen werden wie üblich geprüft:
- \fBlinkchecker \-\-intern='!^mailto:' \-\-extern\-strict\-all www.mysite.org\fP
+ \fBlinkchecker \-\-intern=\(aq!^mailto:\(aq \-\-extern\-strict\-all www.mysite.org\fP
Überprüfung einer lokalen HTML Datei unter Unix:
\fBlinkchecker ../bla.html\fP
@@ -252,7 +252,7 @@
.SH BEMERKUNGEN
Ein \fB!\fP vor einem regulären Ausdruck negiert diesen. Also matcht
-\&\fB'!^mailto:'\fP alles außer mailto Links.
+\&\fB\(aq!^mailto:\(aq\fP alles außer mailto Links.
URLs von der Kommandozeile die mit \fBftp.\fP beginnen werden wie \fBftp://ftp.\fP
behandelt, URLs die mit \fBwww.\fP beginnen wie \fBhttp://www.\fP. Sie können
diff -urN linkchecker-2.9~/doc/en/linkchecker.1 linkchecker-2.9/doc/en/linkchecker.1
--- linkchecker-2.9~/doc/en/linkchecker.1 2005-05-06 14:03:15.897123520 +0100
+++ linkchecker-2.9/doc/en/linkchecker.1 2005-05-06 14:05:00.463227056 +0100
@@ -39,7 +39,7 @@
Don't connect to mailto: hosts, only check their URL syntax. All other
links are checked as usual:
- \fBlinkchecker \-\-intern='!^mailto:' \-\-extern\-strict\-all www.mysite.org\fP
+ \fBlinkchecker \-\-intern=\(aq!^mailto:\(aq \-\-extern\-strict\-all www.mysite.org\fP
Checking a local HTML file on Unix:
\fBlinkchecker ../bla.html\fP
@@ -216,7 +216,7 @@
Default is no pause between requests.
.TP
\fB\-N\fP\fIserver\fP, \fB\-\-nntp\-server=\fP\fIserver\fP
-Specify an NNTP server for 'news:...' links. Default is the
+Specify an NNTP server for \(aqnews:...\(aq links. Default is the
environment variable NNTP_SERVER. If no host is given,
only the syntax of the link is checked.
.TP
@@ -268,8 +268,8 @@
Logs nothing. Suitable for scripts.
.SH NOTES
-A \fB!\fP before any regex negates it. So \fB'!^mailto:'\fP matches
-everything but a mailto link.
+A \fB!\fP before any regex negates it. So \fB\(aq!^mailto:\(aq\fP
+matches everything but a mailto link.
LinkCheckers commandline parser treats \fBftp.\fP links like \fBftp://ftp.\fP
and \fBwww.\fP links like \fBhttp://www.\fP.
diff -urN linkchecker-2.9~/doc/fr/linkchecker.1 linkchecker-2.9/doc/fr/linkchecker.1
--- linkchecker-2.9~/doc/fr/linkchecker.1 2005-05-06 14:03:15.898123368 +0100
+++ linkchecker-2.9/doc/fr/linkchecker.1 2005-05-06 14:06:51.942279664 +0100
@@ -33,7 +33,7 @@
Pour ne pas se connecter aux hôtes mailto:, seulement vérifier leur syntaxe.
Tous les autres liens sont vérifiés comme d'habitude :
- \fBlinkchecker \-\-intern='!^mailto:' \-\-extern\-strict\-all www.mysite.org\fP
+ \fBlinkchecker \-\-intern=\(aq!^mailto:\(aq \-\-extern\-strict\-all www.mysite.org\fP
Pour vérifier un fichier HTML local sur Unix :
\fBlinkchecker ../bla.html\fP
@@ -207,7 +207,7 @@
requêtes.
.TP
\fB\-N\fP\fIserveur\fP, \fB\-\-nntp\-server=\fP\fIserveur\fP
-Spécifier un serveur NNTP pour les liens «\ news:\ ». Par défaut, la
+Spécifier un serveur NNTP pour les liens \(aqnews:\(aq. Par défaut, la
variable d'environnement NNTP_SERVER est utilisée. Si aucun hôte n'est
donné, LinkChecker n'effectue qu'une vérification de la syntaxe du lien.
.TP
@@ -265,8 +265,8 @@
Ne rien journaliser du tout. Approprié pour les scripts.
.SH NOTES
-Un \fB!\fP avant une expression rationnelle l'inverse. Ainsi \fB'!^mailto:'\fP
-correspond à tout sauf un lien mailto.
+Un \fB!\fP avant une expression rationnelle l'inverse. Ainsi
+\fB\(aq!^mailto:\(aq\fP correspond à tout sauf un lien mailto.
Les URL sur la ligne de commande commençant par \fBftp.\fP sont traitées
comme \fBftp://ftp.\fP, les URL commençant par \fBwww.\fP sont traitées comme
13:47 < tbm> Kamion: a man page includes \fBlinkchecker \-\-intern='!^mailto:'
but man renders the ' as â in a
UTF-8 locale adn when you paste that to the shell, it won't work
13:47 < tbm> Kamion: is that a bug in man or in the man page?
13:50 < Kamion> it would not be a bug in man in any event
13:50 < Kamion> (would be groff if anything)
13:51 < Kamion> anyhow, see groff_char(7)
13:51 < Kamion> you probably want to use \(aq in place of ', to force a
straight quote
13:52 < tbm> so it's a bug in the man page; or is the shell supposed to
recognize this fancy UTF-8 quotatioon
mark?
13:57 < mjg59> It's a manpage bug
13:58 < mjg59> ' gets interpreted as a quote character. If you want it to be a
shell metacharacter, you need to
escape it
13:59 < tbm> ok... I wonder how many man pages get this wrong
14:01 < mjg59> Lots
14:01 < mjg59> Also with hyphens
14:02 < tbm> oh yeah, that too. Actually, I think my package uses wrong
hyphens. Can someone give me a brief
summary again or point me to a web page explaining it?
14:04 < willy> - is a typographical mark, \- is a minus sign that you can
search for properly and paste to the
shell
