This is the first gs593 integration it is *NOT* a release. Normally

each file is checked in with an associated log entry, in order to
check in all of the code simultaneously we batch all of the file
name's modified and change descriptions here (Note: Aladdin code changes
are documented in gs/doc/News.htm)

- pcstate.h - removes show enumeration from pcl state.
- pctop.c, pxtop.c
	- gs_grestore_no_wraparound()'s is now gs_grestore_only().
- pxgstate.c
        - ENUM_RETURN_CONST_STRING_PTR() now takes a gs string
	  argument instead of the string's data as it did
          previously.
- plmain.c -
	- The library no longer initializes io devices.  Adds
	  gs_iodev_init() to main() procedure.  Also, gs_c_param_list_rewrite()
	  is renamed to gs_c_param_list_write_more().
- pcltop.mak - adds pipe.dev for operating system pipe support.
- pctext.c, pglabel.c, pxfont.c, plfont.c
   - extensive modifications to support the text api (gstext.h)
	- use gs_text_enum_t instead of gs_show_enum.
	- removes enumeration allocation, this is now done by the text
          "begin" functions.
	- update "next_char" procs and "encode char" procs to take a
	  glyph argument and the character argument is now passed by value
          (pcl nor xl make use of the glyph argument).
	- char_path_n_init() replaced with gs_charpath_begin().
	- gs_show_n_init() replaced with gs_show_begin().
	- gs_show_next() is now handled by gs_process_text().
	- gs_release_text() added.
        - gs_xyshow_n_init() replace with gs_xyshow_begin().  Passing
	  of x and y coordinates modified to support the new interface.
	  Unfortunately, we need to transform the coordinates into the
          space of the font scaling matrix, that is the current ctm for
          xl when the the text is processed.  This differs from postscript
	  which appears to have the regular user->device matrix in the
	  graphics state during processing.
	- (plfont.c) - gs_notify_init() is now part of the pfont
          initialization procedure, related TODO: cut over to gs_font_alloc()
	  and gs_font_base_alloc().

- all gs files - removes uninitialized rcs identifiers.

KNOWN PROBLEMS:

occassional pxl and pcl crashes in gdev_mem_set_line_ptrs() when
running in color due to null base (data) pointer.

git-svn-id: http://svn.ghostscript.com/ghostpcl/trunk/ghostpcl@985 06663e23-700e-0410-b217-a244a6096597

1 files changed, 18 insertions, 10 deletions

diff --git a/gs/src/gp.h b/gs/src/gp.h
index f0f3fab1d..b6d0b62f7 100644
--- a/gs/src/gp.h
+++ b/gs/src/gp.h
@@ -26,12 +26,12 @@
 #include "gstypes.h"
 /*
  * This file defines the interface to ***ALL*** platform-specific routines,
- * with the exception of the thread/synchronization interface (gpsync.h).
- * The routines are implemented in a gp_*.c file specific to each platform.
- * We try very hard to keep this list short!
+ * with the exception of the thread/synchronization interface (gpsync.h)
+ * and getenv (gpgetenv.h).  The implementations are in gp_*.c files
+ * specific to each platform.  We try very hard to keep this list short!
  */
 /*
- * gp_getenv is declared in a separate file, because a few places need it
+ * gp_getenv is declared in a separate file because a few places need it
  * and don't want to include any of the other gs definitions.
  */
 #include "gpgetenv.h"
@@ -204,24 +204,32 @@ const char *gp_file_name_concat_string(P4(const char *prefix, uint plen,
 /* ------ Printer accessing ------ */
 
 /*
- * Open a connection to a printer.  A null file name means use the
- * standard printer connected to the machine, if any.
- * If possible, support "|command" for opening an output pipe.
- * Return NULL if the connection could not be opened.
+ * Open a connection to a printer.  A null file name means use the standard
+ * printer connected to the machine, if any.  Note that this procedure is
+ * called only if the original file name (normally the value of the
+ * OutputFile device parameter) was an ordinary file (not stdout, a pipe, or
+ * other %filedevice%file name): stdout is handled specially, and other
+ * values of filedevice are handled by calling the fopen procedure
+ * associated with that kind of "file".
  *
  * Note that if the file name is null (0-length), it may be replaced with
  * the name of a scratch file.
  */
 FILE *gp_open_printer(P2(char fname[gp_file_name_sizeof], int binary_mode));
 
-/* Close the connection to the printer. */
+/*
+ * Close the connection to the printer.  Note that this is only called
+ * if the original file name was an ordinary file (not stdout, a pipe,
+ * or other %filedevice%file name): stdout is handled specially, and other
+ * values of filedevice are handled by calling the fclose procedure
+ * associated with that kind of "file".
+ */
 void gp_close_printer(P2(FILE * pfile, const char *fname));
 
 /* ------ File enumeration ------ */
 
 #ifndef file_enum_DEFINED	/* also defined in iodev.h */
 #  define file_enum_DEFINED
-struct file_enum_s;		/* opaque to client, defined by implementor */
 typedef struct file_enum_s file_enum;
 #endif