ascii-table/doc/ascii.1

54 lines
1.4 KiB
Groff

.\" Manpage for ascii.
.\" Contact bruce@bruce-hill.com to correct errors or typos.
.TH man 8 "3 January 2019" "1.0" "ascii man page"
.SH NAME
ascii \- An ASCII table viewer
.SH SYNOPSIS
.B ascii
[
.I N1 N2...
]
.SH DESCRIPTION
This will display an interactive ASCII table, with the byte numbers and
descriptions. You can also build up raw ASCII output, which will be printed to
stdout when the program closes.
.SH INPUT
.TP
If any input is piped to \fBascii\fR, it will appear in the output buffer.
.SH OPTIONS
.B \--help
Print the command line usage.
.B N...
If decimal or hex numbers are passed as extra arguments, the corresponding raw
ASCII values will be appended to the output buffer after any piped input.
.SH CONTROLS
.B Navigating:
In the ASCII table, arrow keys or h/j/k/l can be used to navigate.
.B Editing:
You can use 'enter' to append the selected character to the output buffer and
\'backspace' to delete from the output buffer. Or, for more rapid input, press
\'i' to enter insert mode, where you can type freely, and 'escape' when you're
done.
.B Exiting:
\'q' or 'escape' will quit and print the output buffer. Control-c can be used
to quit without printing the output buffer.
.SH EXAMPLES
.TP
.B
ascii
Open the ASCII table.
.TP
.B
printf "h" | ascii 105 | base64
Open the ASCII table with "hi" in the buffer, and pipe the output to base64
when the program closes.
.SH AUTHOR
Bruce Hill (bruce@bruce-hill.com)