home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / ft-beta.zip / freetype / docs / FAQ < prev    next >
Text File  |  1997-10-06  |  11KB  |  248 lines
  1.  
  2. The FreeType mini-FAQ:
  3.  
  4.   Summary:
  5.  
  6.   0. Where to find the latest FreeType release?
  7.  
  8.   1. What do you mean by 'Beta'?
  9.  
  10.   2. What does the 'Free' in FreeType means?
  11.      Can you use it in a commercial product? (YES!)
  12.      Is it LGPL? (Yes and No, long)
  13.  
  14.   3. I have made a small program based on the test programs but I would like
  15.      to know how to do xxx?
  16.  
  17.   4. What is this weird C source format? It's non-standard!
  18.  
  19.   5. When will I be able to use FreeType to display TrueType fonts under X11,
  20.      OS/2 or Wine?
  21.  
  22.   6. Trying to compile the FreeType sources gives me lots of warnings with my
  23.      ANSI C compliant compiler!
  24.  
  25.   --------------------------------------------------------------------
  26.  
  27.   0. Where to find the latest FreeType release?
  28.  
  29.        The latest package has been uploaded in two formats, with distinct
  30.        CR/LF conventions.
  31.  
  32.        * for DOS and OS/2 :  'ft-beta.zip' (about 375K)
  33.              Has been recently uploaded to the HOBBES archive.
  34.  
  35.              currently at ftp://ftp.cdrom.com/pub/os2/incoming, should soon go
  36.              to ftp://ftp.cdrom.com/pub/os2/fonts
  37.  
  38.              One can also get it in:
  39.                 ftp://ftp.physiol.med.tu-muenchen.de/pub/freetype
  40.  
  41.        * for UNIX and Amiga : 'freetype-AR4.tar.gz' (about 290K)
  42.              Available now at ftp://sunsite.unc.edu/pub/Linux/X11/fonts
  43.              or at our FTP site in:
  44.                 ftp://ftp.physiol.med.tu-muenchen.de/pub/freetype
  45.  
  46.        Note that the archives contents are exactly the same. The size
  47.        difference comes only from the different linefeed conventions, and the
  48.        fact that a 'tar.gz' compresses better than a 'zip'.
  49.  
  50.        Daily snapshots of the CVS repository are available at
  51.            ftp://ftp.physiol.med.tu-muenchen.de/pub/freetype/devel
  52.  
  53.        We now have a web page at:
  54.           http://www.physiol.med.tu-muenchen.de/~robert/freetype.html
  55.  
  56.        (Screenshots available)
  57.        Note that the page and the screen shots may not be up to date.
  58.  
  59.        The home site of the FreeType project is
  60.            ftp://ftp.physiol.med.tu-muenchen.de/pub/freetype
  61.  
  62.        There is also a mailing list:
  63.            freetype@lists.lrz-muenchen.de
  64.  
  65.        send the usual subscription commands to:
  66.            majordomo@lists.lrz-muenchen.de
  67.  
  68.        Any suggestions/bug reports are welcome.
  69.  
  70.   --------------------------------------------------------------------
  71.  
  72.   1. What do you mean by 'Public Beta'?
  73.  
  74.        The previous alpha  releases  were  published for informative
  75.        purposes, and each went through  several  design  changes  to
  76.        accomodate new functionalities and goals.
  77.  
  78.        This release is a beta, which means that
  79.  
  80.           - it contains a _complete_ and _functional_ API and
  81.             implementation
  82.  
  83.           - it may contain bugs, and we invite you to report them
  84.             after having read the bug report at our web page
  85.  
  86.            ( http://www.physiol.med.tu-muenchen.de/~robert/freetype.html )
  87.  
  88.           - The API won't evolve in the future unless we find
  89.             serious defects.  We thus encourage you to start testing
  90.             and developing your own products based on this release.
  91.             A  simple  recompile  should be needed when FreeType 1.0
  92.             comes out !
  93.  
  94.        Notice that this labelling  is  unlike  the one used more and
  95.        more  often  by  commercial  vendors,   whose   'betas'   are
  96.        unfinished versions of  the  products, lacking many important
  97.        features.  This trend is the shame of the software  industry,
  98.        and we do not encourage it.
  99.  
  100.        In other words, this release could also be labelled  'GA'  or
  101.        'final' by marketers. We're happy not to succomb to this.
  102.  
  103.   --------------------------------------------------------------------
  104.  
  105.   2. What does the 'Free' in FreeType means?
  106.      Can you use it in a commercial product? (YES!)
  107.      Is it LGPL?
  108.  
  109.        We believe that TrueType is a great technology (thanks to Apple
  110.        engineers) and want to make it available on all platforms or machines.
  111.        The engine is released free of charge, with source code, in order to be
  112.        sure that it can be spread as widely as possible.
  113.  
  114.        However, free does not mean public domain.  This engine is copyrighted
  115.        by its authors, and they will fiercely defend their rights.
  116.  
  117.        There are a number of standard licenses that protect the rights of free
  118.        software authors, one of the most famous being the GNU Public License
  119.        (GPL).  Though the GPL is probably the only license that protects both
  120.        the software's author and its users, it mandates that all work based on
  121.        or containing GPL-ed software become GPL itself.  This simple rule
  122.        prevents any use of the software other than with GPL-ed one.
  123.        Commercial products as well as freeware ones released by their authors
  124.        under any other licenses cannot use the software though it is "free".
  125.  
  126.        A different license called the Library GPL (or LGPL) applies to
  127.        libraries, stating that any program, even commercial ones, have the
  128.        right to dynamically link to a LGPL-ed DLL, as long as the source code,
  129.        or an object file, for the library is distributed with the product.
  130.        This is better, as it has allowed a lot of various freeware programs to
  131.        use LGPL-ed libraries.  Use in commercial products is much more seldom,
  132.        of course... (the GPL-ed DLL *must* come with a copy of the Library GNU
  133.        Public License, which is not very 'pleasant' for many companies and
  134.        developers).  Actually, LGPL is one of the best way to prevent a
  135.        program to go into a commercial product.
  136.  
  137.        However, LGPL is still too limited for FreeType.  What if someone wants
  138.        to put the engine on a laser printer or PDA ROM? What if a DOS or
  139.        console game maker want to use it to display nice characters?  There
  140.        are places were dynamic linking is not available, and even if all
  141.        modern operating systems include it, there will probably always be some
  142.        specific cases that will exclude it for any technical reason.  Because
  143.        we hope wide distribution and acceptance, we must accept that FreeType
  144.        be included in any kind of product, in more or less exotic ways. In
  145.        order to allow any company to use the engine, we decided to propose two
  146.        kinds of licensing.  So:
  147.  
  148.          - This package is released under the terms of the LGPL so as to
  149.            benefit from its protection. Feel free to test and stress it.
  150.  
  151.          - However, for companies and developers who are not willing to accept
  152.            the LGPL (we understand you), an alternate license, which is also
  153.            free, can be obtained contacting the authors.
  154.  
  155.            (Note that this license will only be valid with the agreement of
  156.             all authors).
  157.  
  158.        We however sincerely invite you to wait for the final release before
  159.        asking for any license but LGPL...
  160.  
  161.   --------------------------------------------------------------------
  162.  
  163.   3. I have made a small program based on the test programs but I would like
  164.      to know how to do xxx?
  165.  
  166.         (Where xxx is a feature lacking from the current implementation).
  167.  
  168.         Sorry, but we will not answer this question.  As stated above, this is
  169.         an Alpha release that is subject to a lot of design changes.  Even if
  170.         there is a way to do what you want with the current release, we won't
  171.         try helping you as any semantics and features could disappear or be
  172.         changed before the next release.
  173.  
  174.         The test programs do *not* illustrate the way to use FreeType. They
  175.         just demonstrate performance.
  176.  
  177.   --------------------------------------------------------------------
  178.  
  179.   4. What is this weird C source format? It's non standard!
  180.  
  181.        (by David Turner)
  182.  
  183.        This format is my own and comes from my experience of reading tons of
  184.        C, Pascal and Ada sources, especially large sources.  I like to
  185.        describe it as 'airy' and 'columned'.
  186.  
  187.        I chose this representation because I find it produces much more
  188.        readable sources, especially when printed (paper *is* the ultimate
  189.        debugger!).  Of course, that's purely a matter of taste, as one could
  190.        find the extra spaces and newlines unpleasant on a 25-lines text
  191.        window.
  192.  
  193.        We may, for the final release, process the whole source through a C
  194.        beautifier.
  195.  
  196.        Please read the file doc/convtns.txt for a list of our current
  197.        formatting and design conventions.
  198.  
  199.   --------------------------------------------------------------------
  200.  
  201.   5. When will I be able to use FreeType to display TrueType fonts under X11,
  202.      OS/2 or Wine?
  203.  
  204.        Well, that is not FreeType, really!  FreeType is a *portable* library,
  205.        which means that we try very hard to avoid depending on system
  206.        specifics (like runtime libraries, memory and I/O management).  An X11
  207.        or Wine font engine is something that is highly tied to a given system,
  208.        and writing a font server based on FreeType will require the
  209.        modification of some specific elements to adapt them to the host
  210.        system.
  211.  
  212.        The engine is modular enough to allow that quite easily, but a font
  213.        server has to deal with various kinds of constraints (like metrics,
  214.        caching, shared data, etc.) that are not part of FreeType, and will
  215.        never be!
  216.  
  217.        Note that an XFree or Wine font server should use a non-LGPL license.
  218.  
  219.        We have already volunteers to develop font servers for X11, 
  220.        Wine and OS/2 based on FreeType.
  221.  
  222.        It seems that there are some early prototypes for X11 and OS/2, but as
  223.        the library will change much before the beta, it may not be too useful
  224.        to release them.
  225.  
  226.   --------------------------------------------------------------------
  227.  
  228.   6. Trying to compile the FreeType sources gives me lots of warnings with my
  229.      ANSI C compliant compiler!
  230.  
  231.        We have seriously reduced the number of warnings produced during
  232.        compilation. For example, compiling the library with gcc and the
  233.        '-pedantic -ansi -Wall' flags ( all warnings and pedantic ANSI
  234.        checks ) gives no warnings anymore.
  235.  
  236.        The test programs (especially the graphics drivers) may produce some
  237.        warnings that should be ignored.
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.