summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCarl Sorensen <c_sorensen@byu.edu>2011-06-27 21:10:34 -0600
committerCarl Sorensen <c_sorensen@byu.edu>2011-06-27 21:16:25 -0600
commitf3ba7d46b33980dc1715107ec7c9a3fd6e7175f8 (patch)
tree09c887113df40294f77fb188020de9ecf2b882c4
parent9327ed676e6af46512b597d4630a8094f03d6f36 (diff)
Doc: Contributor: Add section on fonts
-rw-r--r--Documentation/contributor.texi2
-rw-r--r--Documentation/contributor/feta-font.itexi52
2 files changed, 54 insertions, 0 deletions
diff --git a/Documentation/contributor.texi b/Documentation/contributor.texi
index 26b3a26fbb..fd951aaa92 100644
--- 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
index 0000000000..57a740bcc1
--- /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
+