Added copyright messages to all Makefiles.

Added documentation to FT_Get_Sfnt_* stuff (in ftnames.[ch])

minor other doc fixes

29 files changed, 304 insertions, 29 deletions

diff --git a/builds/ansi/ansi-def.mk b/builds/ansi/ansi-def.mk
index a20dbd30a..3a3525531 100644
--- a/builds/ansi/ansi-def.mk
+++ b/builds/ansi/ansi-def.mk
@@ -1,7 +1,18 @@
 #
-#  configuration rules for a `normal' ANSI system
+# FreeType 2 configuration rules for a `normal' ANSI system
 #
 
+
+# Copyright 1996-2000 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.
+
+
 ifndef TOP
   TOP := .
 endif
diff --git a/builds/ansi/ansi.mk b/builds/ansi/ansi.mk
index 8944753c5..92cbadfe3 100644
--- a/builds/ansi/ansi.mk
+++ b/builds/ansi/ansi.mk
@@ -2,6 +2,17 @@
 # FreeType 2 configuration rules for a `normal' pseudo ANSI compiler/system
 #
 
+
+# Copyright 1996-2000 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.
+
+
 include $(TOP)/builds/ansi/ansi-def.mk
 include $(TOP)/builds/compiler/ansi-cc.mk
 
diff --git a/builds/compiler/ansi-cc.mk b/builds/compiler/ansi-cc.mk
index 6faeab196..3e4a1254e 100644
--- a/builds/compiler/ansi-cc.mk
+++ b/builds/compiler/ansi-cc.mk
@@ -1,8 +1,18 @@
-# Copyright 2000 David Turner
 #
-#  generic pseudo ANSI compiler
+# FreeType 2 generic pseudo ANSI compiler
 #
 
+
+# Copyright 1996-2000 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.
+
+
 # Compiler command line name
 #
 CC := cc
diff --git a/builds/compiler/gcc-dev.mk b/builds/compiler/gcc-dev.mk
index 12ec3a637..c03b29b8f 100644
--- a/builds/compiler/gcc-dev.mk
+++ b/builds/compiler/gcc-dev.mk
@@ -1,8 +1,18 @@
-# Copyright 2000 David Turner
 #
-#  gcc-specific with NO OPTIMIZATIONS + DEBUGGING
+# FreeType 2 gcc-specific with NO OPTIMIZATIONS + DEBUGGING
 #
 
+
+# Copyright 1996-2000 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.
+
+
 # Compiler command line name
 #
 CC := gcc
diff --git a/builds/compiler/gcc.mk b/builds/compiler/gcc.mk
index e1d4706ee..8fb4a961f 100644
--- a/builds/compiler/gcc.mk
+++ b/builds/compiler/gcc.mk
@@ -1,8 +1,18 @@
-# Copyright 2000 David Turner
 #
-#  gcc-specific definitions
+# FreeType 2 gcc-specific definitions
 #
 
+
+# Copyright 1996-2000 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.
+
+
 # Compiler command line name
 #
 CC := gcc
diff --git a/builds/compiler/visualage.mk b/builds/compiler/visualage.mk
index 7a745cfa2..7d5533b74 100644
--- a/builds/compiler/visualage.mk
+++ b/builds/compiler/visualage.mk
@@ -1,7 +1,18 @@
 #
-# Visual Age C++ specific definitions
+# FreeType 2 Visual Age C++ specific definitions
 #
 
+
+# Copyright 1996-2000 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.
+
+
 # command line compiler name
 #
 CC       := icc
diff --git a/builds/compiler/visualc.mk b/builds/compiler/visualc.mk
index e0630b694..432f7af2a 100644
--- a/builds/compiler/visualc.mk
+++ b/builds/compiler/visualc.mk
@@ -1,7 +1,18 @@
 #
-# Visual C++ definitions
+# FreeType 2 Visual C++ definitions
 #
 
+
+# Copyright 1996-2000 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.
+
+
 # compiler command line name
 #
 CC := cl
