slackbuilds/misc/cp437/cp437.1

91 lines
2.5 KiB
Groff
Raw Normal View History

.\" Man page generated from reStructuredText.
.
.TH CP437 1 "2020-11-25" "0.6" "SlackBuilds.org"
.SH NAME
cp437 \- emulate code page 437 on a UTF-8 terminal
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" RST source for cp437(1) man page. Convert with:
.
.\" rst2man.py cp437.rst > cp437.1
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
cp437 \fBcommand\fP [\fIarg\fP [\fIarg\fP ...]]
.SH DESCRIPTION
.sp
cp437 is a program to emulate an old\-style "code page 437" / "IBM\-PC"
character set terminal on a modern terminal emulator that uses UTF\-8
or similar.
.sp
It was written for the purpose of running the BitchX IRC client, which utilises
CP437 line\-drawing characters in its default theme and artwork. It should
also be broadly useful for things like viewing CP437 "ANSI art", running
nethack with the IBMgraphics option or running EPIC with scripts that use CP437
artwork.
.sp
It takes no command line options. The only arguments are the command to run
and its arguments (if any).
.sp
You\(aqll need to have your LANG or LC_CTYPE environment variable
set up to match the character set used by your terminal
emulator. On Slackware, this can be done system\-wide by editing
\fB/etc/profile.d/lang.sh\fP, or by editing your shell\(aqs startup scripts
(e.g. \fB~/.bash_profile\fP).
.SH EXAMPLES
.sp
Just run cp437 followed by the command and argument you want to run:
.INDENT 0.0
.INDENT 3.5
cp437 BitchX irc.efnet.org
.UNINDENT
.UNINDENT
.sp
To convert a text file from codepage 437, you might try:
.INDENT 0.0
.INDENT 3.5
cp437 cat orig.txt > converted.txt
.UNINDENT
.UNINDENT
.SH COPYRIGHT
.sp
See the file /usr/doc/cp437\-0.6/COPYRIGHT for license information.
.SH AUTHORS
.sp
cp437 was written by Kevin Easton.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
The cp437 homepage: \fI\%https://github.com/keaston/cp437\fP
.\" Generated by docutils manpage writer.
.