[Digikam-devel] [Bug 288463] New: hyphen-used-as-minus-sign cleanup_digikamdb.1 digitaglinktree.1

[Mark Purcell]

https://bugs.kde.org/show_bug.cgi?id=288463

           Summary: hyphen-used-as-minus-sign  cleanup_digikamdb.1
                    digitaglinktree.1
           Product: digikam
           Version: 2.3.0
          Platform: Debian unstable
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: minor
          Priority: NOR
         Component: Documentation
        AssignedTo: digikam-devel at kde.org
        ReportedBy: msp at debian.org


Version:           2.3.0 (using KDE 4.7.3) 
OS:                Linux

These 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.

"-" 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.

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 "\-".

Severity: wishlist, Certainty: possible

Reproducible: Always

Steps to Reproduce:
source code inspection

Actual Results:  
hyphen-used-as-minus-sign
usr/share/man/man1/cleanup_digikamdb.1.gz:18
usr/share/man/man1/digitaglinktree.1.gz 14 more occurrences not shown
usr/share/man/man1/digitaglinktree.1.gz:30
usr/share/man/man1/digitaglinktree.1.gz:33
usr/share/man/man1/digitaglinktree.1.gz:46
usr/share/man/man1/digitaglinktree.1.gz:52
usr/share/man/man1/digitaglinktree.1.gz:75
usr/share/man/man1/digitaglinktree.1.gz:76
usr/share/man/man1/digitaglinktree.1.gz:81
usr/share/man/man1/digitaglinktree.1.gz:83
usr/share/man/man1/digitaglinktree.1.gz:88
usr/share/man/man1/digitaglinktree.1.gz:97

Expected Results:  
"-" must be escaped ("\-") to be interpreted as minus

OS: Linux (x86_64) release 3.1.0-1-amd64
Compiler: gcc

-- 
Configure bugmail: https://bugs.kde.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.