diff options
Diffstat (limited to 'hcalc.1')
| -rw-r--r-- | hcalc.1 | 271 |
1 files changed, 271 insertions, 0 deletions
@@ -0,0 +1,271 @@ +.\" Man page generated from reStructuredText. +. +. +.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 +.. +.TH "HCALC" 1 "2024-01-03" "1.2u1" "Urchlay's Misc Stuff" +.SH NAME +hcalc \- graphical hex calculator +.\" RST source for hcalc(1) man page. Convert with: +. +.\" rst2man.py hcalc.rst > hcalc.1 +. +.SH SYNOPSIS +.sp +hcalc [\fI\-default\fP] [\fI\-small\fP | \fI\-medium\fP | \fI\-large\fP] [\fI\-dec\fP | \fI\-hex\fP | \fI\-oct\fP | \fI\-bin\fP ] [\fI\-quiet\fP] [\fI\-\-version\fP] [\fI\-\-help\fP] +.SH DESCRIPTION +.sp +\fBhcalc\fP is a small (137x174 pixels minimum) TI Programmer II +semi\-clone for Unix/X11 and Windows 95/NT. It doesn\(aqt take up much +space, and supports decimal, hex, binary, and octal modes. +.sp +\fBhcalc\fP is operated with the mouse and/or keyboard. See \fBMOUSE\fP and +\fBKEYBOARD\fP sections, below. +.SH OPTIONS +.sp +Options listed as (persistent) get saved to the config file, so +they\(aqll still apply the next time \fBhcalc\fP is started. This applies +not only to command\-line arguments; the settings get saved if they\(aqre +changed via the mouse or keyboard, too. +.INDENT 0.0 +.TP +.B \fB\-small\fP +Display in a 125x147 window (persistent). +.TP +.B \fB\-medium\fP +Display in a 250x294 window (persistent). +.TP +.B \fB\-large\fP +Display in a 500x588 window (persistent). This is the default. +.TP +.B \fB\-dec\fP +Start up in decimal mode (persistent). This is the default. +.TP +.B \fB\-hex\fP +Start up in hexadecimal mode (persistent). +.TP +.B \fB\-oct\fP +Start up in octal mode (persistent). +.TP +.B \fB\-bin\fP +Start up in binary mode (persistent). +.TP +.B \fB\-default\fP +Do not read the config file on startup. \fINOTE:\fP This option must +be the first on the command line, or it will be ignored! +.TP +.B \fB\-quiet\fP +Do not ring the X bell on invalid input (persistent). +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-version +Output version number and exit. +.TP +.B \-\-help +Output usage string and exit. +.UNINDENT +.SH DISPLAY +.sp +The numeric display is limited to 15 digits in decimal, hex, or octal +base. In binary mode, it displays 32 bits, but uses narrow "ticks" +rather than 0 and 1. +.sp +In hex mode, the number in the display will always be prefixed with +"0x". In octal mode, it will always be prefixed with "0". In decimal +mode, there is no prefix. +.sp +In case of error (e.g. division by zero), the display will show a +lowercase "f" in decimal mode, or only the prefix in hex or octal +mode, or all 0 bits in binary mode. When this happens, you may have to +press \fBCLR\fP or \fBEscape\fP to recover. +.SH MOUSE +.sp +Mouse operation is simple: for the most part, just click on the +buttons to press them. +.sp +There\(aqs no \fI%\fP button for the modulus operator, but you can +right\-click on the \fI÷\fP (division) key. +.sp +Right\-clicking (or any button other than 1) on the \fICLR\fP key exits +\fBhcalc\fP\&. +.sp +For the numeric display, clicking button 1 (usually the left one) +copies the number to the X selection buffer. Clicking any other +button pastes from X, but beware: pasting anything but a number in +the current base might have unexpected effects, because all pasted +characters are treated as keystrokes (so, e.g. pasting a capital Q +quits the application). This can be useful, e.g. if you paste "2+2=", +\fBhcalc\fP will display "4". +.SH KEYBOARD +.INDENT 0.0 +.TP +.B \fB0\-9\fP, \fBa\-f\fP +Digits. Lowercase only for the hex digits. Entering digits +larger than the current number base is impossible (e.g. hex digits +when in decimal mode, or digits other than 0 or 1 in binary mode) and +will be ignored. +.TP +.B \fB+\fP \fB\-\fP \fB*\fP \fBx\fP \fB/\fP \fB%\fP +Arithmetic: addition, subtraction, multiplication, division, modulus. Note that +\fBx\fP is the same as \fB*\fP\&. +.TP +.B \fB\&.\fP +Decimal point. Only works in decimal mode (base 10); other bases +are integer\-only. +.TP +.B \fB_\fP +Invert sign. The \fI+/\-\fP key. +.TP +.B \fB=\fP \fBEnter\fP +The \fI=\fP key (equals). +.TP +.B \fB&\fP \fB|\fP \fB^\fP \fB~\fP +Boolean operations. AND, OR, XOR, NOT (unary). +.TP +.B \fB<\fP \fB>\fP +Bit shifts, unary. Left 1 bit, right 1 bit. +.TP +.B \fBS\fP +\fISHF\fP key: shift left/right by some number of bits (binary +operation, like addition). Shifts left for positive +numbers and right for negative. This is less confusing +than it sounds: 1 shifted left once is 2, \-1 shifted right +once in \-2. +.TP +.B \fBBackspace\fP \fBDelete\fP +\fIDEL\fP key: delete the rightmost digit. +.TP +.B \fBC\fP \fBEscape\fP +\fICLR\fP key: clears the number. +.TP +.B \fBD\fP \fBH\fP \fBO\fP \fBB\fP +Set the number base to decimal, hex, octal, or binary. The +number currently displayed is converted into the new base. +These are capital letters (hold down Shift). +.TP +.B \fBF1\fP \fBF2\fP \fBF3\fP \fBF4\fP +Same as \fBD\fP \fBH\fP \fBO\fP \fBB\fP\&. +.TP +.B \fB[\fP \fB]\fP \fB}\fP +\fISTO\fP (store number), \fIRCL\fP (recall stored number), \fISUM\fP +(add current number to stored number). \fISTO\fP, \fIRCL\fP, and \fISUM\fP are +the same as \fIM\fP, \fIMR\fP, and \fIM+\fP on \(aqpocket\(aq calculators. +.TP +.B \fB^C\fP +Copy the current number to the X selection +buffer. Same as clicking mouse button 1 (usually left) on the number. +.TP +.B \fB^V\fP +Paste from the X selection buffer. +Same as clicking a mouse button other than 1 (right\-clicking) on the number. +.TP +.B \fBq\fP +Quiet. Toggles the audible bell. +.TP +.B \fBQ\fP \fB^Q\fP +Quit \fBhcalc\fP\&. Capital letter, so press Shift. Control\-Q does +the same thing. +.TP +.B \fBz\fP +Zoom: change window size. Alternates between the 3 sizes: \fB\-small\fP, +\fB\-medium\fP, \fB\-large\fP\&. +.UNINDENT +.\" other sections we might want, uncomment as needed. +. +.SH FILES +.INDENT 0.0 +.TP +.B \fB$HOME/.hcalc.cfg\fP +Config file. This is a binary file, not human\-readable, and not +portable across architectures. It gets read on startup (unless +\fB\-default\fP is given) and written on exit. It stores the +number base, window size (as set on the command line), +the number that was displayed on exit, the contents of the +\fISTO\fP memory, and the \fB\-quiet\fP flag. +.sp +Some care is taken to make sure a config file from a different +architecture won\(aqt be used. +.sp +Since the config file isn\(aqt human\-readable, an easy way to +create one is to run \fBhcalc\fP with \fB\-default\fP plus your preferred +options. Example: +.INDENT 7.0 +.INDENT 3.5 +.sp +.nf +.ft C +hcalc \-default \-quiet \-large \-hex +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +\&...which will kill any existing config file, and create a new one +that stores the options you gave. Now when you run \fBhcalc\fP with +no options, it will start up in hex mode, in a large window, and won\(aqt +ring the bell. +.sp +An even easier way is just to run \fBhcalc\fP and use the controls to +set the number base, size, and quiet flag. These settings automatically +get saved to the config file. +.UNINDENT +.SH ENVIRONMENT +.INDENT 0.0 +.TP +.B \fBHOME\fP +Config file is searched for here. If this is not set, or can\(aqt be +read, no config file will be read or written. +.TP +.B \fBDISPLAY\fP +X display to use. +.UNINDENT +.\" EXIT STATUS +. +.\" =========== +. +.\" BUGS +. +.\" ==== +. +.\" EXAMPLES +. +.\" ======== +. +.SH COPYRIGHT +.sp +\fBhcalc\fP is released under the terms of the GNU GPL. +.SH AUTHORS +.sp +\fBhcalc\fP was originally written by DJ Delorie, modified by +Theodore Kilgore, and modified again by B. Watson, who also +wrote this man page. +.SH SEE ALSO +.sp +\fBxcalc\fP(1) +.\" Generated by docutils manpage writer. +. |