Add source documentation for fonts shipped with reactos.
Added: trunk/reactos/media/doc/
Added: trunk/reactos/media/doc/COPYRIGHT.IBM
Added: trunk/reactos/media/doc/Copyright.Bitstream
Added: trunk/reactos/media/doc/README.TXT
Added: trunk/reactos/media/doc/TGMarlett.txt
Added: trunk/reactos/media/doc/VERA-COPYRIGHT.TXT
Added: trunk/reactos/media/doc/VERA-README.TXT
Added: trunk/reactos/media/doc/VERA-RELEASENOTES.TXT
_____
Added: trunk/reactos/media/doc/COPYRIGHT.IBM
--- trunk/reactos/media/doc/COPYRIGHT.IBM 2006-02-03 23:57:39 UTC
(rev 78)
+++ trunk/reactos/media/doc/COPYRIGHT.IBM 2006-02-04 06:23:24 UTC
(rev 79)
@@ -0,0 +1,9 @@
+IBM Courier - Copyright (c) IBM Corporation 1990, 1991
+
+You are hereby granted permission under the terms of the IBM/MIT X
Consortium
+Courier Typefont agreement to execute, reproduce, distribute, display,
market,
+sell and otherwise transfer copies of the IBM Courier font to third
parties.
+
+The font is provided "AS IS" without charge. NO WARRANTIES OR
INDEMNIFICATION
+ARE GIVEN, WHETHER EXPRESS OR IMPLIED INCLUDING, BUT LIMITED TO THE
IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
_____
Added: trunk/reactos/media/doc/Copyright.Bitstream
--- trunk/reactos/media/doc/Copyright.Bitstream 2006-02-03 23:57:39 UTC
(rev 78)
+++ trunk/reactos/media/doc/Copyright.Bitstream 2006-02-04 06:23:24 UTC
(rev 79)
@@ -0,0 +1,11 @@
+(c) Copyright 1989-1992, Bitstream Inc., Cambridge, MA.
+
+You are hereby granted permission under all Bitstream propriety rights
+to use, copy, modify, sublicense, sell, and redistribute the 4
Bitstream
+Charter (r) Type 1 outline fonts and the 4 Courier Type 1 outline fonts
+for any purpose and without restriction; provided, that this notice is
+left intact on all copies of such fonts and that Bitstream's trademark
+is acknowledged as shown below on all unmodified copies of the 4
Charter
+Type 1 fonts.
+
+BITSTREAM CHARTER is a registered trademark of Bitstream Inc.
_____
Added: trunk/reactos/media/doc/README.TXT
--- trunk/reactos/media/doc/README.TXT 2006-02-03 23:57:39 UTC (rev 78)
+++ trunk/reactos/media/doc/README.TXT 2006-02-04 06:23:24 UTC (rev 79)
@@ -0,0 +1,3 @@
+The Vera*.ttf contain the Bitstream Vera fonts. They were downloaded
+from
http://ftp.gnome.org/pub/GNOME/sources/ttf-bitstream-vera/1.10/.
+The original documentation files are available as VERA-*.TXT.
\ No newline at end of file
_____
Added: trunk/reactos/media/doc/TGMarlett.txt
--- trunk/reactos/media/doc/TGMarlett.txt 2006-02-03 23:57:39 UTC
(rev 78)
+++ trunk/reactos/media/doc/TGMarlett.txt 2006-02-04 06:23:24 UTC
(rev 79)
@@ -0,0 +1,8 @@
+6.2 Can I redistribute TGMarlett.ttf
+
+Yes. TGMarlett is licensed under an X11 license, so you can do whatever
you
+wish with it. However, if you make any improvements to this font (see
FAQ 6.3)
+we would appreciate it if you made the improvements available to
everyone by
+contributing the changes back to TransGaming.
+
+from (
http://www.transgaming.com/gamefaq.php?specialid=3 )
\ No newline at end of file
_____
Added: trunk/reactos/media/doc/VERA-COPYRIGHT.TXT
--- trunk/reactos/media/doc/VERA-COPYRIGHT.TXT 2006-02-03 23:57:39 UTC
(rev 78)
+++ trunk/reactos/media/doc/VERA-COPYRIGHT.TXT 2006-02-04 06:23:24 UTC
(rev 79)
@@ -0,0 +1,124 @@
+Bitstream Vera Fonts Copyright
+
+The fonts have a generous copyright, allowing derivative works (as
+long as "Bitstream" or "Vera" are not in the names), and full
+redistribution (so long as they are not *sold* by themselves). They
+can be be bundled, redistributed and sold with any software.
+
+The fonts are distributed under the following copyright:
+
+Copyright
+=========
+
+Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved. Bitstream
+Vera is a trademark of Bitstream, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the fonts accompanying this license ("Fonts") and associated
+documentation files (the "Font Software"), to reproduce and distribute
+the Font Software, including without limitation the rights to use,
+copy, merge, publish, distribute, and/or sell copies of the Font
+Software, and to permit persons to whom the Font Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright and trademark notices and this permission notice
+shall be included in all copies of one or more of the Font Software
+typefaces.
+
+The Font Software may be modified, altered, or added to, and in
+particular the designs of glyphs or characters in the Fonts may be
+modified and additional glyphs or characters may be added to the
+Fonts, only if the fonts are renamed to names not containing either
+the words "Bitstream" or the word "Vera".
+
+This License becomes null and void to the extent applicable to Fonts
+or Font Software that has been modified and is distributed under the
+"Bitstream Vera" names.
+
+The Font Software may be sold as part of a larger software package but
+no copy of one or more of the Font Software typefaces may be sold by
+itself.
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL
+BITSTREAM OR THE GNOME FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL,
+OR CONSEQUENTIAL DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF THE USE OR INABILITY TO USE THE FONT
+SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.
+
+Except as contained in this notice, the names of Gnome, the Gnome
+Foundation, and Bitstream Inc., shall not be used in advertising or
+otherwise to promote the sale, use or other dealings in this Font
+Software without prior written authorization from the Gnome Foundation
+or Bitstream Inc., respectively. For further information, contact:
+fonts at gnome dot org.
+
+Copyright FAQ
+=============
+
+ 1. I don't understand the resale restriction... What gives?
+
+ Bitstream is giving away these fonts, but wishes to ensure its
+ competitors can't just drop the fonts as is into a font sale
system
+ and sell them as is. It seems fair that if Bitstream can't make
money
+ from the Bitstream Vera fonts, their competitors should not be
able to
+ do so either. You can sell the fonts as part of any software
package,
+ however.
+
+ 2. I want to package these fonts separately for distribution and
+ sale as part of a larger software package or system. Can I do
so?
+
+ Yes. A RPM or Debian package is a "larger software package" to
begin
+ with, and you aren't selling them independently by themselves.
+ See 1. above.
+
+ 3. Are derivative works allowed?
+ Yes!
+
+ 4. Can I change or add to the font(s)?
+ Yes, but you must change the name(s) of the font(s).
+
+ 5. Under what terms are derivative works allowed?
+
+ You must change the name(s) of the fonts. This is to ensure the
+ quality of the fonts, both to protect Bitstream and Gnome. We
want to
+ ensure that if an application has opened a font specifically of
these
+ names, it gets what it expects (though of course, using
fontconfig,
+ substitutions could still could have occurred during font
+ opening). You must include the Bitstream copyright. Additional
+ copyrights can be added, as per copyright law. Happy Font
Hacking!
+
+ 6. If I have improvements for Bitstream Vera, is it possible they
might get
+ adopted in future versions?
+
+ Yes. The contract between the Gnome Foundation and Bitstream has
+ provisions for working with Bitstream to ensure quality additions
to
+ the Bitstream Vera font family. Please contact us if you have
such
+ additions. Note, that in general, we will want such additions for
the
+ entire family, not just a single font, and that you'll have to
keep
+ both Gnome and Jim Lyles, Vera's designer, happy! To make sense
to add
+ glyphs to the font, they must be stylistically in keeping with
Vera's
+ design. Vera cannot become a "ransom note" font. Jim Lyles will
be
+ providing a document describing the design elements used in Vera,
as a
+ guide and aid for people interested in contributing to Vera.
+
+ 7. I want to sell a software package that uses these fonts: Can I do
so?
+
+ Sure. Bundle the fonts with your software and sell your software
+ with the fonts. That is the intent of the copyright.
+
+ 8. If applications have built the names "Bitstream Vera" into them,
+ can I override this somehow to use fonts of my choosing?
+
+ This depends on exact details of the software. Most open source
+ systems and software (e.g., Gnome, KDE, etc.) are now converting
to
+ use fontconfig (see
www.fontconfig.org) to handle font
configuration,
+ selection and substitution; it has provisions for overriding font
+ names and subsituting alternatives. An example is provided by the
+ supplied local.conf file, which chooses the family Bitstream Vera
for
+ "sans", "serif" and "monospace". Other software
(e.g., the
XFree86
+ core server) has other mechanisms for font substitution.
+
_____
Added: trunk/reactos/media/doc/VERA-README.TXT
--- trunk/reactos/media/doc/VERA-README.TXT 2006-02-03 23:57:39 UTC
(rev 78)
+++ trunk/reactos/media/doc/VERA-README.TXT 2006-02-04 06:23:24 UTC
(rev 79)
@@ -0,0 +1,11 @@
+Contained herin is the Bitstream Vera font family.
+
+The Copyright information is found in the COPYRIGHT.TXT file (along
+with being incoporated into the fonts themselves).
+
+The releases notes are found in the file "RELEASENOTES.TXT".
+
+We hope you enjoy Vera!
+
+ Bitstream, Inc.
+ The Gnome Project
_____
Added: trunk/reactos/media/doc/VERA-RELEASENOTES.TXT
--- trunk/reactos/media/doc/VERA-RELEASENOTES.TXT 2006-02-03
23:57:39 UTC (rev 78)
+++ trunk/reactos/media/doc/VERA-RELEASENOTES.TXT 2006-02-04
06:23:24 UTC (rev 79)
@@ -0,0 +1,162 @@
+Bitstream Vera Fonts - April 16, 2003
+=====================================
+
+The version number of these fonts is 1.10 to distinguish them from the
+beta test fonts.
+
+Note that the Vera copyright is incorporated in the fonts themselves.
+The License field in the fonts contains the copyright license as it
+appears below. The TrueType copyright field is not large enough to
+contain the full license, so the license is incorporated (as you might
+think if you thought about it) into the license field, which
+unfortunately can be obscure to find. (In pfaedit, see: Element->Font
+Info->TTFNames->License).
+
+Our apologies for it taking longer to complete the fonts than planned.
+Beta testers requested a tighter line spacing (less leading) and Jim
+Lyles redesigned Vera's accents to bring its line spacing to more
+typical of other fonts. This took additional time and effort. Our
+thanks to Jim for this effort above and beyond the call of duty.
+
+There are four monospace and sans faces (normal, oblique, bold, bold
+oblique) and two serif faces (normal and bold). Fontconfig/Xft2 (see
+www.fontconfig.org) can artificially oblique the serif faces for you:
+this loses hinting and distorts the faces slightly, but is visibly
+different than normal and bold, and reasonably pleasing.
+
+On systems with fontconfig 2.0 or 2.1 installed, making your sans,
+serif and monospace fonts default to these fonts is very easy. Just
+drop the file local.conf into your /etc/fonts directory. This will
+make the Bitstream fonts your default fonts for all applications using
+fontconfig (if sans, serif, or monospace names are used, as they often
+are as default values in many desktops). The XML in local.conf may
+need modification to enable subpixel decimation, if appropriate,
+however, the commented out phrase does so for XFree86 4.3, in the case
+that the server does not have sufficient information to identify the
+use of a flat panel. Fontconfig 2.2 adds Vera to the list of font
+families and will, by default use it as the default sans, serif and
+monospace fonts.
+
+During the testing of the final Vera fonts, we learned that screen
+fonts in general are only typically hinted to work correctly at
+integer pixel sizes. Vera is coded internally for integer sizes only.
+We need to investigate further to see if there are commonly used fonts
+that are hinted to be rounded but are not rounded to integer sizes due
+to oversights in their coding.
+
+Most fonts work best at 8 pixels and below if anti-aliased only, as
+the amount of work required to hint well at smaller and smaller sizes
+becomes astronomical. GASP tables are typically used to control
+whether hinting is used or not, but Freetype/Xft does not currently
+support GASP tables (which are present in Vera).
+
+To mitigate this problem, both for Vera and other fonts, there will be
+(very shortly) a new fontconfig 2.2 release that will, by default not
+apply hints if the size is below 8 pixels. if you should have a font
+that in fact has been hinted more agressively, you can use fontconfig
+to note this exception. We believe this should improve many hinted
+fonts in addition to Vera, though implemeting GASP support is likely
+the right long term solution.
+
+Font rendering in Gnome or KDE is the combination of algorithms in
+Xft2 and Freetype, along with hinting in the fonts themselves. It is
+vital to have sufficient information to disentangle problems that you
+may observe.
+
+Note that having your font rendering system set up correctly is vital
+to proper judgement of problems of the fonts:
+
+ * Freetype may or may not be configured to in ways that may
+ implement execution of possibly patented (in some parts of the
world)
+ TrueType hinting algorithms, particularly at small sizes. Best
+ results are obtained while using these algorithms.
+
+ * The freetype autohinter (used when the possibly patented
+ algorithms are not used) continues to improve with each release.
If
+ you are using the autohinter, please ensure you are using an up
to
+ date version of freetype before reporting problems.
+
+ * Please identify what version of freetype you are using in any
+ bug reports, and how your freetype is configured.
+
+ * Make sure you are not using the freetype version included in
+ XFree86 4.3, as it has bugs that significantly degrade most
fonts,
+ including Vera. if you build XFree86 4.3 from source yourself,
you may
+ have installed this broken version without intending it (as I
+ did). Vera was verified with the recently released Freetype
2.1.4. On
+ many systems, 'ldd" can be used to see which freetype shared
library
+ is actually being used.
+
+ * Xft/X Render does not (yet) implement gamma correction. This
+ causes significant problems rendering white text on a black
background
+ (causing partial pixels to be insufficiently shaded) if the gamma
of
+ your monitor has not been compensated for, and minor problems
with
+ black text on a while background. The program "xgamma" can be
used to
+ set a gamma correction value in the X server's color pallette.
Most
+ monitors have a gamma near 2.
+
+ * Note that the Vera family uses minimal delta hinting. Your
+ results on other systems when not used anti-aliased may not be
+ entirely satisfying. We are primarily interested in reports of
+ problems on open source systems implementing
Xft2/fontconfig/freetype
+ (which implements antialiasing and hinting adjustements, and
+ sophisticated subpixel decimation on flatpanels). Also, the
+ algorithms used by Xft2 adjust the hints to integer widths and
the
+ results are crisper on open source systems than on Windows or
+ MacIntosh.
+
+ * Your fontconfig may (probably does) predate the release of
+ fontconfig 2.2, and you may see artifacts not present when the
font is
+ used at very small sizes with hinting enabled. "vc-list -V" can
be
+ used to see what version you have installed.
+
+We believe and hope that these fonts will resolve the problems
+reported during beta test. The largest change is the reduction of
+leading (interline spacing), which had annoyed a number of people, and
+reduced Vera's utility for some applcations. The Vera monospace font
+should also now make '0' and 'O' and '1' and 'l' more
clearly
+distinguishable.
+
+The version of these fonts is version 1.10. Fontconfig should be
+choosing the new version of the fonts if both the released fonts and
+beta test fonts are installed (though please discard them: they have
+names of form tt20[1-12]gn.ttf). Note that older versions of
+fontconfig sometimes did not rebuild their cache correctly when new
+fonts are installed: please upgrade to fontconfig 2.2. "fc-cache -f"
+can be used to force rebuilding fontconfig's cache files.
+
+If you note problems, please send them to fonts at gnome dot org, with
+exactly which face and size and unicode point you observe the problem
+at. The xfd utility from XFree86 CVS may be useful for this (e.g. "xfd
+-fa sans"). A possibly more useful program to examine fonts at a
+variety of sizes is the "waterfall" program found in Keith Packard's
+CVS.
+
+ $ cvs -d :pserver:anoncvs@keithp.com:/local/src/CVS login
+ Logging in to :pserver:anoncvs@keithp.com:2401/local/src/CVS
+ CVS password: <hit return>
+ $ cvs -d :pserver:anoncvs@keithp.com:/local/src/CVS co
waterfall
+ $ cd waterfall
+ $ xmkmf -a
+ $ make
+ # make install
+ # make install.man
+
+Again, please make sure you are running an up-to-date freetype, and
+that you are only examining integer sizes.
+
+Reporting Problems
+==================
+
+Please send problem reports to fonts at gnome org, with the following
+information:
+
+ 1. Version of Freetype, Xft2 and fontconfig
+ 2. Whether TT hinting is being used, or the autohinter
+ 3. Application being used
+ 4. Character/Unicode code point that has problems (if applicable)
+ 5. Version of which operating system
+ 6. Please include a screenshot, when possible.
+
+Please check the fonts list archives before reporting problems to cut
+down on duplication.