Give morse(6) own manual page since common manpage for bcd(6), ppt(6) and
morse(6) was mostly dedicated to morse(6)
This commit is contained in:
parent
64385c3bca
commit
b195b11b69
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=71629
@ -1,8 +1,9 @@
|
||||
# @(#)Makefile 8.1 (Berkeley) 5/31/93
|
||||
# $FreeBSD$
|
||||
|
||||
PROG= bcd
|
||||
MAN6= bcd.6
|
||||
MLINKS= bcd.6 morse.6 bcd.6 ppt.6
|
||||
MLINKS= bcd.6 ppt.6
|
||||
|
||||
.include <bsd.prog.mk>
|
||||
|
||||
|
143
games/bcd/bcd.6
143
games/bcd/bcd.6
@ -32,150 +32,25 @@
|
||||
.\" @(#)bcd.6 8.1 (Berkeley) 5/31/93
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd May 31, 1993
|
||||
.Dt "BCD" 6
|
||||
.Dd December 07, 2000
|
||||
.Dt BCD 6
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm bcd ,
|
||||
.Nm ppt ,
|
||||
.Nm morse
|
||||
.Nd "reformat input as punch cards, paper tape or morse code"
|
||||
.Nm ppt
|
||||
.Nd "reformat input as punch cards or paper tape"
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Op Ar string ...
|
||||
.Nm ppt
|
||||
.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
|
||||
.Op Ar string ...
|
||||
.Sh DESCRIPTION
|
||||
The commands
|
||||
.Nm ,
|
||||
.Nm
|
||||
and
|
||||
.Nm ppt
|
||||
and
|
||||
.Nm morse
|
||||
read the given input and reformat it in the form of punched cards,
|
||||
paper tape or morse code respectively.
|
||||
read the given input and reformat it in the form of punched cards or
|
||||
paper tape.
|
||||
Acceptable input are command line arguments or the standard input.
|
||||
.Pp
|
||||
Available options for program
|
||||
.Nm morse :
|
||||
.Bl -tag -width flag
|
||||
.It Fl s
|
||||
The
|
||||
.Fl s
|
||||
option produces dots and dashes rather than words.
|
||||
.It Fl p
|
||||
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 either the
|
||||
.Fl p
|
||||
or the
|
||||
.Fl d
|
||||
flag.
|
||||
.Pp
|
||||
Not all prosigns have corresponding characters. Use
|
||||
.Ql #
|
||||
for
|
||||
.Em AS ,
|
||||
.Ql @
|
||||
for
|
||||
.Em SK ,
|
||||
.Ql *
|
||||
for
|
||||
.Em VE
|
||||
and
|
||||
.Ql %
|
||||
for
|
||||
.Em BK .
|
||||
The more common prosigns are
|
||||
.Ql =
|
||||
for
|
||||
.Em BT ,
|
||||
.Ql (
|
||||
for
|
||||
.Em KN
|
||||
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
|
||||
speaker device file
|
||||
.El
|
||||
.Sh ENVIRONMENT
|
||||
.Bl -tag -width LC_CTYPE
|
||||
.Pp
|
||||
For
|
||||
.Nm morse
|
||||
only:
|
||||
.It Ev LC_CTYPE
|
||||
.It Ev LC_ALL
|
||||
.It Ev LANG
|
||||
If one of these variables (in this priority) is set to a locale ending in
|
||||
.Ql KOI8-R ,
|
||||
characters with the high-order bit set are being interpreted as
|
||||
Cyrillic characters. In all other cases, they are being interpreted
|
||||
as belonging to the
|
||||
.Ql ISO_8859-1
|
||||
character set.
|
||||
.El
|
||||
.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
|
||||
.An J\(:org Wunsch
|
||||
(DL8DTL).
|
||||
.Sh BUGS
|
||||
Does only understand a few European characters (namely German and
|
||||
French), but neither Asian ones, or the continental landline code.
|
||||
.Pp
|
||||
Sends a bit slower than it should due to system overhead. Some people
|
||||
would call this a feature.
|
||||
.Xr morse 6
|
||||
|
@ -1,7 +1,8 @@
|
||||
# @(#)Makefile 8.1 (Berkeley) 5/31/93
|
||||
# $FreeBSD$
|
||||
|
||||
PROG= morse
|
||||
NOMAN= noman
|
||||
MAN6= morse.6
|
||||
|
||||
.if ${MACHINE_ARCH} == "i386"
|
||||
CFLAGS += -DSPEAKER=\"/dev/speaker\"
|
||||
|
167
games/morse/morse.6
Normal file
167
games/morse/morse.6
Normal file
@ -0,0 +1,167 @@
|
||||
.\" Copyright (c) 2000 Alexey Zelkin. All rights reserved.
|
||||
.\" Copyright (c) 1988, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\" 3. All advertising materials mentioning features or use of this software
|
||||
.\" must display the following acknowledgement:
|
||||
.\" This product includes software developed by the University of
|
||||
.\" California, Berkeley and its contributors.
|
||||
.\" 4. Neither the name of the University nor the names of its contributors
|
||||
.\" may be used to endorse or promote products derived from this software
|
||||
.\" without specific prior written permission.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" @(#)bcd.6 8.1 (Berkeley) 5/31/93
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd December 07, 2000
|
||||
.Dt MORSE 6
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm morse
|
||||
.Nd reformat input as morse code
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Op Fl p
|
||||
.Op Fl d Ar device
|
||||
.Op Fl e
|
||||
.Op Fl w Ar speed
|
||||
.Op Fl f Ar frequency
|
||||
.Op Fl s
|
||||
.Op Ar string ...
|
||||
.Sh DESCRIPTION
|
||||
The command
|
||||
.Nm
|
||||
read the given input and reformat it in the form of morse code.
|
||||
Acceptable input are command line arguments or the standard input.
|
||||
.Pp
|
||||
Available options:
|
||||
.Bl -tag -width flag
|
||||
.It Fl s
|
||||
The
|
||||
.Fl s
|
||||
option produces dots and dashes rather than words.
|
||||
.It Fl p
|
||||
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 either the
|
||||
.Fl p
|
||||
or the
|
||||
.Fl d
|
||||
flag.
|
||||
.Pp
|
||||
Not all prosigns have corresponding characters. Use
|
||||
.Ql #
|
||||
for
|
||||
.Em AS ,
|
||||
.Ql @
|
||||
for
|
||||
.Em SK ,
|
||||
.Ql *
|
||||
for
|
||||
.Em VE
|
||||
and
|
||||
.Ql %
|
||||
for
|
||||
.Em BK .
|
||||
The more common prosigns are
|
||||
.Ql =
|
||||
for
|
||||
.Em BT ,
|
||||
.Ql (
|
||||
for
|
||||
.Em KN
|
||||
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
|
||||
speaker device file
|
||||
.El
|
||||
.Sh ENVIRONMENT
|
||||
.Bl -tag -width LC_CTYPE -compact
|
||||
.It Ev LC_CTYPE
|
||||
.It Ev LC_ALL
|
||||
.It Ev LANG
|
||||
If one of these variables (in this priority) is set to a locale ending in
|
||||
.Ql KOI8-R ,
|
||||
characters with the high-order bit set are being interpreted as
|
||||
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
|
||||
added by
|
||||
.An Lyndon Nerenberg (VE7TCP/VE6BBM) Aq lyndon@orthanc.com .
|
||||
.Pp
|
||||
Ability to key an external device added by
|
||||
.An J\(:org Wunsch
|
||||
(DL8DTL).
|
||||
.Sh BUGS
|
||||
Does only understand a few European characters (namely German and
|
||||
French), but neither Asian ones, or the continental landline code.
|
||||
.Pp
|
||||
Sends a bit slower than it should due to system overhead. Some people
|
||||
would call this a feature.
|
Loading…
Reference in New Issue
Block a user