Return to aplcvt.1 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / apl / man

Annotation of 43BSD/contrib/apl/man/aplcvt.1, revision 1.1.1.1

1.1       root        1: .TH APLCVT 1 "28 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: aplcvt  \- convert APL workspaces between PDP-11 and VAX formats
                      5: .SH SYNPOSIS
                      6: .B aplcvt
                      7: [
                      8: .B \-v|\-p
                      9: ][ file ... ]
                     10: .SH DESCRIPTION
                     11: .I aplcvt
                     12: performs the necessary transformations
                     13: to produce a VAX format workspace from
                     14: a PDP-11 format workspace,
                     15: and
                     16: .I "vice versa."
                     17: The workspace formats differ because
                     18: the word sizes of the two machines
                     19: are different;
                     20: hence,
                     21: pointers have different lengths.
                     22: In general,
                     23: any PDP-11 workspace can be converted
                     24: to VAX format.
                     25: VAX format workspaces can be converted
                     26: to PDP-11 format provided they are
                     27: ``small enough''
                     28: (if a VAX workspace is too large to
                     29: be converted to PDP-11 format,
                     30: it is also too large to run on
                     31: the PDP-11 APL interpreter).
                     32: .PP
                     33: In the usual case,
                     34: the workspaces to be converted are
                     35: specified on the command line.
                     36: The output files have the same names
                     37: as the input files with a
                     38: ``.pdp'' or ``.vax'' extension.
                     39: (If the input file name ends with a
                     40: ``.pdp'' or ``.vax'' extension,
                     41: that extension will be stripped off first.)
                     42: Alternately,
                     43: .I aplcvt
                     44: can be used as a filter.
                     45: (If either the standard input or the standard
                     46: output are directed to a tty,
                     47: a syntax message is output.
                     48: It is highly unlikely that a user will want
                     49: a converted binary workspace printed on
                     50: his or her terminal.)
                     51: .PP
                     52: The default direction of conversion is
                     53: to convert to the format used by the host
                     54: machine;
                     55: i.e.
                     56: on a PDP-11 the default is to convert
                     57: VAX format to PDP-11 format.
                     58: If desired,
                     59: the direction may be specified explicitly
                     60: by a ``\-p'' or ``\-v'' flag.
                     61: .SH "SEE ALSO"
                     62: apl(1) \- the APL interpreter
                     63: .SH BUGS
                     64: Occasionally,
                     65: .I aplcvt
                     66: will bomb out with an error
                     67: when none really occurred.
                     68: This seems to be due to a bug
                     69: in the standard I/O library.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.