don't use char values for functions that can return -1; chars are not always

[bsdgames-darwin.git] / bcd / bcd.6

diff --git a/bcd/bcd.6 b/bcd/bcd.6
index 2a38e2b5a9e6b96d1dee14dd43befe593dd78a9f..f07acb5c7fcf72a370ccabb40bec7a14e2e31e73 100644 (file)
--- a/bcd/bcd.6
+++ b/bcd/bcd.6
@@ -1,5 +1,7 @@
-.\" Copyright (c) 1988 Regents of the University of California.
-.\" All rights reserved.
+.\"    $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
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions


@@ -9,11 +11,7 @@
 .\" 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.
 .\" 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
+.\" 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.
 .\"
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\"


@@ -29,36 +27,59 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"

-.\"    from: @(#)bcd.6 6.7 (Berkeley) 6/23/90
-.\"    $Id: bcd.6,v 1.4 1994/03/19 08:23:12 cgd Exp $
+.\"    @(#)bcd.6       8.1 (Berkeley) 5/31/93

 .\"
 .\"

-.Dd June 23, 1990
+.Dd November 26, 2002

 .Dt BCD 6
 .Os
 .Sh NAME
 .Nm bcd ,
 .Nm ppt ,
 .Dt BCD 6
 .Os
 .Sh NAME
 .Nm bcd ,
 .Nm ppt ,

-.Nm morse 
+.Nm morse

 .Nd "reformat input as punch cards, paper tape or morse code"
 .Sh SYNOPSIS
 .Nd "reformat input as punch cards, paper tape or morse code"
 .Sh SYNOPSIS

-.Nm bcd
+.Nm

 .Op Ar string ...
 .Op Ar string ...

-.br

 .Nm ppt
 .Nm ppt

-.Op Ar string ...
-.br
+.Op Fl d Ns \&| Ns Ar string ...

 .Nm morse
 .Nm morse

-.Op Fl s
-.Op Ar string ...
+.Op Fl ds Ar string ...

 .Sh DESCRIPTION
 .Sh DESCRIPTION

-.Nm Bcd ,
+The
+.Nm ,

 .Nm ppt
 and
 .Nm morse
 .Nm ppt
 and
 .Nm morse

-convert command line arguments, if provided, or standard input into a form
-familiar to old-timers.
+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
 The
 .Fl s

-option for
+option for morse produces dots and dashes rather than words.
+.It Fl d
+Decode
+.Nm ppt
+output, or

 .Nm morse
 .Nm morse

-produces dots and dashes rather than words.
+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