.\" # @configure_input@
.\"
.\" $Id$
.\" Copyright (c) 2005  G. Allen Morris III
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining
.\" a copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish,
.\" distribute, sublicense, and/or sell copies of the Software, and to
.\" permit persons to whom the Software is furnished to do so, subject to
.\" the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of the X Consortium shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from the X Consortium.
.\"
.\" $XFree86: xc/programs/xcalc/xcalc.man,v 1.5 2003/03/19 01:49:28 dawes Exp $
.\"
.de EX		\"Begin example
.ne 5
.if n .sp 1
.if t .sp .5
.nf
.in +.5i
..
.de EE
.fi
.in -.5i
.if n .sp 1
.if t .sp .5
..
.TH X48NG 1 "14 September 2023" "Version @VERSION@" "X48NG Manual Pages"
.SH NAME
x48ng \- scientific calculator and an HP 48 emulator
.SH SYNOPSIS
.B x48ng
[\--options ...]

where options include:
.br
        \-h \-\-help                    what you are reading
.br
        \-v \-\-version                 show version
.br
           \-\-config\-dir=<path>       use <path> as x48ng's home (default: ~/.x48ng/)
.br
           \-\-rom\-file=<filename>     use <filename> (relative to <config\-dir>) as ROM (default: rom)
.br
           \-\-ram\-file=<filename>     use <filename> (relative to <config\-dir>) as RAM (default: ram)
.br
           \-\-state\-file=<filename>   use <filename> (relative to <config\-dir>) as STATE (default: hp48)
.br
           \-\-port1\-file=<filename>   use <filename> (relative to <config\-dir>) as PORT1 (default: port1)
.br
           \-\-port2\-file=<filename>   use <filename> (relative to <config\-dir>) as PORT2 (default: port2)
.br
           \-\-serial\-line=<path>      use <path> as serial device default: /dev/ttyS0)
.br
        \-V \-\-verbose                 be verbose (default: false)
.br
        \-u \-\-front-end               specify a front-end (available: x11, sdl; default: x11)
.br
           \-\-no\-chrome               [SDL only] only display the LCD (default: false)
.br
           \-\-fullscreen               [SDL only] make the UI fullscreen (default: false)
.br
           \-\-netbook                  [X11 only] make the UI horizontal (default: false)
.br
        \-t \-\-use\-terminal            activate pseudo terminal interface (default: true)
.br
        \-s \-\-use\-serial              activate serial interface (default: false)
.br
           \-\-no\-debug                disable the debugger
.br
        \-i \-\-initialize              initialize the content of <config\-dir>
.br
        \-r \-\-reset                   perform a reset on startup
.br
        \-T \-\-throttle                try to emulate real speed (default: false)


.SH DESCRIPTION
.I x48ng
is a scientific calculator desktop accessory that emulate an HP\-48 SX
or an HP\-48 GX.
\" .SH OPTIONS
\" .PP
\" \fIx48ng\fP accepts all of the standard toolkit command line options along
\" with several additional options:
\" .PP
\" .TP 8
\" .B \-help
\" Show a list of options.
\" .PP
\" .TP 8
\" .B \-version
\" This  causes  x48ng  to  print a version number to the standard output.
\" .PP
\" .TP 8
\" .B \-iconic
\" Start iconic
\" .SH OPERATION

.PP
x48ng emulates an HP 48 calculator. This manual does not attempt to
describe the operation of the HP calulator, but only the user interface
to the emulator.

\" .I Pointer Usage:
\" When mouse button one is press on an x48ng key the key is depress until
\" the mouse button is released.  If you wish to have more than one key
\" press at a time mouse button 3 may be used.  Button pressed with mouse
\" button 3 will remain pressed until mouse button 1 is used.  For example
\" to reset the calulator you can press the A key and the F key with mouse
\" button 3 and then press the on button with mouse button 1.

\" Mouse button 2 will paste the text in the cut buffer to the calculator
\" if it is press in the display area of the calculator. See notes on
\" pasting text into the calculator below.

\" Use of mouse elsewhere on the image of the calculator is undefined.

.SH ACCELERATORS

The keyboard may be used to input data into the x48ng.
The number keys on the keyboard coresponds to the number buttons on
the calaculator, and the alphbetic keys on the keyboard control the
buttons on the top half of the calculator and the @code{+/-} and
@code{EXX} keys.

The @code{ENTER} button is attached to the Enter key, the delete key
to the <-/DROP button and Divide, multiply, subtract and add buttons to
the /, *, -, and + keys on the key board.

.SH COLORS
The x48ng is trying to look like a particular device.
The colors are therefore not selectable.
.br
\" .SH "ENVIRONMENT"
\" XUSERFILESEARCHPATH
\" .SH "SEE ALSO"
\" X(7x), xrdb(1)
.SH BUGS
.PP
Bugs can be found and reported at: https://github.com/gwenhael-le-moine/x48ng
.SH COPYRIGHT
Copyright \(co 1994-2005 Eddie C. Dost
.br
Copyright \(co 2023- Gwenhael Le Moine
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH AUTHORS
Eddie C. Dost
.br
G. Allen Morris III <gam3@gam3.net>
.br
Gwenhael Le Moine