Implement \f[] as an alternative to \fP. Change \mP and \MP to

\m[] and \M[], respectively.

* src/roff/troff/symbol.cc (EMPTY_SYMBOL): New global variable.
(symbol::symbol): Handle NULL string and empty string differently.
* src/roff/troff/symbol.h (symbol::is_empty): New inline function.
* src/roff/troff/input.cc (read_escape_name, read_long_escape_name):
Add optional parameter.
Updated calling functions.
(get_copy, do_glyph_color, do_fill_color, token::next): Use
`symbol::is_empty'.
* src/roff/troff/env.cc (environment::set_font): Ditto.

* src/preproc/pic/troff.cc (troff_output::set_fill,
troff_output::reset_color: Updated.

* tmac/www.tmac: Updated.

* NEWS, man/groff_diff.man, man/groff.man, doc/groff.texinfo,
doc/homepage.ms, src/devices/grotty/grotty.man, tmac/groff_www.man:
Updated.

* src/include/printer.h, src/libs/libdriver/printer.cc
(printer::change_fill_color): New member function.
* src/libs/libdriver/input.cc (parse_D_command): Use it.

1 files changed, 38 insertions, 16 deletions

diff --git a/src/include/printer.h b/src/include/printer.h
index 726277b9..4d5cbf52 100644
--- a/src/include/printer.h
+++ b/src/include/printer.h
@@ -1,23 +1,40 @@
 // -*- C++ -*-
+
+// <groff_src_dir>/src/include/printer.h
+
 /* Copyright (C) 1989, 1990, 1991, 1992, 2001, 2002
    Free Software Foundation, Inc.
-     Written by James Clark (jjc@jclark.com)
 
-This file is part of groff.
+   Written by James Clark (jjc@jclark.com)
+
+   Last update: 12 Apr 2002
+
+   This file is part of groff.
+
+   groff is free software; you can redistribute it and/or modify it
+   under the terms of the GNU General Public License as published by
+   the Free Software Foundation; either version 2, or (at your option)
+   any later version.
+
+   groff is distributed in the hope that it will be useful, but
+   WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+   General Public License for more details.
 
-groff is free software; you can redistribute it and/or modify it under
-the terms of the GNU General Public License as published by the Free
-Software Foundation; either version 2, or (at your option) any later
-version.
+   You should have received a copy of the GNU General Public License
+   along with groff; see the file COPYING.  If not, write to the Free
+   Software Foundation, 59 Temple Place - Suite 330, Boston, MA
+   02111-1307, USA.
+*/
 
-groff is distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY; without even the implied warranty of MERCHANTABILITY or
-FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-for more details.
+/* Description
 
-You should have received a copy of the GNU General Public License along
-with groff; see the file COPYING.  If not, write to the Free Software
-Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
+   The class `printer' performs the postprocessing.  Each
+   postprocessor only need to implement a derived class of `printer' and
+   a suitable function `make_printer' for the device-dependent tasks.
+   Then the methods of class `printer' are called automatically by
+   `do_file()' in `input.cc'.
+*/
 
 #include "color.h"
 
@@ -50,17 +67,22 @@ public:
 		      int *widthp = 0);
   void set_special_char(const char *nm, const environment *env,
 			int *widthp = 0);
-  void set_numbered_char(int n, const environment *env, int *widthp = 0);
+  void set_numbered_char(int n, const environment *env,
+			 int *widthp = 0);
   int set_char_and_width(const char *nm, const environment *env,
 			 int *widthp, font **f);
   font *get_font_from_index(int fontno);
   virtual void draw(int code, int *p, int np, const environment *env);
-  virtual void change_color(const environment *env);
+  // perform change of line color (text, outline) in the print-out 
+  virtual void change_color(const environment * const env);
+  // perform change of fill color in the print-out 
+  virtual void change_fill_color(const environment * const env);
   virtual void begin_page(int) = 0;
   virtual void end_page(int page_length) = 0;
   virtual font *make_font(const char *nm);
   virtual void end_of_line();
-  virtual void special(char *arg, const environment *env, char type = 'p');
+  virtual void special(char *arg, const environment *env,
+		       char type = 'p');
 protected:
   font_pointer_list *font_list;