misc/libfreetype/docs/UPGRADE.UNIX
author koda
Sat, 13 Apr 2013 20:13:52 +0200
changeset 8907 7e9c6efe90fd
parent 5172 88f2e05288ba
permissions -rw-r--r--
added two security flags to windows linking
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5172
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
     1
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
     2
SPECIAL NOTE FOR UNIX USERS
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
     3
===========================
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
     4
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
     5
  If  you are  installing  this release  of  FreeType on  a system  that
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
     6
  already uses  release 2.0.5  (or even an  older version), you  have to
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
     7
  perform a few special steps to ensure that everything goes well.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
     8
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
     9
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    10
  1. Enable the TrueType bytecode hinter if you need it
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    11
  -----------------------------------------------------
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    12
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    13
    See the instructions in the file `TRUETYPE' of this directory.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    14
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    15
    Note  that FreeType  supports  TrueType fonts  without the  bytecode
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    16
    interpreter through its  auto-hinter, which now generates relatively
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    17
    good results with most fonts.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    18
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    19
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    20
  2. Determine the correct installation path
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    21
  ------------------------------------------
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    22
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    23
    By   default,  the   configure  script   installs  the   library  in
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    24
    `/usr/local'.   However,  many Unix  distributions  now install  the
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    25
    library  in `/usr',  since FreeType  is becoming  a  critical system
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    26
    component.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    27
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    28
    If FreeType is already installed on your system, type
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    29
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    30
      freetype-config --prefix
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    31
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    32
    on  the command  line.   This should  return  the installation  path
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    33
    (e.g.,  `/usr'  or `/usr/local').   To  avoid  problems of  parallel
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    34
    FreeType  versions, use  this path  for the  --prefix option  of the
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    35
    configure script.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    36
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    37
    Otherwise, simply use `/usr' (or  whatever you think is adequate for
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    38
    your installation).
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    39
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    40
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    41
  3. Ensure that you are using GNU Make
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    42
  -------------------------------------
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    43
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    44
    The FreeType build  system _exclusively_ works with GNU  Make (as an
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    45
    exception you  can use make++ which emulates  GNU Make sufficiently;
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    46
    see http://makepp.sourceforge.net).  You will not be able to compile
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    47
    the library with the  instructions below using any other alternative
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    48
    (including BSD Make).
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    49
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    50
    Trying to  compile the library with  a different Make  tool prints a
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    51
    message like:
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    52
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    53
      Sorry, GNU make is required to build FreeType2.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    54
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    55
    and the build process is aborted.  If this happens, install GNU Make
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    56
    on your system, and use the GNUMAKE environment variable to name it.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    57
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    58
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    59
  4. Build and install the library
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    60
  --------------------------------
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    61
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    62
    The  following should  work on  all  Unix systems  where the  `make'
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    63
    command invokes GNU Make:
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    64
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    65
      ./configure --prefix=<yourprefix>
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    66
      make
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    67
      make install           (as root)
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    68
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    69
    where `<yourprefix>' must be replaced  by the prefix returned by the
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    70
    `freetype-config' command.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    71
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    72
    When using a  different command to invoke GNU  Make, use the GNUMAKE
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    73
    variable.  For  example, if  `gmake' is the  command to use  on your
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    74
    system, do something like:
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    75
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    76
      GNUMAKE=gmake ./configure --prefix=<yourprefix>
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    77
      gmake
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    78
      gmake install            (as root)
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    79
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    80
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    81
  5. Take care of XFree86 version 4
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    82
  ---------------------------------
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    83
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    84
    Certain Linux  distributions install _several_  versions of FreeType
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    85
    on your  system.  For example, on  a fresh Mandrake  8.1 system, you
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    86
    can find the following files:
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    87
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    88
      /usr/lib/libfreetype.so             which links to
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    89
      /usr/lib/libfreetype.6.1.0.so
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    90
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    91
    and
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    92
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    93
      /usr/X11R6/lib/libfreetype.so       which links to
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    94
      /usr/X11R6/lib/libfreetype.6.0.so
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    95
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    96
    Note that  these files  correspond to two  distinct versions  of the
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    97
    library!  It seems that this  surprising issue is due to the install
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    98
    scripts of  recent XFree86 servers (from 4.1.0)  which install their
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
    99
    own (dated) version of the library in `/usr/X11R6/lib'.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   100
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   101
    In certain  _rare_ cases  you may experience  minor problems  if you
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   102
    install this  release of  the library in  `/usr' only,  namely, that
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   103
    certain applications do not benefit from the bug fixes and rendering
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   104
    improvements you would expect.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   105
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   106
    There are two good ways to deal with this situation:
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   107
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   108
      - Install the library _twice_,  in `/usr' and in `/usr/X11R6' (you
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   109
        have to  do that  each time you  install a new  FreeType release
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   110
        though).
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   111
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   112
      - Change the link in /usr/X11R6/lib/libfreetype.so to point to
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   113
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   114
          /usr/lib/libfreetype.so,
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   115
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   116
        and get rid of
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   117
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   118
          /usr/X11R6/lib/libfreetype.6.0.so
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   119
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   120
    The FreeType  Team is  not responsible for  this problem,  so please
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   121
    contact  either   the  XFree86   development  team  or   your  Linux
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   122
    distributor to help  clear this issue in case  the information given
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   123
    here doesn't help.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   124
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   125
------------------------------------------------------------------------
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   126
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   127
Copyright 2003, 2005 by
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   128
David Turner, Robert Wilhelm, and Werner Lemberg.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   129
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   130
This  file is  part  of the  FreeType  project, and  may  only be  used,
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   131
modified,  and  distributed under  the  terms  of  the FreeType  project
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   132
license, LICENSE.TXT.  By continuing  to use, modify, or distribute this
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   133
file  you indicate that  you have  read the  license and  understand and
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   134
accept it fully.
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   135
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   136
88f2e05288ba aaand let's add freetype as well while we are at it
koda
parents:
diff changeset
   137
---- end of UPGRADE.UNIX ---