tuxpaint-pencil-sharpener/Resources
Mark K. Kim 4231370205 Changes to make testing in macOS easier.
Previously, testing in macOS required running `make install`, switching
over to the Finder, then double clicking TuxPaint.app, which was a time
consuming process.  This change allows the tuxpaint binary to be run
directly from the command line (./tuxpaint) without `make install`, which
makes it easier to test any small code change.  Now `make install` is only
required to build the TuxPaint.app bundle for execution from the
Finder.

FYI, `make install` also builds TuxPaint.dmg for distribution.  A small
change is included in this commit to allow TuxPaint.dmg to be built without
building TuxPaint.app (if, for example, you delete TuxPaint.dmg by accident
and need to rebuild it.)  This is done via `make TuxPaint.dmg`.
2018-06-27 22:16:13 -04:00
..
share Changes to make testing in macOS easier. 2018-06-27 22:16:13 -04:00
README.txt Changes to make testing in macOS easier. 2018-06-27 22:16:13 -04:00

This folder exists to ease testing under macOS.  Please ignore but do not
delete.  More details are below.

macOS requires all files in an application have a specific folder structure.
We create this structure under the folder "TuxPaint.app" when `make install` is
run.  But `make install` takes a long time to run under macOS due to the large
number of files that need to be copied, as well as all the processing we do to
those files (see custom/macos.sh for what we need to do.)  This makes testing
even a small code change time consuming.

That's the problem this folder solves:  Instead of creating the folder
structure under TuxPaint.app every time to test a code change to be able to run
the application, we pre-build the folder structure around the tuxpaint binary
so the binary can be executed directly without re-creating the folder structure
every time.  Luckily for us, this only require that we only have a single
folder "Resources" in the root folder of the tuxpaint source code (with some
subfolders and symlinks underneath the Resources folder.)

I hope my fellow Tux Paint contributors will forgive me for taking up yet
another whole folder for use by a single platform, let alone almost empty, in
the root folder of the source code distribution meant for multiple platforms.

Mark Kim
2018.06.27