exiv2 (0.19-1) 00_hyphens_used_as_minus.diff
|Status:||Closed||Start date:||01 May 2010|
|Priority:||Normal||Due date:||27 Apr 2013|
|Assignee:||Niels Kristian Bech Jensen||% Done:|
This manual page seems to contain a hyphen where a minus sign was intended. By default, "-" chars are interpreted as hyphens (U+2010) by groff, not as minus signs (U+002D). Since options to programs use minus signs (U+002D), this means for example in UTF-8 locales that you cannot cut and paste options, nor search for them easily. The Debian groff package currently forces "-" to be interpreted as a minus sign due to the number of manual pages with this problem, but this is a Debian-specific modification and hopefully eventually can be removed.
"-" must be escaped ("\-") to be interpreted as minus. If you really intend a hyphen (normally you don't), write it as "\(hy" to emphasise that fact. See groff(7) and especially groff_char(7) for details, and also the thread starting with http://lists.debian.org/debian-devel/2003/debian-devel-200303/msg01481.html
If you use some tool that converts your documentation to groff format, this tag may indicate a bug in the tool. Some tools convert dashes of any kind to hyphens. The safe way of converting dashes is to convert them to "\-".
Because this error can occur very often, Lintian shows only the first 10 occurrences for each man page and give the number of suppressed occurrences. If you want to see all warnings, run Lintian with the -d/--debug option.
Refer to the groff_char(7) manual page for details.
Severity: wishlist, Certainty: possible
I am currently using the following patch in Debian, could I ask you to consider applying upstream:
@ -171,17 +171,17 @ Print mode for the 'print' action. Possi
s : print a summary of the Exif metadata (the default)
-a : print Exif, IPTC and XMP metadata (shortcut for -Pkyct)
+a : print Exif, IPTC and XMP metadata (shortcut for \-Pkyct)
-t : interpreted (translated) Exif tags (-PEkyct)
+t : interpreted (translated) Exif tags (\-PEkyct)
-v : plain Exif tag values (-PExgnycv)
+v : plain Exif tag values (\-PExgnycv)
-h : hexdump of the Exif data (-PExgnycsh)
+h : hexdump of the Exif data (\-PExgnycsh)
-i : IPTC datasets (-PIkyct)
+i : IPTC datasets (\-PIkyct)
-x : XMP properties (-PXkyct)
+x : XMP properties (\-PXkyct)
c : JPEG comment
@ -256,7 +256,7 @ images and a modifier to generate an XMP
p[<n>[,<m> ...]] : Extract preview images. The optional comma separated
list of preview image numbers is used to determine which preview images
to extract. The available preview images and their numbers are displayed
-with the 'print' option -pp.
+with the 'print' option \-pp.
X : Extract metadata to an XMP sidecar file <file>.xmp. The remaining
extract targets determine what metadata to extract to the sidecar
@ -393,13 +393,13 @ ignored (comments). Remaining lines are
Prints a summary of the Exif information for all JPEG files in the directory.
-exiv2 -pi image.jpg
+exiv2 \-pi image.jpg
Prints the IPTC metadata of the image.
exiv2 rename img_1234.jpg
Renames img_1234.jpg (taken on 13\-Nov\-05 at 22:58:31) to 20051113_225831.jpg
-exiv2 -r':basename:_%Y%m' rename img_1234.jpg
+exiv2 \-r':basename:_%Y%m' rename img_1234.jpg
Renames img_1234.jpg to img_1234_200511.jpg
exiv2 \-et img1.jpg img2.jpg
@ -441,7 +441,7 @ and GPSLatitudeRef contains either 'N' o
-exiv2 insert -l/tmp -S.CRW /data/.JPG
+exiv2 insert \-l/tmp \-S.CRW /data/*.JPG
Copy all metadata from CRW files in the /tmp directory to JPG files
with corresponding basenames in the /data directory. Note that this