From b3a110affa33f0a3c96e06438047913f2db90c91 Mon Sep 17 00:00:00 2001
From: Russ Cox <rsc@swtch.com>
Date: Tue, 17 Feb 2015 15:36:25 -0500
Subject: man: document font syntaxes

Change-Id: Id441d4df192c47388af6b5da306f14d90f066d18
Reviewed-on: https://plan9port-review.googlesource.com/1173
Reviewed-by: Russ Cox <rsc@swtch.com>
---
 man/man3/graphics.3 | 31 +++++++++----------------------
 1 file changed, 9 insertions(+), 22 deletions(-)

(limited to 'man/man3')

diff --git a/man/man3/graphics.3 b/man/man3/graphics.3
index 43214f1f..a2b2d848 100644
--- a/man/man3/graphics.3
+++ b/man/man3/graphics.3
@@ -228,30 +228,14 @@ pointer that can be used by
 to draw characters from the font.
 .I Openfont
 does the same, but reads the description
-from the named file.
+from the named font.
 .I Freefont
 frees a font.
-The convention for naming font files is:
-.IP
-.B /lib/font/bit/\fIname\fP/\fIrange\fP.\fIsize\fP.font
-.PD
-.PP
-where
-.I size
-is approximately the height in pixels of the lower case letters
-(without ascenders or descenders).
-.I Range
-gives some indication of which characters will be available: for example
-.BR ascii ,
-.BR latin1 ,
-.BR euro ,
-or
-.BR unicode .
-.B Euro
-includes most European languages, punctuation marks, the International Phonetic
-Alphabet, etc., but no Oriental languages.
-.B Unicode
-includes every character for which appropriate-sized images exist on the system.
+In contrast to Plan 9, font names in Plan 9 from User Space are
+a small language describing the desired font.
+See
+.IR font (7)
+for details.
 .PP
 A
 .I Cursor
@@ -319,6 +303,9 @@ if
 .B $font
 is not set, it imports the default (usually minimal)
 font from the operating system.
+(See
+.IR font (7)
+for a full discussion of font syntaxes.)
 The global
 .I font
 will be set to point to the resulting
-- 
cgit v1.2.3