diff --git a/builds/compiler/win-lcc.mk b/builds/compiler/win-lcc.mk
index b73488295..677268633 100644
--- a/builds/compiler/win-lcc.mk
+++ b/builds/compiler/win-lcc.mk
@@ -1,7 +1,18 @@
 #
-#  Win32-LCC specific definitions
+# FreeType 2 Win32-LCC specific definitions
 #
 
+
+# Copyright 1996-2000 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.
+
+
 # Command line name
 #
 CC := lcc
diff --git a/builds/cygwin/cygwin-dev.mk b/builds/cygwin/cygwin-dev.mk
index b9d7a5b2d..a38367c83 100644
--- a/builds/cygwin/cygwin-dev.mk
+++ b/builds/cygwin/cygwin-dev.mk
@@ -5,6 +5,17 @@
 #   and no installation
 #
 
+
+# Copyright 1996-2000 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.
+
+
 include $(TOP)/builds/cygwin/cygwinddef.mk
 include $(TOP)/builds/compiler/gcc-dev.mk
 include $(TOP)/builds/link_std.mk
diff --git a/builds/cygwin/cygwin.mk b/builds/cygwin/cygwin.mk
index 659a25feb..916d12df5 100644
--- a/builds/cygwin/cygwin.mk
+++ b/builds/cygwin/cygwin.mk
@@ -1,3 +1,18 @@
+#
+# FreeType 2 configuration file for CygWin host platform.
+#
+
+
+# Copyright 1996-2000 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.
+
+
 include $(TOP)/builds/cygwin/cygwin-def.mk
 include $(TOP)/builds/cygwin/cygwin-cc.mk
 
diff --git a/builds/cygwin/cygwinddef.mk b/builds/cygwin/cygwinddef.mk
index 1b2dba1ed..3e9d918e2 100644
--- a/builds/cygwin/cygwinddef.mk
+++ b/builds/cygwin/cygwinddef.mk
@@ -1,8 +1,9 @@
 #
 # FreeType 2 configuration rules templates for
-# development under Unix with no configure (gcc only)
+# development under Unix-like platforms with no configure script (gcc only)
 #
 
+
 # Copyright 1996-2000 by
 # David Turner, Robert Wilhelm, and Werner Lemberg.
 #
@@ -12,6 +13,7 @@
 # indicate that you have read the license and understand and accept it
 # fully.
 
+
 ifndef TOP
   TOP := .
 endif
diff --git a/builds/cygwin/install.mk b/builds/cygwin/install.mk
index 93ef1832a..ae6a85f29 100644
--- a/builds/cygwin/install.mk
+++ b/builds/cygwin/install.mk
@@ -1,8 +1,18 @@
 #
-#  installation instructions for Unix systems
-#  this file is FreeType-specific
+# FreeType 2 installation instructions for Unix-like systems
 #
 
+
+# Copyright 1996-2000 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.
+
+
 # Unix installation and deinstallation targets.
 
 install: $(PROJECT_LIBRARY)
diff --git a/builds/dos/dos-def.mk b/builds/dos/dos-def.mk
index a70556284..000bcd24a 100644
--- a/builds/dos/dos-def.mk
+++ b/builds/dos/dos-def.mk
@@ -1,8 +1,17 @@
 #
-# Copyright 2000 David Turner <david.turner@freetype.org>
+# FreeType 2 DOS specific definitions
 #
-#  DOS specific definitions
+
+
+# Copyright 1996-2000 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.
+
 
 DELETE   := del
 HOSTSEP  := $(strip \ )
diff --git a/builds/dos/dos-gcc.mk b/builds/dos/dos-gcc.mk
index cd068efb5..c283bab80 100644
--- a/builds/dos/dos-gcc.mk
+++ b/builds/dos/dos-gcc.mk
@@ -2,6 +2,17 @@
 # FreeType 2 configuration rules for the DJGPP compiler
 #
 
+
+# Copyright 1996-2000 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.
+
+
 SEP := /
 CLEAN_LIBRARY := $(DELETE) $@
 include $(TOP)/builds/dos/dos-def.mk
