"Fossies" - the Fresh Open Source Software Archive

Member "Free42Linux/README" (5 May 2022, 6937 Bytes) of package /linux/misc/Free42Linux.tgz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 About Free42
    2 
    3 Free42 is a complete re-implementation of the HP-42S scientific programmable
    4 RPN calculator, which was made from 1988 until 1995 by Hewlett-Packard.
    5 Free42 is a complete rewrite and contains no HP code whatsoever.
    6 At this time, the author supports versions that run on Android, iOS, Microsoft
    7 Windows, MacOS, and Linux.
    8 
    9 
   10 Installing Free42:
   11 
   12 Copy free42dec (or free42bin, or both) to wherever you want it, e.g. $HOME/bin
   13 or /usr/local/bin, and make sure that that directory is in your PATH
   14 environment variable.
   15 When Free42 runs, it will create a directory named free42 under $XDG_DATA_HOME,
   16 or under $HOME/.local/share if XDG_DATA_HOME is unset or empty.
   17 In this directory, it will create three files, 'state', 'print', and 'keymap'
   18 (the calculator's internal state, the contents of the print-out window, and the
   19 PC keyboard map); also, if you want to use a non-standard skin with Free42,
   20 this directory is where you have to store the skin's layout and bitmap files.
   21 
   22 System administrators may also make skins available to all users by storing
   23 them in a directory named free42 or free42/skins, relative to one or more of
   24 the directories in $XDG_DATA_DIRS, or /usr/local/share:/usr/share if
   25 XDG_DATA_DIRS is unset or empty.
   26 
   27 If you're using GNOME 3, you can create a *.desktop file. Create it as
   28 $HOME/.local/share/applications/com.thomasokken.free42.desktop, with contents
   29 like this:
   30 
   31   [Desktop Entry]
   32   Comment=
   33   Terminal=false
   34   Name=Free42
   35   Exec=/home/thomas/free42/free42dec
   36   Type=Application
   37   Icon=/home/thomas/free42/free42icon-128x128.xpm
   38 
   39 Change the /home/thomas/free42 part to where you have the free42dec executable
   40 and the icon.
   41 With this file in place, click on Activities and type Free42 in the search box;
   42 click on the Free42 icon that it finds, and then right-click on the Free42 icon
   43 that appears in the Favorites bar, and select Add to Favorites.
   44 
   45 
   46 Uninstalling Free42:
   47 
   48 Remove free42dec, free42bin, and the $XDG_DATA_HOME/free42 or
   49 $HOME/.local/share/free42 directory and its contents.
   50 
   51 
   52 NOTE: The binary in this package was built on a PC running Ubuntu 12.04, and it
   53 is dynamically linked against glibc version 3.2, libstdc++ version 4.6.3, and
   54 GTK+ version 3.4.2. If your system has different versions of these libraries,
   55 the binary in this package may not work. In this case, please download the
   56 Free42 source package and compile Free42 using your installation's own compiler
   57 and libraries.
   58 
   59 
   60 Documentation
   61 
   62 Visit https://thomasokken.com/free42/#doc for more information.
   63 
   64 
   65 Keyboard Mapping
   66 
   67 You don't have to use the mouse to press the keys of the emulated calculator
   68 keyboard; all keys can be operated using the PC's keyboard as well. The
   69 standard keyboard mapping is as follows:
   70 
   71 Σ+       F1, or 'a' as in "Accumulate"
   72 Σ-       Shift F1, or 'A' (Shift a)
   73 1/X      F2, or 'v' as in "inVerse"
   74 Y^X      Shift F2, or 'V' (Shift v)
   75 √x       F3, or 'q' as in "sQuare root"
   76 X^2      Shift F3, or 'Q' (Shift q)
   77 LOG      F4, or 'o' as in "lOg, not ln"
   78 10^X     Shift F4, or 'O' (Shift o)
   79 LN       F5, or 'l' as in "Ln, not log"
   80 E^X      Shift F5, or 'L" (Shift l)
   81 XEQ      F6, or 'x' as in "Xeq"
   82 GTO      Shift F6, or 'X' (Shift x), or 'g' as in "Gto"
   83 
   84 STO      'm' as in "Memory"
   85 COMPLEX  'M' (Shift m)
   86 RCL      'r' as in "Rcl"
   87 %        'R' (Shift r)
   88 R↓       'd' as in "Down"
   89 π        'D' (Shift d), or 'p' as in "Pi"
   90 SIN      's' as in "Sin"
   91 ASIN     'S' (Shift s)
   92 COS      'c' as in "Cos"
   93 ACOS     'C' (Shift c)
   94 TAN      't' as in "Tan"
   95 ATAN     'T' (Shift t)
   96 
   97 ENTER    Enter or Return
   98 ALPHA    Shift Enter or Shift Return
   99 X<>Y     'w' as in "sWap"
  100 LASTX    'W' (Shift w)
  101 +/-      'n' as in "Negative"
  102 MODES    'N' (Shift n)
  103 E        'e' as in "Exponent" (duh...)
  104 DISP     'E' (Shift e)
  105 <-       Backspace
  106 CLEAR    Shift Backspace
  107 
  108 ▲        CursorUp
  109 BST      Shift CursorUp
  110 7        '7'
  111 SOLVER   '&' (Shift 7)
  112 8        '8'
  113 ∫f(x)    Alt 8 (can't use Shift 8 because that's 'x' (multiply))
  114 9        '9'
  115 MATRIX   '(' (Shift 9)
  116 ÷        '/'
  117 STAT     '?' (Shift /)
  118 
  119 ▼        CursorDown
  120 SST      Shift CursorDown
  121 4        '4'
  122 BASE     '$' (Shift 4)
  123 5        '5'
  124 CONVERT  '%' (Shift 5)
  125 6        '6'
  126 FLAGS    '^' (Shift 6)
  127 ×        '*'
  128 PROB     Ctrl 8 (can't use Shift * because '*' is shifted itself (Shift 8))
  129 
  130 Shift    Shift
  131 1        '1'
  132 ASSIGN   '!' (Shift 1)
  133 2        '2'
  134 CUSTOM   '@' (Shift 2)
  135 3        '3'
  136 PGM.FCN  '#' (Shift 3)
  137 -        '-'
  138 PRINT    '_' (Shift -)
  139 
  140 EXIT     Escape
  141 OFF      Shift Escape
  142 0        '0'
  143 TOP.FCN  ')' (Shift 0)
  144 .        . or ,
  145 SHOW     '<' or '>' (Shift . or Shift ,)
  146 R/S      '\' (ummm... because it's close to Enter (or Return))
  147 PRGM     '|' (Shift \)
  148 +        '+'
  149 CATALOG  '=' (Can't use Shift + because + is shifted itself (shift =))
  150 
  151 In A..F mode (meaning the "A..F" submenu of the BASE menu), the PC keyboard
  152 keys A through F are mapped to the top row of the calculator's keyboard (Σ+
  153 through XEQ); these mappings override any other mappings that may be defined
  154 for A through F.
  155 
  156 In ALPHA mode, all PC keyboard keys that normally generate printable ASCII
  157 characters, enter those characters into the ALPHA register (or to the command
  158 argument, if a command with an alphanumeric argument is being entered). These
  159 mappings override any other mappings that may be defined for those keys.
  160 
  161 
  162 What's the deal with the "Decimal" and "Binary" (free42dec/free42bin)?
  163 
  164 Starting with release 1.4, Free42 comes in decimal and binary versions. The two
  165 look and behave identically; the only difference is the way they represent
  166 numbers internally.
  167 Free42 Decimal (free42dec) uses the Intel Decimal Floating-Point Math Library;
  168 it uses IEEE-754-2008 quadruple precision decimal floating point, which
  169 consumes 16 bytes per number, and gives 34 decimal digits of precision, with
  170 exponents ranging from -6143 to +6144.
  171 Free42 Binary (free42bin) uses the PC's FPU; it represents numbers as IEEE-754
  172 compatible double precision binary floating point, which consumes 8 bytes per
  173 number, and gives an effective precision of nearly 16 decimal digits, with
  174 exponents ranging from -308 to +308.
  175 The binary version has the advantage of being much faster than the decimal
  176 version; also, it uses less memory. However, numbers such as 0.1 (one-tenth)
  177 cannot be represented exactly in binary, since they are repeating fractions
  178 then. This inexactness can cause some HP-42S programs to fail.
  179 If you understand the issues surrounding binary floating point, and you do not
  180 rely on legacy software that may depend on the exactness of decimal fractions,
  181 you may use Free42 Binary and enjoy its speed advantage. If, on the other hand,
  182 you need full HP-42S compatibility, you should use Free42 Decimal.
  183 If you don't fully understand the above, it is best to play safe and use
  184 Free42 Decimal (free42dec).
  185 
  186 
  187 Free42 is (C) 2004-2022, by Thomas Okken
  188 Contact the author at thomasokken@gmail.com
  189 Look for updates, and versions for other operating systems, at
  190 https://thomasokken.com/free42/