Doc: Contributor: Add section on fonts

diff --git a/Documentation/contributor.texi b/Documentation/contributor.texi
index 26b3a26fbbf00ef0416c2bde966bfcfe253ad4f1..fd951aaa92cbd14fad597860a0db28888c26d09a 100644 (file)
--- a/Documentation/contributor.texi
+++ b/Documentation/contributor.texi
@@ -61,6 +61,7 @@ Copyright @copyright{} 2007--2011 by the authors.
 * Programming work::
 * Release work::
 * Build system notes::
+* Modifying the feta font::
 * Administrative policies::
 
 Appendices
@@ -87,6 +88,7 @@ Appendices
 @include contributor/programming-work.itexi
 @include contributor/release-work.itexi
 @include contributor/build-notes.itexi
+@include contributor/feta-font.itexi
 @include contributor/administration.itexi
 
 @include fdl.itexi

diff --git a/Documentation/contributor/feta-font.itexi b/Documentation/contributor/feta-font.itexi
new file mode 100644 (file)
index 0000000..57a740b
--- /dev/null
+++ b/Documentation/contributor/feta-font.itexi
@@ -0,0 +1,52 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@node Modifying the feta font
+@chapter Modifying the feta font
+
+@menu
+* Overview of the feta font::
+* Font creation tools::
+* Building the changed font::
+@end menu
+
+@node Overview of the feta font
+@section Overview of the feta font
+
+The feta font is a font that was created specifically for use in
+LilyPond.  The sources for the font are found in mf/*.mf.
+
+The feta font is merged from a number of subfonts.  Each subfont
+can contain at most 223 glyphs.
+
+In LilyPond, glyphs are accessed by glyph name, rather than by code point.
+Therefore, the naming of glyphs is significant.
+
+Information about correctly creating glyphs is found in @file{mf/README}.
+Please make sure you read and understand this file.
+
+TODO -- we should get mf/README automatically generated from texinfo source
+and include it here.
+
+
+@node Font creation tools
+@section Font creation tools
+
+The sources for the feta font are written in metafont.  The definitive
+reference for metafont is "The METAFONT book".  Source for the book is
+available at CTAN.
+
+mf2pt1 is used to create type 1 fonts from the metafont sources.
+
+FontForge is used to display the resulting glyph shapes.
+
+@node Building the changed font
+@section Building the changed font
+
+In order to rebuild the font after making the changes, the existing
+font files must be deleted.  The simplest and quickest way to do this
+is to do:
+
+@example
+rm mf/out/*
+make
+@end example
+