README.git: Revised.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76
diff --git a/README.git b/README.git
index b8ba9b4..2bed537 100644
--- a/README.git
+++ b/README.git
@@ -1,5 +1,9 @@
README.git
-----------
+==========
+
+
+repository issues
+-----------------
FreeType's official repository site is
@@ -23,7 +27,10 @@ digit '2' for historical reasons.
freetype-demos
-The git archive doesn't contain pre-built configuration scripts for
+standard builds with `configure`
+--------------------------------
+
+The git repository doesn't contain pre-built configuration scripts for
UNIXish platforms. To generate them say
sh autogen.sh
@@ -38,33 +45,35 @@ The versions given in parentheses are known to work. Newer versions
should work too, of course. Note that `autogen.sh` also sets up
proper file permissions for the `configure` and auxiliary scripts.
-The `autogen.sh` script now checks the versions of the above three
-packages whether they match the numbers above. Otherwise it will
-complain and suggest either upgrading or using an environment variable
-to point to a more recent version of the required tool(s).
+The `autogen.sh` script checks whether the versions of the above three
+tools match the numbers above. Otherwise it will complain and suggest
+either upgrading or using environment variables to point to more
+recent versions of the required tools.
Note that `aclocal` is provided by the 'automake' package on Linux,
and that `libtoolize` is called `glibtoolize` on Darwin (OS X).
+alternative build methods
+-------------------------
+
For static builds that don't use platform-specific optimizations, no
configure script is necessary at all; saying
make setup ansi
make
-should work on all platforms that have GNU `make` (or `makepp`).
-Similarly, a build with `cmake` or `meson` can be done directly from
-the git repository.
-
+should work on all platforms that have GNU `make` (or `makepp`).
-For using the `FT_DEBUG_LOGGING` macro while debugging (see file
-`docs/DEBUG` for more information) the following git commands are
-necessary to check out the 'dlg' library as a git submodule.
+A build with `cmake` or `meson` can be done directly from the git
+repository. However, if you want to use the `FT_DEBUG_LOGGING` macro
+(see file `docs/DEBUG` for more information) it is currently mandatory
+to execute `autogen.sh` in advance; this script clones the 'dlg' git
+submodule and copies some files into FreeType's source tree.
- git submodule init
- git submodule update
+contributing
+------------
If you want to contribute to FreeType it is recommended to install the
`git-merge-changelog` program – we use a `ChangeLog` file, which often