From ea9d446a4090d15702fbfdc618c29618ce68e60c Mon Sep 17 00:00:00 2001
From: wlemb <wlemb>
Date: Sun, 16 Dec 2001 23:47:22 +0000
Subject: * groff.texinfo: Document exact search algorithm for glyphs.

* Makefile.cpg, Makefile.ccpg, Makefile.man: Add dummy file to
the left side of $(MANPAGES) rule to make it always non-empty.
---
 ChangeLog         |  9 +++++++++
 Makefile.ccpg     |  2 +-
 Makefile.cpg      |  2 +-
 Makefile.man      |  2 +-
 doc/groff.texinfo | 26 +++++++++++++++++++++++++-
 5 files changed, 37 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index bfe43fc9..beb72f2c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2001-12-16  Werner LEMBERG  <wl@gnu.org>
+
+	* groff.texinfo: Document exact search algorithm for glyphs.
+
+2001-12-15  Werner LEMBERG  <wl@gnu.org>
+
+	* Makefile.cpg, Makefile.ccpg, Makefile.man: Add dummy file to
+	the left side of $(MANPAGES) rule to make it always non-empty.
+
 2001-12-14  Werner LEMBERG  <wl@gnu.org>
 
 	* src/roff/troff/input.cc (default_black): Define default color
diff --git a/Makefile.ccpg b/Makefile.ccpg
index 02b5d66b..b89fab1f 100644
--- a/Makefile.ccpg
+++ b/Makefile.ccpg
@@ -24,7 +24,7 @@ TAGS_src: $(CCSRCS) $(CSRCS) $(GRAM) $(HDRS)
 Makefile: $(MAKEFILEPARTS)
 Makefile.dep:
 	touch Makefile.dep
-$(MANPAGES): $(top_srcdir)/VERSION $(top_srcdir)/REVISION
+$(top_builddir)/stamp-h $(MANPAGES): $(top_srcdir)/VERSION $(top_srcdir)/REVISION
 
 pure: $(PROG).pure
 
diff --git a/Makefile.cpg b/Makefile.cpg
index 4cb514f4..b7af68c3 100644
--- a/Makefile.cpg
+++ b/Makefile.cpg
@@ -24,4 +24,4 @@ TAGS_src: $(CCSRCS) $(CSRCS) $(GRAM) $(HDRS)
 Makefile: $(MAKEFILEPARTS)
 Makefile.dep:
 	touch Makefile.dep
-$(MANPAGES): $(top_srcdir)/VERSION $(top_srcdir)/REVISION
+$(top_builddir)/stamp-h $(MANPAGES): $(top_srcdir)/VERSION $(top_srcdir)/REVISION
diff --git a/Makefile.man b/Makefile.man
index 2fecd115..6eaf3111 100644
--- a/Makefile.man
+++ b/Makefile.man
@@ -2,4 +2,4 @@ all: $(MANPAGES)
 install_data: install_man
 install_man: $(MANPAGES)
 uninstall_sub: uninstall_man
-$(MANPAGES): $(top_srcdir)/VERSION $(top_srcdir)/REVISION
+$(top_builddir)/stamp-h $(MANPAGES): $(top_srcdir)/VERSION $(top_srcdir)/REVISION
diff --git a/doc/groff.texinfo b/doc/groff.texinfo
index 24cdb59c..d6b8e049 100644
--- a/doc/groff.texinfo
+++ b/doc/groff.texinfo
@@ -5964,6 +5964,30 @@ special fonts.  Fonts mounted with the @code{fonts} keyword in the
 special fonts locally (i.e.@: for a particular font), use the
 @code{fspecial} request.
 
+In summary, @code{gtroff} tries the following to find a given symbol:
+
+@itemize @bullet
+@item
+If the symbol has been defined with the @code{char} request, use it.
+This hides a symbol with the same name in the current font.
+
+@item
+Check the current font.
+
+@item
+Check all fonts given with the @code{fspecial} request, in the order
+of appearance in @code{fspecial} calls.
+
+@item
+Check all fonts given with the @code{special} request, in the order
+of appearance in @code{special} calls (inclusively the special fonts
+defined in the @file{DESC} file, which come first).
+
+@item
+As a last resort, consult all fonts loaded up to now (in the order they
+have been called the first time) for special fonts and check them.
+@end itemize
+
 @xref{Font Files}, and @ref{Special Fonts}, for more details.
 
 @Defesc {\\, @lparen{}, nm, }
@@ -7407,7 +7431,7 @@ The @code{als} request can make a macro have more than one name.
 This would be called as
 
 @Example
-.vl $Id: groff.texinfo,v 1.86 2001/12/12 15:09:12 wlemb Exp $
+.vl $Id: groff.texinfo,v 1.87 2001/12/16 23:47:26 wlemb Exp $
 @endExample
 @endDefesc
 
-- 
cgit v1.2.1