Go to file
Alex Richardson f7c6a06cb7 Support architectures where long is smaller than pointers.
I am currently trying to compile FreeType for CHERI-extended ISAs
(CHERI-RISC-V and Arm's Morello), but I am getting compiler warnings
from the `FT_UINT_TO_POINTER` macro.  When compiling with the CHERI
Clang compiler, not using `uinptr_t` for casts between integers an
pointers results in the following `-Werror` build failures:

```
In file included from .../src/truetype/truetype.c:22:
  .../src/truetype/ttgload.c:1925:22: error:
    cast from provenance-free integer type to pointer type will
    give pointer that can not be dereferenced
    [-Werror,-Wcheri-capability-misuse]
  node->data = FT_UINT_TO_POINTER( glyph_index );
               ^
  .../include/freetype/internal/compiler-macros.h:79:34: note:
    expanded from macro 'FT_UINT_TO_POINTER'
```

* include/freetype/internal/compiler-macros.h (FT_UINT_TO_POINTER):
The ISO C standard compliant fix for this would be to use
`uintptr_t` from `stdint.h`, but I am not sure if this is supported
by the minimum compiler version.  Therefore, use the
compiler-defined `__UINTPTR_TYPE__` macro (supported in GCC 4.6+ and
Clang since about 3.0) before checking for `_WIN64` and falling back
to `unsigned long`.
2021-07-15 12:09:04 +02:00
builds [build] Allow overriding of ANSIFLAGS for GNU make build. 2021-05-29 00:27:40 +02:00
devel Small clean-ups for the last few commits. 2021-07-12 22:03:25 +02:00
docs Small clean-ups for the last few commits. 2021-07-12 22:03:25 +02:00
include Support architectures where long is smaller than pointers. 2021-07-15 12:09:04 +02:00
objs * builds/windows/vc2010/freetype.vcxproj: AfterBuild copy. 2017-12-16 22:00:40 -05:00
src [base] Fix FT_Open_Face's handling of user-supplied streams. 2021-07-13 11:00:48 +02:00
subprojects Update 'dlg' subproject. 2021-07-12 06:01:14 +02:00
tests [meson] Add first regression test to FreeType 2021-06-16 10:28:47 +02:00
.clang-format Add .clang-format file 2020-07-16 15:51:06 +02:00
.gitattributes .gitattributes: New file. 2021-01-16 09:13:44 +01:00
.gitignore [meson] Add first regression test to FreeType 2021-06-16 10:28:47 +02:00
.gitlab-ci.yml [CI] Introduce linux CI and refactor job names 2021-06-29 08:43:30 +02:00
.gitmodules Move 'dlg' submodule to subprojects directory. 2021-02-16 14:07:18 +01:00
.mailmap .mailmap: Updated and synchronized with 'freetype2-demos' repository. 2020-12-24 08:43:55 +01:00
autogen.sh Move 'dlg' submodule to subprojects directory. 2021-02-16 14:07:18 +01:00
ChangeLog Support architectures where long is smaller than pointers. 2021-07-15 12:09:04 +02:00
CMakeLists.txt [CMake] Update dependency finders. 2021-05-19 21:53:21 +01:00
configure Update all copyright notices. 2021-01-17 07:18:48 +01:00
LICENSE.TXT LICENSE.TXT: Moved to root directory; minor edits. 2021-01-22 09:07:51 +01:00
Makefile Update all copyright notices. 2021-01-17 07:18:48 +01:00
meson_options.txt * meson_options.txt: Sort alphabetically; no final full stops. 2021-07-03 13:25:23 +02:00
meson.build * meson.build: Fix build for other UNIX systems (e.g., FreeBSD). 2021-07-12 22:23:42 +02:00
modules.cfg Prioritize the anti-aliasing renderer module. 2021-05-18 22:18:17 -04:00
README Improve build documentation. 2021-02-27 11:02:53 +01:00
README.git README.git: Revised. 2021-07-03 20:24:16 +02:00
vms_make.com Update all copyright notices. 2021-01-17 07:18:48 +01:00

FreeType 2.10.4
===============

Homepage: https://www.freetype.org

FreeType is a freely available software library to render fonts.

It  is  written  in  C,   designed  to  be  small,  efficient,  highly
customizable,  and portable  while capable  of producing  high-quality
output (glyph images) of most vector and bitmap font formats.

Please   read  the   `docs/CHANGES`   file,   it  contains   IMPORTANT
INFORMATION.

Read the files `docs/INSTALL*`  for installation instructions; see the
file `docs/LICENSE.TXT` for the available licenses.

For using FreeType's git repository  instead of a distribution bundle,
please read file `README.git`.

The FreeType 2 API reference is located in directory `docs/reference`;
use the file  `index.html` as the top entry point.   [Please note that
currently  the search  function  for  locally installed  documentation
doesn't work due to cross-site scripting issues.]

Additional documentation is  available as a separate  package from our
sites.  Go to

  https://download.savannah.gnu.org/releases/freetype/

and download one of the following files.

  freetype-doc-2.10.4.tar.xz
  freetype-doc-2.10.4.tar.gz
  ftdoc2104.zip

To view the documentation online, go to

  https://www.freetype.org/freetype2/docs/


Mailing Lists
-------------

The preferred  way of  communication with the  FreeType team  is using
e-mail lists.

  general use and discussion:      freetype@nongnu.org
  engine internals, porting, etc.: freetype-devel@nongnu.org
  announcements:                   freetype-announce@nongnu.org
  git repository tracker:          freetype-commit@nongnu.org

The lists are moderated; see

  https://www.freetype.org/contact.html

how to subscribe.


Bugs
----

Please submit bug reports at

  https://gitlab.freedesktop.org/freetype/freetype/-/issues

Alternatively,    you    might    report    bugs    by    e-mail    to
`freetype-devel@nongnu.org`.    Don't  forget   to  send   a  detailed
explanation of the problem -- there  is nothing worse than receiving a
terse message that only says 'it doesn't work'.


Patches
-------

For larger changes please provide merge requests at

  https://gitlab.freedesktop.org/freetype/freetype/-/merge_requests

Alternatively, you can send patches to the `freetype-devel@nongnu.org`
mailing list  -- and thank you  in advance for your  work on improving
FreeType!

Details on the process can be found here:

  https://www.freetype.org/developer.html#patches


Enjoy!


  The FreeType Team

----------------------------------------------------------------------

Copyright (C) 2006-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 ---