diff --git a/builds/link_dos.mk b/builds/link_dos.mk
index 87d0e399e..ee6fe69f2 100644
--- a/builds/link_dos.mk
+++ b/builds/link_dos.mk
@@ -2,6 +2,17 @@
 #  Link instructions for Dos-like systems (Dos, Win32, OS/2)
 #
 
+
+# Copyright 1996-2000 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.
+
+
 ifdef BUILD_PROJECT
 
   # Now include the main sub-makefile.  It contains all the rules used to
diff --git a/builds/link_std.mk b/builds/link_std.mk
index 06fcfb5ee..d9fc9551f 100644
--- a/builds/link_std.mk
+++ b/builds/link_std.mk
@@ -2,6 +2,17 @@
 #  Link instructions for standard systems
 #
 
+
+# Copyright 1996-2000 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.
+
+
 ifdef BUILD_PROJECT
 
   # Now include the main sub-makefile.  It contains all the rules used to
diff --git a/builds/modules.mk b/builds/modules.mk
index 729d7bc3a..68f3d6ba4 100644
--- a/builds/modules.mk
+++ b/builds/modules.mk
@@ -2,6 +2,7 @@
 # FreeType 2 modules sub-Makefile
 #
 
+
 # Copyright 1996-2000 by
 # David Turner, Robert Wilhelm, and Werner Lemberg.
 #
diff --git a/builds/os2/os2-def.mk b/builds/os2/os2-def.mk
index 284aae780..486b9783d 100644
--- a/builds/os2/os2-def.mk
+++ b/builds/os2/os2-def.mk
@@ -1,8 +1,17 @@
 #
-# Copyright 2000 David Turner <david.turner@freetype.org>
+# FreeType 2 OS/2 specific definitions
 #
-#  OS/2 specific definitions
+
+
+# Copyright 1996-2000 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.
+
 
 DELETE   := del
 HOSTSEP  := $(strip \ )
diff --git a/builds/toplevel.mk b/builds/toplevel.mk
index fb2c5dd00..fc7461f76 100644
--- a/builds/toplevel.mk
+++ b/builds/toplevel.mk
@@ -2,7 +2,15 @@
 # FreeType build system -- top-level sub-Makefile
 #
 
-# Copyright 2000 by David Turner
+
+# Copyright 1996-2000 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.
 
 
 # This file is designed for GNU Make, do not use it with another Make tool!
diff --git a/builds/unix/install.mk b/builds/unix/install.mk
index c5129259e..24037a395 100644
--- a/builds/unix/install.mk
+++ b/builds/unix/install.mk
@@ -1,8 +1,18 @@
 #
-#  installation instructions for Unix systems --
-#  this file is FreeType-specific
+# FreeType 2 installation instructions for Unix systems
 #
 
+
+# Copyright 1996-2000 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.
+
+
 # Unix installation and deinstallation targets.
 install: $(PROJECT_LIBRARY)
 	$(MKINSTALLDIRS) $(libdir)                       \
diff --git a/builds/unix/unix-dev.mk b/builds/unix/unix-dev.mk
index cc06f84d7..1dcd9ee79 100644
--- a/builds/unix/unix-dev.mk
+++ b/builds/unix/unix-dev.mk
@@ -2,9 +2,20 @@
 # FreeType 2 Configuration rules for Unix + GCC
 #
 #   Development version without optimizations & libtool
-#   and no installation..
+#   and no installation.
 #
 
+
+# Copyright 1996-2000 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.
+
+
 include $(TOP)/builds/unix/unixddef.mk
 include $(TOP)/builds/compiler/gcc-dev.mk
 include $(TOP)/builds/link_std.mk
diff --git a/builds/unix/unix.mk b/builds/unix/unix.mk
index 540ebf830..f904548d5 100644
--- a/builds/unix/unix.mk
+++ b/builds/unix/unix.mk
@@ -1,3 +1,18 @@
+#
+# FreeType 2 configuration rules for UNIX platforms
+#
+
+
+# Copyright 1996-2000 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.
+
+
 include $(TOP)/builds/unix/unix-def.mk
 include $(TOP)/builds/unix/unix-cc.mk
 
