initial commit

3 files changed, 65 insertions, 0 deletions

diff --git a/inst/usr/doc/blah/CHANGES b/inst/usr/doc/blah/CHANGES
new file mode 100644
index 0000000..7cddba0
--- /dev/null
+++ b/inst/usr/doc/blah/CHANGES
@@ -0,0 +1,37 @@
+Version 1.2u1, 2024/01/02:
+--------------------------
+- Support original size (125x147), 2x (250x294), and 4x (500x588).
+- Recreate the 250x294 graphics by resizing without interpolation,
+  to give a "crisp and pixellated" look rather than blurry.
+- Change the build system back to make. This project is so simple
+  that I don't see any benefit in using cmake.
+- Add icons and .desktop files.
+- Tell the window manager not to allow resizing the window. The
+  app can't resize anyway, so trying to make the window bigger just
+  results in a confusing mess. Making it smaller works, but parts
+  of the UI get cut off so it's unusable. Probably, tiling window
+  managers will ignore this (not much I can do about that).
+- Fix a few -Wall warnings.
+- Fix a segfaulting bug. To reproduce, start up the old hcalc and
+  press Backspace 6 times (or so; eventually it will crash).
+- Add command-line options to control the window size (-small -medium
+  -large).
+- Add command line options to control the starting number base (-hex,
+  -dec, etc).
+- Add a man page. There was no documentation at all.
+- Change "q" to quit, to uppercase Q or control-Q. I kept exiting when
+  trying to type a 1.
+- Get rid of ^C = quit keystroke.
+- Add ^C and ^V keystrokes for copy and paste. Now hcalc is fully
+  functional without using the mouse.
+- Add modulus operation. % key, or right-click on / button.
+- Add C as a synonym for Escape (CLR key).
+- Add Delete as a synonym for backspace (DEL key).
+- Fix a bug: stop allowing hex digits a-f when in decimal mode.
+- Add ~/.hcalc.cfg, which holds the state of hcalc. Written on exit,
+  read on startup. Also add -default arg, to prevent reading this.
+- Add -quiet option to silence the X bell.
+- Allow changing the window size while running (toggle between the 3
+  sizes).
+- Add a 'make install' target, which will install the binary, icons,
+  man page, and .desktop file (with DESTDIR support for packagers).
diff --git a/inst/usr/doc/blah/README b/inst/usr/doc/blah/README
new file mode 100644
index 0000000..be32bfd
--- /dev/null
+++ b/inst/usr/doc/blah/README
@@ -0,0 +1,27 @@
+README for Urchlay's fork of hcalc
+----------------------------------
+
+This is a fork of hcalc with some fixes and enhancements.
+
+Original hcalc is by DJ Delorie, and can be found here:
+https://www.delorie.com/store/hcalc/
+This version dates back to the late 90s, when computer monitors had
+lower resolution. It uses a 125x147 window, which is pretty small and
+hard to read on a modern display (particularly a 4K one). It's also
+harder to click on the tiny buttons.
+
+Sometime around 2007, Theodore Kilgore forked hcalc and made some
+changes:
+- Increase the application's window size by 2x (from 125x147
+  to 250x294). This helps some with modern displays.
+- Make the window manager's close button work.
+- Change the build system from make to cmake.
+- Add a copy of the GPL as COPYING, since the original version
+  doesn't have it (though the site states that it's GPL).
+This was released as hcalc-1.2, and can be found here:
+https://github.com/jlec/hcalc/
+Also, this is the version packaged by Gentoo.
+
+In 2024, I (B. Watson, urchlay@slackware.uk) have made many further
+changes. See CHANGES for the list. See the man page for full
+documentation (something that was lacking in the previous releases).
diff --git a/inst/usr/doc/blah/TODO b/inst/usr/doc/blah/TODO
new file mode 100644
index 0000000..d60c774
--- /dev/null
+++ b/inst/usr/doc/blah/TODO
@@ -0,0 +1 @@
+- Cleaner way of switching window sizes at runtime.