From f3ba7d46b33980dc1715107ec7c9a3fd6e7175f8 Mon Sep 17 00:00:00 2001 From: Carl Sorensen Date: Mon, 27 Jun 2011 21:10:34 -0600 Subject: [PATCH] Doc: Contributor: Add section on fonts --- Documentation/contributor.texi | 2 + Documentation/contributor/feta-font.itexi | 52 +++++++++++++++++++++++ 2 files changed, 54 insertions(+) create mode 100644 Documentation/contributor/feta-font.itexi 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 + -- 2.39.2