1 files changed, 43 insertions, 5 deletions
diff --git a/games/bcd/bcd.6 b/games/bcd/bcd.6
index e06dafe..732a4ee 100644
--- a/games/bcd/bcd.6
+++ b/games/bcd/bcd.6
@@ -47,6 +47,8 @@
 .Op Ar string ...
 .Nm morse
 .Op Fl p
+.Op Fl d Ar device
+.Op Fl e
 .Op Fl w Ar speed
 .Op Fl f Ar frequency
 .Op Fl s
@@ -61,28 +63,44 @@ read the given input and reformat it in the form of punched cards,
 paper tape or morse code respectively.
 Acceptable input are command line arguments or the standard input.
 .Pp
-Available option:
+Available options for program
+.Nm morse :
 .Bl -tag -width flag
 .It Fl s
 The
 .Fl s
-option for morse produces dots and dashes rather than words.
+option produces dots and dashes rather than words.
 .It Fl p
-Send morse the real way. This only works if your system has sound
-support and if the program understands your audio hardware.
+Send morse the real way. This only works if your system has
+.Xr speaker 4
+support.
 .It Fl w Ar speed
 Set the sending speed in words per minute. If not specified the default
 speed of 20 WPM is used.
 .It Fl f Ar frequency
 Set the sidetone frequency to something other than the default 600 Hz.
+.It Fl d Ar device
+Similar to
+.Fl p ,
+but use the RTS line of
+.Ar device
+.Pq which must by a tty device
+in order to emit the morse code.
+.It Fl e
+echo each character before it is sent, used together with either
+.Fl p
+or
+.Fl d .
 .El
 .Pp
 The
 .Fl w
 and
 .Fl f
-flags only work in conjunction with the
+flags only work in conjunction with either the
 .Fl p
+or the
+.Fl d
 flag.
 .Pp
 Not all prosigns have corresponding characters. Use
@@ -110,6 +128,19 @@ and
 .Ql +
 for
 .Em AR .
+.Pp
+Using flag
+.Fl d Ar device
+it is possible to key an external device, like a sidetone generator with
+a headset for training purposes, or even your ham radio transceiver.  For
+the latter, simply connect an NPN transistor to the serial port
+.Ar device ,
+emitter connected to ground, base connected through a resistor
+(few kiloohms) to RTS, collector to the key line of your transceiver
+(assuming the transceiver has a positive key supply voltage and is keyed
+by grounding the key input line).  A capacitor (some nanofarads) between
+base and ground is advisable to keep stray RF away, and to supress the
+minor glitch that is generated during program startup.
 .Sh FILES
 .Bl -tag -width /dev/speaker -compact
 .It Pa /dev/speaker
@@ -131,10 +162,17 @@ Cyrillic characters.  In all other cases, they are being interpreted
 as belonging to the
 .Ql ISO_8859-1
 character set.
+.Sh SEE ALSO
+.Xr speaker 4
 .Sh HISTORY
 Sound support for
 .Nm morse
 added by Lyndon Nerenberg (VE7TCP/VE6BBM) <lyndon@orthanc.com>.
+.Pp
+Ability to key an external device added by
+.ie t J\(:org Wunsch
+.el Joerg Wunsch
+(DL8DTL).
 .Sh BUGS
 Does only understand a few European characters (namely German and
 French), but neither Asian ones, or the continental landline code.