Edit

kc3-lang/freetype/README.git

Branch :

  • Show log

    Commit

  • Author : Werner Lemberg
    Date : 2021-07-03 20:24:16
    Hash : 5e32a034
    Message : README.git: Revised.

  • README.git
  • README.git
    ==========
    
    
    repository issues
    -----------------
    
    FreeType's official repository site is
    
      https://gitlab.freedesktop.org/freetype  ,
    
    from  which the  'freetype.git' and  'freetype-demos.git' repositories
    can be cloned in the usual way.
    
      git clone https://gitlab.freedesktop.org/freetype/freetype.git
      git clone https://gitlab.freedesktop.org/freetype/freetype-demos.git
    
    If you  want to  use the  Savannah mirror  instead, you  have to  do a
    slightly different  incantation because  the repository  names contain
    digit '2' for historical reasons.
    
      git clone \
        https://git.savannah.nongnu.org/git/freetype/freetype2.git \
        freetype
      git clone \
        https://git.savannah.nongnu.org/git/freetype/freetype2-demos.git \
        freetype-demos
    
    
    standard builds with `configure`
    --------------------------------
    
    The git repository doesn't contain pre-built configuration scripts for
    UNIXish platforms.  To generate them say
    
      sh autogen.sh
    
    which in turn depends on the following packages:
    
      automake (1.10.1)
      libtool (2.2.4)
      autoconf (2.62)
    
    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 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`).
    
    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.
    
    
    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
    prevents   simple   merging   due  to   conflicts.    Most   GNU/Linux
    distributions  have a  package  for this  program;  otherwise you  can
    install it via the 'gnulib' git repository.  Detailed instructions can
    be found at the beginning of
    
      https://git.savannah.gnu.org/cgit/gnulib.git/tree/lib/git-merge-changelog.c
    
    To make  it actually work, add  to file `.git/config` in  the FreeType
    git repository (or to your `$HOME/.gitconfig` file) the lines
    
      [merge "merge-changelog"]
         name = GNU-style ChangeLog merge driver
         driver = /usr/local/bin/git-merge-changelog %O %A %B
    
    
    ----------------------------------------------------------------------
    
    Copyright (C) 2005-2021 by
    David Turner, Robert Wilhelm, and Werner Lemberg.
    
    This  file is  part of  the FreeType  project, and  may only  be used,
    modified,  and distributed  under the  terms of  the  FreeType project
    license,  LICENSE.TXT.  By  continuing to  use, modify,  or distribute
    this file you  indicate that you have read  the license and understand
    and accept it fully.
    
    
    --- end of README.git ---