gEDA-bug: [ geda-Patches-2901183 ] Fix for some manpage issues

["SourceForge.net" <noreply@xxxxxxxxxxxxxxx>]

Patches item #2901183, was opened at 2009-11-20 16:49
Message generated for change (Tracker Item Submitted) made by aelmahmoudy
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=818428&aid=2901183&group_id=161080

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: documentation
Group: None
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Ahmed El-Mahmoudy (aelmahmoudy)
Assigned to: Nobody/Anonymous (nobody)
Summary: Fix for some manpage issues

Initial Comment:
Hello,

  While working on Debian package for geda-gaf 1.6.0, the Debian linting tool 
  (lintian) gave a couple of warnings about the manpages:
  1) Use of undefined `l' macro

  2) Hyphen used as minus sign
N:    Manual page seems to contain a hyphen where a minus sign was intended.
N:    "-" chars are interpreted as hyphens (U+2010) by groff, not as minus
N:    signs (U+002D). Since options to programs use minus signs (U+002D), this
N:    means for example in UTF-8 locales that you cannot cut&paste options,
N:    nor search for them easily.
N:
N:    "-" must be escaped ("\-") to be interpreted as minus. If you really
N:    intend a hyphen, write it as "\(hy" to emphasise that fact. See groff(7)
N:    and especially groff_char(7) for details, and also the thread starting
N:    with
N:    http://lists.debian.org/debian-devel/2003/debian-devel-200303/msg01481.h
N:    tml
N:
N:    If you use some tool that converts your documentation to groff format,
N:    it might be possible that this tool converts dashes of any kind to groff
N:    hyphens, while the safe way of converting dashes is usually to convert
N:    them to "\-".


  The attached patch fixes those issues.


----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=818428&aid=2901183&group_id=161080


_______________________________________________
geda-bug mailing list
geda-bug@xxxxxxxxxxxxxx
http://www.seul.org/cgi-bin/mailman/listinfo/geda-bug