NetBSD/games/bcd/bcd.6

.\"	$NetBSD: bcd.6,v 1.16 2003/08/07 09:37:04 agc Exp $
.\"
.\" 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. 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
.\"
.Dd November 26, 2002
.Dt BCD 6
.Os
.Sh NAME
.Nm bcd ,
.Nm ppt ,
.Nm morse
.Nd "reformat input as punch cards, paper tape or morse code"
.Sh SYNOPSIS
.Nm
.Op Ar string ...
.Nm ppt
.Op Fl d Ns \&| Ns Ar string ...
.Nm morse
.Op Fl ds Ar string ...
.Sh DESCRIPTION
The
.Nm ,
.Nm ppt
and
.Nm morse
commands 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:
.Bl -tag -width flag
.It Fl s
The
.Fl s
option for morse produces dots and dashes rather than words.
.It Fl d
Decode
.Nm ppt
output, or
.Nm morse
output consisting of dots and slashes (as generated by using the
.Fl s
option).
.El
.Sh SEE ALSO
.Rs
.%B "ISO 1681:1973: Information processing--Unpunched paper cards--Specification"
.Re
.Rs
.%B "ISO 1682:1973: Information processing--80 columns punched paper cards--Dimensions and location of rectangular punched holes"
.Re
.Rs
.%B "ECMA-10: ECMA Standard for Data Interchange on Punched Tape"
.Re
.Rs
.%B "ITU-T Recommendation F.1: Operational provisions for the international public telegram service"
.%O "Division B, I. Morse code"
.Re
Move UCB-licensed code from 4-clause to 3-clause licence. Patches provided by Joel Baker in PR 22269, verified by myself. 2003-08-07 13:36:50 +04:00			`.\" $NetBSD: bcd.6,v 1.16 2003/08/07 09:37:04 agc Exp $`
clean up import 1995-03-21 18:03:38 +03:00			`.\"`
			`.\" Copyright (c) 1988, 1991, 1993`
			`.\" The Regents of the University of California. All rights reserved.`
initial import of 386bsd-0.1 sources 1993-03-21 12:45:37 +03:00			`.\"`
			`.\" 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.`
Move UCB-licensed code from 4-clause to 3-clause licence. Patches provided by Joel Baker in PR 22269, verified by myself. 2003-08-07 13:36:50 +04:00			`.\" 3. Neither the name of the University nor the names of its contributors`
initial import of 386bsd-0.1 sources 1993-03-21 12:45:37 +03:00			`.\" 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.`
			`.\"`
clean up import 1995-03-21 18:03:38 +03:00			`.\" @(#)bcd.6 8.1 (Berkeley) 5/31/93`
initial import of 386bsd-0.1 sources 1993-03-21 12:45:37 +03:00			`.\"`
Use more markup, and bump date for ppt's -d flag. 2002-11-29 22:09:57 +03:00			`.Dd November 26, 2002`
Remove unnecessary quotes in Dt. 2001-06-05 16:41:04 +04:00			`.Dt BCD 6`
Update to use new -mandoc macros. 1993-08-05 05:46:15 +04:00			`.Os`
			`.Sh NAME`
only one Nm/Nd pair. 1994-03-19 11:23:12 +03:00			`.Nm bcd ,`
			`.Nm ppt ,`
clean up import 1995-03-21 18:03:38 +03:00			`.Nm morse`
only one Nm/Nd pair. 1994-03-19 11:23:12 +03:00			`.Nd "reformat input as punch cards, paper tape or morse code"`
Update to use new -mandoc macros. 1993-08-05 05:46:15 +04:00			`.Sh SYNOPSIS`
WARNSify, fixup .Nm usage 1997-10-10 13:54:16 +04:00			`.Nm`
Update to use new -mandoc macros. 1993-08-05 05:46:15 +04:00			`.Op Ar string ...`
			`.Nm ppt`
Add ppt decoding from Michael Shalayeff <mickey@lucifier.net> 2002-11-26 06:47:45 +03:00			`.Op Fl d Ns \&\| Ns Ar string ...`
Update to use new -mandoc macros. 1993-08-05 05:46:15 +04:00			`.Nm morse`
document morse's decode option -d 1999-01-03 20:12:28 +03:00			`.Op Fl ds Ar string ...`
Update to use new -mandoc macros. 1993-08-05 05:46:15 +04:00			`.Sh DESCRIPTION`
clean up import 1995-03-21 18:03:38 +03:00			`The`
.Nm does not need a dummy argument ("") before punctuation or for correct formatting of the SYNOPSIS any longer. 2003-02-25 13:34:36 +03:00			`.Nm ,`
Update to use new -mandoc macros. 1993-08-05 05:46:15 +04:00			`.Nm ppt`
			`and`
			`.Nm morse`
fix typo, as per PR#5867 1998-09-11 17:06:30 +04:00			`commands read the given input and reformat it in the form of`
clean up import 1995-03-21 18:03:38 +03:00			`punched cards, paper tape or morse code respectively.`
			`Acceptable input are command line arguments or the standard input.`
			`.Pp`
			`Available option:`
			`.Bl -tag -width flag`
			`.It Fl s`
Update to use new -mandoc macros. 1993-08-05 05:46:15 +04:00			`The`
			`.Fl s`
clean up import 1995-03-21 18:03:38 +03:00			`option for morse produces dots and dashes rather than words.`
Add support for decoding of morse code. 1998-11-18 17:22:32 +03:00			`.It Fl d`
Use more markup, and bump date for ppt's -d flag. 2002-11-29 22:09:57 +03:00			`Decode`
			`.Nm ppt`
			`output, or`
			`.Nm morse`
			`output consisting of dots and slashes (as generated by using the`
Add support for decoding of morse code. 1998-11-18 17:22:32 +03:00			`.Fl s`
Add ppt decoding from Michael Shalayeff <mickey@lucifier.net> 2002-11-26 06:47:45 +03:00			`option).`
clean up import 1995-03-21 18:03:38 +03:00			`.El`
This patch adds references to the main punched card, paper tape and Morse code standards to the bcd(6) manpage (which also serves as the manpages ppt(6) and morse(6)). (The only one of these standards I have read is the ECMA-10 paper tape standard, which is also probably the least readily available, since ECMA don't supply copies of obsolete standards, though they will supply printed copies of any or all of their current standards at no charge.) Patch submitted in PR 8102 by Joseph Myers <jsm28@cam.ac.uk> 1999-07-29 03:01:59 +04:00			`.Sh SEE ALSO`
			`.Rs`
			`.%B "ISO 1681:1973: Information processing--Unpunched paper cards--Specification"`
			`.Re`
			`.Rs`
			`.%B "ISO 1682:1973: Information processing--80 columns punched paper cards--Dimensions and location of rectangular punched holes"`
			`.Re`
			`.Rs`
			`.%B "ECMA-10: ECMA Standard for Data Interchange on Punched Tape"`
			`.Re`
			`.Rs`
			`.%B "ITU-T Recommendation F.1: Operational provisions for the international public telegram service"`
			`.%O "Division B, I. Morse code"`
			`.Re`