# sofort: portable software project skeleton
This README file aims to speed-up the initial use of sofort
with your own project while accounting for diverse groups
of learners.
On that note, and in addition to making the most out of this document,
you might want to join the (un)usually friendly #midipix channel on
the libera irc network.
## LEARN BY COMPARISON:
- `git clone git://foss21.org/sofort`
- `git clone git://foss21.org/mdso`
- `diff -u sofort/config.project mdso/config.project`
- `diff -ru sofort/project mdso/project`
## LEARN BY EXAMPLE:
* mdso: basic configuration, explicit source list
https://git.foss21.org/cgit.cgi/mdso/
* bfirm: an external build project for libfirm, using wildcards
in project/common.mk and project/headers.mk.
https://git.foss21.org/cgit.cgi/compilers/bfirm/
* sbpython3: an external build project for python3.x, utilizing
sofort's config test framework (cfgtest.sh) and a custom config
step (project/config/cfgdefs.sh).
## LEARN BY INSTRUCTION:
* First Use-Case: using sofort with an existing project
- keep your original repository and the build project separate;
- allow testing the new build system (sofort) against the old one;
- merge the two at the time of your choice.
* for the purpose of illustration:
- foo (directory containing your original project)
- bfoo (directory containing the new build project)
- temp (where you'll run configure, which could be bfoo or elsewhere)
- copy all files and folders from the top-level sofort repository
into bfoo; the _include_ and _src_ sub-directories are place-holders,
and may thus be removed.
- edit config.project, keeping all three components (front-end, shared,
static) disabled for the time being.
- test that everything is ready:
cd temp && /path/to/bfoo/configure --source-dir=/path/to/foo && make
- the default location for public (api) headers is include/foo/
- edit project/common.mk and project/headers.mk. Whether you use
wildcards or explicit references to source files and headers is
entirely up to you, and bears no effect on the build process.
- edit config.project again, and enable the relevant component(s), that
is, any or all of front-end, shared, and static); note also that you
may remove whichever portion of config.project that is irrelevant to
your project.
- test again.
* Second Use-Case: using sofort with a new project
- keeping everything under a single repository;
- no need to pass --source-dir=/path/to/foo to configure;
- otherwise identical to the first use-case, as outlined above.
midipix committed 2 years ago
