code / ascii-table

   1 .\" Manpage for ascii.
   2 .\" Contact bruce@bruce-hill.com to correct errors or typos.
   3 .TH man 8 "3 January 2019" "1.0" "ascii man page"
   4 .SH NAME
   5 ascii \- An ASCII table viewer
   6 .SH SYNOPSIS
   7 .B ascii
   8 [
   9 .I N1 N2...
  10 ]
  11 .SH DESCRIPTION
  12 This will display an interactive ASCII table, with the byte numbers and
  13 descriptions.  You can also build up raw ASCII output, which will be printed to
  14 stdout when the program closes.
  15 .SH INPUT
  16 .TP
  17 If any input is piped to \fBascii\fR, it will appear in the output buffer.
  18 .SH OPTIONS
  19 .B \--help
  20 Print the command line usage.
  21 
  22 .B N...
  23 If decimal or hex numbers are passed as extra arguments, the corresponding raw
  24 ASCII values will be appended to the output buffer after any piped input.
  25 
  26 .SH CONTROLS
  27 .TP
  28 .B Navigating:
  29 In the ASCII table, arrow keys or h/j/k/l can be used to navigate.
  30 
  31 .TP
  32 .B Searching:
  33 Pressing \fB/\fR will open a search. You can begin typing to search by
  34 character or by name, and hit \fBenter\fR to select the result or \fBescape\fR
  35 to cancel. After selecting a result, you can hit \fBn\fR to jump to the next
  36 match or \fBN\fR to jump to the previous match.
  37 
  38 .TP
  39 .B Editing:
  40 You can hit \fBenter\fR to append the selected character to the output buffer
  41 and \fBbackspace\fR to delete from the output buffer. Or, for more rapid input,
  42 press \fBi\fR to enter insert mode, where you can type freely, and \fBescape\fR
  43 when you're done.
  44 
  45 .TP
  46 .B Exiting:
  47 Press \fBq\fR or \fBescape\fR to quit and print the output buffer or hit
  48 \fBcontrol-c\fR to quit without printing anything.
  49 
  50 
  51 .SH EXAMPLES
  52 .TP
  53 .B
  54 ascii
  55 Open the ASCII table.
  56 
  57 .TP
  58 .B
  59 printf "h" | ascii 105 | base64
  60 Open the ASCII table with "hi" in the buffer, and pipe the output to base64
  61 when the program closes.
  62 
  63 .SH AUTHOR
  64 Bruce Hill (bruce@bruce-hill.com)