Christoph Korn/PlayDeb.net: man page fixes with "-" vs hyphen

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.

diff --git a/man/fgfs.1.in b/man/fgfs.1.in
index 8ae223715579b7f1bc39362e230906ca92877da1..a967b0157e850e631a6d55bceb92df43fa6ed1ed 100644 (file)
--- a/man/fgfs.1.in
+++ b/man/fgfs.1.in
@@ -47,7 +47,7 @@ executable.  This is used for UIUC aircraft only.
 Specify starting postion by airport ID.
 .TP
 .BI "--altitude=" "value"
-Specify starting altitude (in feet unless --units-meters specified).
+Specify starting altitude (in feet unless \-\-units-meters specified).
 .TP
 .BI "--atc610x"
 Enable atc610x interface.
@@ -275,7 +275,7 @@ Specify window geometry (ie. 640x480, 800x600, etc).
 Specify heading or yaw angle (degrees).
 .TP
 .BR "--help" ", " "-h"
-Show a brief help message.  Use --verbose,-v for a full listing of options.
+Show a brief help message.  Use \-\-verbose,\-v for a full listing of options.
 .TP
 .BI "--httpd=" "port"
 Start an HTTP server on the specified port.
@@ -371,7 +371,7 @@ set property <name> to <value>.
 Open an IO connection using the PVE (Provision Entertainment) protocol.
 .TP
 .B "--random-wind"
-Randomize initial wind parameters.  See also: --wind.
+Randomize initial wind parameters.  See also: \-\-wind.
 .TP
 .BI "--ray=" "medium" "," "direction" "," "hz" "," "options" "," "..."
 Open an IO connection to a "RayWoodworth" motion chair.
@@ -429,7 +429,7 @@ Specify turbulence from 0.0 (calm) to 1.0 (severe).
 .TP
 .BI "--uBody=" "value"
 Specify velocity along the body X axis (feet per second unless
---units-meters specified).
+\-\-units-meters specified).
 .TP
 .B "--units-feet"
 Use feet instead of meters.  Affects other options as well as the
@@ -441,7 +441,7 @@ values displayed by the HUD.
 .TP
 .BI "--vBody=" "value"
 Specify velocity along the body Y axis (feet per second unless
---units-meters specified).
+\-\-units-meters specified).
 .TP
 .BI "--vc=" "knots"
 Specify initial airspeed (knots).
@@ -465,7 +465,7 @@ Specify starting position relative to a VOR.
 .TP
 .BI "--wBody=" "value"
 Specify velocity along the body Z axis (feet per second unless
---units-meters specified).
+\-\-units-meters specified).
 .TP
 .BI "--wind=" "DIR@SPEED"
 Specify wind coming from DIR (degrees) at SPEED (knots).  Values may be