diff --git a/builds/unix/unixddef.mk b/builds/unix/unixddef.mk
index 6b78ca64b..242e96579 100644
--- a/builds/unix/unixddef.mk
+++ b/builds/unix/unixddef.mk
@@ -3,6 +3,7 @@
 # development under Unix with no configure script (gcc only)
 #
 
+
 # Copyright 1996-2000 by
 # David Turner, Robert Wilhelm, and Werner Lemberg.
 #
diff --git a/builds/win32/w32-dev.mk b/builds/win32/w32-dev.mk
index f3f117c00..fc3ed10d0 100644
--- a/builds/win32/w32-dev.mk
+++ b/builds/win32/w32-dev.mk
@@ -1,5 +1,5 @@
 #
-# FreeType 2 Configuration rules for Win32 + GCC
+# FreeType 2 configuration rules for Win32 + GCC
 #
 #   Development version without optimizations.
 #
@@ -13,7 +13,8 @@
 # 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.
-#
+
+
 # NOTE: This version requires that GNU Make is invoked from the Windows
 #       Shell (_not_ Cygwin BASH)!
 #
diff --git a/builds/win32/w32-gcc.mk b/builds/win32/w32-gcc.mk
index 70eec1adf..0aed55445 100644
--- a/builds/win32/w32-gcc.mk
+++ b/builds/win32/w32-gcc.mk
@@ -1,7 +1,18 @@
 #
-# FreeType 2 Configuration rules for Win32 + GCC
+# FreeType 2 configuration rules for Win32 + GCC
 #
 
+
+# Copyright 1996-2000 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.
+
+
 # the separator must be set before including win32-def
 # as it defaults to "\" on Win32
 SEP := /
diff --git a/builds/win32/w32-icc.mk b/builds/win32/w32-icc.mk
index 54fe5bb31..49812ed3d 100644
--- a/builds/win32/w32-icc.mk
+++ b/builds/win32/w32-icc.mk
@@ -1,7 +1,18 @@
 #
-# FreeType 2 Configuration rules for Win32 + IBM Visual Age C++
+# FreeType 2 configuration rules for Win32 + IBM Visual Age C++
 #
 
+
+# Copyright 1996-2000 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.
+
+
 include $(TOP)/builds/win32/win32-def.mk
 include $(TOP)/builds/compiler/visualage.mk
 
diff --git a/builds/win32/w32-lcc.mk b/builds/win32/w32-lcc.mk
index 731b7c6f1..29473bce3 100644
--- a/builds/win32/w32-lcc.mk
+++ b/builds/win32/w32-lcc.mk
@@ -1,7 +1,18 @@
 #
-# Configuration rules for Win32 + LCC
+# FreeType 2 configuration rules for Win32 + LCC
 #
 
+
+# Copyright 1996-2000 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.
+
+
 SEP := /
 include $(TOP)/builds/win32/win32-def.mk
 include $(TOP)/builds/compiler/win-lcc.mk
diff --git a/builds/win32/w32-vcc.mk b/builds/win32/w32-vcc.mk
index 6e6e5954c..516b028bb 100644
--- a/builds/win32/w32-vcc.mk
+++ b/builds/win32/w32-vcc.mk
@@ -1,7 +1,18 @@
 #
-# Visual C++ on Win32
+# FreeType 2 Visual C++ on Win32
 #
 
+
+# Copyright 1996-2000 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.
+
+
 SEP := /
 include $(TOP)/builds/win32/win32-def.mk
 include $(TOP)/builds/compiler/visualc.mk
diff --git a/builds/win32/win32-def.mk b/builds/win32/win32-def.mk
index c31b5e8cb..d1ba5993f 100644
--- a/builds/win32/win32-def.mk
+++ b/builds/win32/win32-def.mk
@@ -1,8 +1,18 @@
-# Copyright 2000 David Turner <david.turner@freetype.org>
 #
-# Win32 specific definitions
+# FreeType 2 Win32 specific definitions
 #
 
+
+# Copyright 1996-2000 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.
+
+
 DELETE   := del
 HOSTSEP  := $(strip \ )
 BUILD    := $(TOP)$(SEP)config$(SEP)win32