Stuff I forgot, and some further changes to gimprc.c

ChangeLog

@@ -5,6 +5,8 @@
 	communication now uses GIOChannels, not plain file descriptors
 	(this change only affects a few files).
 	
+	* README.win32,config.h.win32,gimprc.win32,user_install.bat: New files.
+	
 	* libgimp/gimpenv.[ch]: New files. gimpenv contains functions that
 	handle directory and file names specific to the GIMP installation
 	and runtime environment.

README.win32

+This is an unstable release of the GIMP, intended for developers only.
+
+For more information about the port or GLib, GTk+ and the GIMP to
+native Windows, and pre-built binary packages, see
+http://www.iki.fi/tml/gimp/win32/ or
+http://www.gimp.org/~tml/gimp/win32/
+
+To build the GIMP on Win32, you will need (for now) the Microsoft
+compiler. Eventually gcc (egcs) from cygwin will also be supported.
+
+First, build in the libgimp directory, then in tools/gcg, then in app,
+plug-ins, and finally in modules. Check the makefile.msc files in said
+directories.
+
+The current build setup for Windows is a mess, I know that.
+   
+--Tor Lillqvist <tml@iki.fi>

app/Makefile.am

@@ -374,8 +374,6 @@ EXTRA_DIST = \
 
 CPPFLAGS = \
 	-DLIBDIR=\""$(gimpplugindir)"\"	\
-	-DDATADIR=\""$(gimpdatadir)"\"	\
-	-DGIMPDIR=\""$(gimpdir)"\"	\
 	-DLOCALEDIR=\""$(localedir)"\"	\
 	-DREGEX_MALLOC			\
 	@GIMP_THREAD_FLAGS@

app/gimprc.c

@@ -2153,14 +2153,8 @@ open_backup_file (char *filename,
     {
       if ((*fp_old = fopen (secondary_filename, "r")) == NULL)
 	{
-	  if (errno == EACCES)
-	    return g_strdup_printf (_("Can't open %s; permission problems"),
-				    secondary_filename);
-	  if (errno == ENOENT)
-	    return g_strdup_printf (_("Can't open %s; file does not exist"),
-				    secondary_filename);
-	  return g_strdup_printf (_("Can't open %s; reason unknown"),
-				  secondary_filename);
+	  return g_strdup_printf (_("Can't open %s; %s"),
+				  secondary_filename, g_strerror (errno));
 	}
       else
 	*name_used = secondary_filename;

config.h.win32

+/* config.h.win32. Hand-generated */
+
+/* Define if using alloca.c.  */
+/* #undef C_ALLOCA */
+
+/* Define to empty if the keyword does not work.  */
+/* #undef const */
+
+/* Define to one of _getb67, GETB67, getb67 for Cray-2 and Cray-YMP systems.
+   This function is required for alloca.c support on those systems.  */
+/* #undef CRAY_STACKSEG_END */
+
+/* Define if you have alloca, as a function or macro.  */
+#define HAVE_ALLOCA 1
+#define alloca _alloca
+
+/* Define if you have <alloca.h> and it should be used (not on Ultrix).  */
+/* #undef HAVE_ALLOCA_H */
+
+/* Define if you don't have vprintf but do have _doprnt.  */
+/* #undef HAVE_DOPRNT */
+
+/* Define if you have a working `mmap' system call.  */
+/* #undef HAVE_MMAP */
+
+/* Define if you have <sys/wait.h> that is POSIX.1 compatible.  */
+/* #undef HAVE_SYS_WAIT_H */
+
+/* Define if you have <unistd.h>.  */
+/* #undef HAVE_UNISTD_H */
+
+/* Define if you have the vprintf function.  */
+#define HAVE_VPRINTF 1
+
+/* Define as __inline if that's what the C compiler calls it.  */
+#define inline __inline
+
+/* Define to `long' if <sys/types.h> doesn't define.  */
+/* #undef off_t */
+
+/* Define to `int' if <sys/types.h> doesn't define.  */
+/* #undef pid_t */
+
+/* Define if you need to in order for stat and other things to work.  */
+/* #undef _POSIX_SOURCE */
+
+/* Define as the return type of signal handlers (int or void).  */
+#define RETSIGTYPE void
+
+/* Define to `unsigned' if <sys/types.h> doesn't define.  */
+/* #undef size_t */
+
+/* If using the C implementation of alloca, define if you know the
+   direction of stack growth for your system; otherwise it will be
+   automatically deduced at run-time.
+ STACK_DIRECTION > 0 => grows toward higher addresses
+ STACK_DIRECTION < 0 => grows toward lower addresses
+ STACK_DIRECTION = 0 => direction of growth unknown
+ */
+#define STACK_DIRECTION -1
+
+/* Define if you have the ANSI C header files.  */
+#define STDC_HEADERS 1
+
+/* Define if your processor stores words with the most significant
+   byte first (like Motorola and SPARC, unlike Intel and VAX).  */
+/* #undef WORDS_BIGENDIAN */
+
+/* Define if you can safely include both <sys/time.h> and <time.h>.  */
+/* #undef TIME_WITH_SYS_TIME */
+
+/* #undef ENABLE_MP */
+/* #undef ENABLE_NLS */
+/* #undef HAVE_CATGETS */
+/* #undef HAVE_DIRENT_H */
+/* #undef HAVE_DOPRNT */
+/* #undef HAVE_GETTEXT */
+/* #undef HAVE_IPC_H */
+/* #undef HAVE_LC_MESSAGES */
+/* #undef HAVE_NDIR_H */
+#define HAVE_PROGRESSIVE_JPEG 1
+/* #undef HAVE_PUTENV */
+/* #undef HAVE_RINT */
+/* #undef HAVE_SHM_H */
+/* #undef HAVE_STPCPY */
+/* #undef HAVE_SYS_DIR_H */
+/* #undef HAVE_SYS_NDIR_H */
+/* #undef HAVE_SYS_PARAM_H /*
+/* #undef HAVE_SYS_SELECT_H */
+/* #undef HAVE_SYS_TIME_H */
+/* #undef HAVE_SYS_TIMES_H */
+/* #undef HAVE_UNISTD_H */
+#define HAVE_VPRINTF 1
+/* #undef HAVE_VSNPRINTF */
+/* #undef HAVE_XSHM_H */
+
+/* #undef IPC_RMID_DEFERRED_RELEASE */
+
+/* #undef NO_DIFFTIME */
+/* #undef NO_FD_SET */
+
+#define RAND_FUNC rand
+#define SRAND_FUNC srand
+
+/* #undef USE_PTHREADS */
+
+/* Define if you have the __argz_count function.  */
+/* #undef HAVE___ARGZ_COUNT */
+
+/* Define if you have the __argz_next function.  */
+/* #undef HAVE___ARGZ_NEXT */
+
+/* Define if you have the __argz_stringify function.  */
+/* #undef HAVE___ARGZ_STRINGIFY */
+
+/* Define if you have the dcgettext function.  */
+/* #undef HAVE_DCGETTEXT */
+
+/* Define if you have the getcwd function.  */
+/* #undef HAVE_GETCWD */
+
+/* Define if you have the getpagesize function.  */
+/* #undef HAVE_GETPAGESIZE */
+
+/* Define if you have the munmap function.  */
+/* #undef HAVE_MUNMAP */
+
+/* Define if you have the putenv function.  */
+/* #undef HAVE_PUTENV */
+
+/* Define if you have the setenv function.  */
+/* #undef HAVE_SETENV */
+
+/* Define if you have the setlocale function.  */
+#define HAVE_SETLOCALE 1
+
+/* Define if you have the stpcpy function.  */
+/* #undef HAVE_STPCPY */
+
+/* Define if you have the strcasecmp function.  */
+/* #undef HAVE_STRCASECMP */
+
+/* Define if you have the strchr function.  */
+#define HAVE_STRCHR 1
+
+/* Define if you have the strdup function.  */
+#define HAVE_STRDUP 1
+
+/* Define if you have the vsnprintf function.  */
+/* #undef HAVE_VSNPRINTF */
+
+/* Define if you have the <argz.h> header file.  */
+/* #undef HAVE_ARGZ_H */
+
+/* Define if you have the <dirent.h> header file.  */
+/* #undef HAVE_DIRENT_H */
+
+/* Define if you have the <limits.h> header file.  */
+#define HAVE_LIMITS_H 1
+
+/* Define if you have the <locale.h> header file.  */
+#define HAVE_LOCALE_H 1
+
+/* Define if you have the <malloc.h> header file.  */
+/* #undef HAVE_MALLOC_H */
+
+/* Define if you have the <ndir.h> header file.  */
+/* #undef HAVE_NDIR_H */
+
+/* Define if you have the <nl_types.h> header file.  */
+/* #undef HAVE_NL_TYPES_H */
+
+/* Define if you have the <string.h> header file.  */
+#define HAVE_STRING_H 1
+
+/* Define if you have the <sys/dir.h> header file.  */
+/* #undef HAVE_SYS_DIR_H */
+
+/* Define if you have the <sys/ndir.h> header file.  */
+/* #undef HAVE_SYS_NDIR_H */
+
+/* Define if you have the <sys/param.h> header file.  */
+/* #undef HAVE_SYS_PARAM_H */
+
+/* Define if you have the <unistd.h> header file.  */
+/* #undef HAVE_UNISTD_H */
+
+/* Define if you have the i library (-li).  */
+/* #undef HAVE_LIBI */
+
+/* There are three orthogonal switches regarding Unix, X11 and Windows:
+   X_DISPLAY_MISSING vs. WINDOWS_DISPLAY, WIN32 (vs __unix__),
+   NATIVE_WIN32 vs. __CYGWIN32__ */
+
+/* Define if the X Window System is missing or not being used.  */
+#define X_DISPLAY_MISSING 1
+
+/* Define if compiling for Win32 (but possibly still for X).  */
+#define WIN32 1
+
+/* Define if the Win32 GDI API is being used.  */
+#define WINDOWS_DISPLAY 1
+
+/* Define if compiling for Win32 but not with the Cygnus Unix emulation.  */
+#define NATIVE_WIN32 1

data/misc/user_install.bat

+@REM This file is executed by the GIMP. Do NOT run this yourself.
+@echo off
+mkdir %2
+copy %1\gimprc_user %2\gimprc
+copy %1\gtkrc %2\gtkrc
+mkdir %2\brushes
+mkdir %2\gradients
+mkdir %2\palettes
+mkdir %2\patterns
+mkdir %2\plug-ins
+mkdir %2\modules
+mkdir %2\gfig
+mkdir %2\scripts
+mkdir %2\gflares
+
+pause

etc/gimprc.win32

+# This is the system-wide gimprc file.  Any change made in this file
+# will affect all users of this system, provided that they are not
+# overriding the default values in their personal gimprc file.
+#
+# Lines that start with a '#' are comments.
+# Blank lines are ignored.
+
+# The variable gimp_dir refers to your personal gimp directory. It is
+# set to either the value _gimp1.1 or the value of the environment
+# variable GIMP_DIRECTORY.  If the path in gimp_dir is relative, it is
+# considered relative to your home directory (value of environment
+# variable %HOME%, or %HOMEDRIVE%:%HOMEPATH%).  If you don't have a
+# home directory (typical on Windows systems), gimp_dir refers to
+# directory in the GIMP installation directory.
+
+# The variable gimp_install_dir is set to the directory where the gimp
+# was installed.
+
+(exec_prefix "${gimp_install_dir}\\bin")
+(gimp_data_dir "${gimp_install_dir}")
+(gimp_plugin_dir "${gimp_install_dir}")
+
+# Set the temporary storage directory...files will appear here
+# during the course of running the gimp.  Most files will disappear
+# when the gimp exits, but some files are likely to remain,
+# such as working palette files, so it is best if this directory
+# not be one that is shared by other users.
+(temp-path "${TEMP}")
+
+# Set the swap file location. The gimp uses a tile based memory
+# allocation scheme. The swap file is used to quickly and easily
+# swap files out to disk and back in. Be aware that the swap file
+# can easily get very large if the gimp is used with large images.
+# Also, things can get horribly slow if the swap file is created on 
+# a directory that is shared over a network.  For these reasons, it may 
+# be desirable to put your swap file in your %TEMP% directory.
+(swap-path "${TEMP}")
+
+# Set the brush search path...this path will be searched for valid
+#  brushes at startup.
+(brush-path "${gimp_dir}\\brushes;${gimp_data_dir}\\brushes")
+
+# Specify a default brush. If none is specified it defaults to the
+#  "1circle.gbr" brush which is just a single pixel sized brush.
+#  The brush is searched for in the brush path.
+(default-brush "19fcircle.gbr")
+
+# Set the pattern search path...this path will be searched for valid
+#  patterns at startup.
+(pattern-path "${gimp_dir}\\patterns;${gimp_data_dir}\\patterns")
+
+# Specify a default pattern.
+#  The pattern is searched for in the specified pattern paths.
+(default-pattern "wood2.pat")
+
+# Set the palette search path...this path will be searched for valid
+#  palettes at startup.
+(palette-path "${gimp_dir}\\palettes;${gimp_data_dir}\\palettes")
+
+# Specify a default palette.
+#  The pattern is searched for in the specified pattern paths.
+(default-palette "Default")
+
+# Set the gradient search path...this path will be searched for valid
+#  gradients at startup.
+(gradient-path "${gimp_dir}\\gradients;${gimp_data_dir}\\gradients")
+
+# Specify a default gradient.
+#  The gradient is searched for in the specified gradient paths.
+(default-gradient "German_flag_smooth")
+
+# Set the plug-in search path...this path will be searched for
+#  plug-ins when the plug-in is run.
+(plug-in-path "${gimp_dir}\\plug-ins;${gimp_dir}\\plug-ins\\script-fu;${gimp_plugin_dir}\\plug-ins")
+
+# Set the path for the script-fu plug-in.  This value is ignored by
+#  the GIMP if the script-fu plug-in is never run.
+(script-fu-path "${gimp_dir}\\scripts;${gimp_data_dir}\\scripts")
+
+# Set the path to modules that are to be initialized at startup
+(module-path "${gimp_dir}\\modules;${gimp_plugin_dir}\\modules")
+
+# The tile cache is used to make sure the gimp doesn't thrash
+# tiles between memory and disk. Setting this value higher will
+# cause the gimp to use less swap space, but will also cause
+# the gimp to use more memory. Conversely, a smaller cache size
+# causes the gimp to use more swap space and less memory.
+# Note: the gimp will still run even if `tile-cache-size' is
+# set to 0. The actual size can contain a suffix of 'm', 'M',
+# 'k', 'K', 'b' or 'B', which makes the gimp interpret the
+# size as being specified in megabytes, kilobytes and bytes
+# respectively. If no suffix is specified the size defaults to
+# being specified in kilobytes.
+(tile-cache-size 10m)
+
+# Speed of marching ants in the selection outline
+#  this value is in milliseconds
+#  (less time indicates faster marching)
+(marching-ants-speed 300)
+
+# Set the number of operations kept on the undo stack
+(undo-levels 5)
+
+# Set the color-cube resource for dithering on 8-bit displays
+#  The 4 values stand for Shades of red, green, blue and grays
+#  Multiplying the # of shades of each primary color yields
+#  the total number of colors that will be allocated from the
+#  gimp colormap.  This number should not exceed 256.  Most of the
+#  colors remaining after the allocation of the colorcube
+#  will be left to the system palette in an effort to reduce
+#  colormap "flashing".
+(color-cube 6 6 4 24)
+
+# Install a GIMP colormap by default -- only for 8-bit displays
+# (install-colormap)
+
+# Specify that marching ants for selected regions will be drawn
+#  with colormap cycling as oposed to redrawing with different stipple masks
+#  this color cycling option works only with 8-bit displays
+# (colormap-cycling)
+
+# Tools such as fuzzy-select and bucket fill find regions based on a
+#  seed-fill algorithm.  The seed fill starts at the intially selected
+#  pixel and progresses in all directions until the difference of pixel
+#  intensity from the original is greater than a specified threshold
+#  ==> This value represents the default threshold
+(default-threshold 15)
+
+# There is always a tradeoff between memory usage and speed.  In most
+#  cases, the GIMP opts for speed over memory.  However, if memory is
+#  a big issue, set stingy-memory-use
+# (stingy-memory-use)
+
+# When zooming into and out of images, this option enables the
+#  automatic resizing of windows
+# (allow-resize-windows)
+
+# Context-dependent cursors are cool.  They are enabled by default.
+#  However, they require overhead that you may want to do without.
+#  Uncomment this line to disable them.
+# (no-cursor-updating)
+
+# Layer preview sizes:
+#  none:    no previews in layers dialog/layer selector
+#  small:   32x32
+#  medium:  64x64
+#  large:   128x128
+#  #:       #x#
+(preview-size small)
+
+# Tooltips
+#  Comment this out to disable the tooltips in the toolbox
+# (dont-show-tool-tips)
+
+# Controlling ruler visibility
+#  The default behavior is for rulers to be ON.
+#  This can also be toggled with the View->Toggle Rulers command
+#  or shift+control+r
+# (dont-show-rulers)
+
+# Default units
+#  This is the default unit of a new image. It will appear in the
+#  File/New dialog and will be the unit for coordinate display when
+#  dot-for-dot is off.
+#  The default units can be one of:
+#  (inches millimeters points picas) plus those in your user units database
+#  The default is inches
+(default-units inches)
+
+# Default Resolution units
+#  This is used to specify the resolution of a new image
+#  The units for the resolution can be one of:
+#  (inches millimeters points picas) plus those in your user units database
+#  The default is inches
+(default-resolution-units inches)
+
+# Default Resolution
+#  This is the default resolution of a new image in dpi
+#  The default is 72.0 dpi in both x and y direction
+(default-xresolution 72.0)
+(default-yresolution 72.0)
+
+# Controlling statusbar visibility
+#  The default behavior is to show the statusbar.
+#  This can also be toggled with the View->Toggle Statusbar command
+#  or shift+control+s
+# (dont-show-statusbar)
+
+# Disable auto saving
+#  Auto saving is not yet implemented! Nothing will be auto-saved, no matter
+#  how you set this here.  
+#  Just uncomment the line below...
+# (dont-auto-save)
+
+# Disable confirmation before closing an image without saving
+#  Just uncomment the next line
+# (dont-confirm-on-close)
+
+# By default GIMP remembers the positions and sizes of the main dialogs and
+#  advices your window-manager to place them there again the next time you
+#  use the GIMP. To disable this behaviour, uncomment the line below...
+# (dont-save-session-info)
+
+# To let GIMP try to restore your last saved session, 
+#  uncomment the line below...
+# (always-restore-session)
+
+# Setting the level of interpolation
+#  Uncommenting this line will enable cubic interpolation.
+#  By default, GIMP uses linear interpolation, which is faster, but has poorer quality
+# (cubic-interpolation)
+
+# Set the gamma correction values for the display
+#  1.0 corresponds to no gamma correction.  For most displays,
+#  gamma correction should be set to between 2.0 and 2.6
+#  Run the utility "gamma_correct" to determine appropriate values
+#  for your display.
+#
+# One important item to keep in mind:  Many images that you might
+#  get from outside sources will in all likelihood already be
+#  gamma-corrected.  In these cases, the image will look washed-out
+#  if the gimp has gamma-correction turned on.  If you are going
+#  to work with images of this sort, turn gamma correction off
+#  by removing this line, or setting the values to 1.0.
+#  gamma-correction 1.0
+#  gamma-correction 2.0
+#                 ___
+(gamma-correction 1.0)
+
+# Set the manner in which transparency is displayed in images
+#  Transparency type can be one of:
+#    0: Light Checks
+#    1: Mid-Tone Checks
+#    2: Dark Checks
+#    3: White Only
+#    4: Gray Only
+#    5: Black Only
+#  Check size can be one of:
+#    0: Small
+#    1: Medium
+#    2: Large
+(transparency-type 1)
+(transparency-size 2)
+
+# gfig pattern directory
+(gfig-path "${gimp_dir}\\gfig;${gimp_data_dir}\\gfig")
+
+# This string sets how image window titles are formatted.
+# The following percent expansions are performed:
+#   %%  literal percent sign
+#   %f  bare filename, or "Untiltled"
+#   %F  full path to file
+#   %p  PDB image id
+#   %i  view instance number
+#   %t  image type (RGB, indexed, greyscale)
+#   %z  zoom factor as a percentage
+#   %s  source scale factor
+#   %d  destination scale factor
+(image-title-format "%f-%p.%i (%t) %z%%")
+
+# [end of file]

gimprc.win32

+# This is the system-wide gimprc file.  Any change made in this file
+# will affect all users of this system, provided that they are not
+# overriding the default values in their personal gimprc file.
+#
+# Lines that start with a '#' are comments.
+# Blank lines are ignored.
+
+# The variable gimp_dir refers to your personal gimp directory. It is
+# set to either the value _gimp1.1 or the value of the environment
+# variable GIMP_DIRECTORY.  If the path in gimp_dir is relative, it is
+# considered relative to your home directory (value of environment
+# variable %HOME%, or %HOMEDRIVE%:%HOMEPATH%).  If you don't have a
+# home directory (typical on Windows systems), gimp_dir refers to
+# directory in the GIMP installation directory.
+
+# The variable gimp_install_dir is set to the directory where the gimp
+# was installed.
+
+(exec_prefix "${gimp_install_dir}\\bin")
+(gimp_data_dir "${gimp_install_dir}")
+(gimp_plugin_dir "${gimp_install_dir}")
+
+# Set the temporary storage directory...files will appear here
+# during the course of running the gimp.  Most files will disappear
+# when the gimp exits, but some files are likely to remain,
+# such as working palette files, so it is best if this directory
+# not be one that is shared by other users.
+(temp-path "${TEMP}")
+
+# Set the swap file location. The gimp uses a tile based memory
+# allocation scheme. The swap file is used to quickly and easily
+# swap files out to disk and back in. Be aware that the swap file
+# can easily get very large if the gimp is used with large images.
+# Also, things can get horribly slow if the swap file is created on 
+# a directory that is shared over a network.  For these reasons, it may 
+# be desirable to put your swap file in your %TEMP% directory.
+(swap-path "${TEMP}")
+
+# Set the brush search path...this path will be searched for valid
+#  brushes at startup.
+(brush-path "${gimp_dir}\\brushes;${gimp_data_dir}\\brushes")
+
+# Specify a default brush. If none is specified it defaults to the
+#  "1circle.gbr" brush which is just a single pixel sized brush.
+#  The brush is searched for in the brush path.
+(default-brush "19fcircle.gbr")
+
+# Set the pattern search path...this path will be searched for valid
+#  patterns at startup.
+(pattern-path "${gimp_dir}\\patterns;${gimp_data_dir}\\patterns")
+
+# Specify a default pattern.
+#  The pattern is searched for in the specified pattern paths.
+(default-pattern "wood2.pat")
+
+# Set the palette search path...this path will be searched for valid
+#  palettes at startup.
+(palette-path "${gimp_dir}\\palettes;${gimp_data_dir}\\palettes")
+
+# Specify a default palette.
+#  The pattern is searched for in the specified pattern paths.
+(default-palette "Default")
+
+# Set the gradient search path...this path will be searched for valid
+#  gradients at startup.
+(gradient-path "${gimp_dir}\\gradients;${gimp_data_dir}\\gradients")
+
+# Specify a default gradient.
+#  The gradient is searched for in the specified gradient paths.
+(default-gradient "German_flag_smooth")
+
+# Set the plug-in search path...this path will be searched for
+#  plug-ins when the plug-in is run.
+(plug-in-path "${gimp_dir}\\plug-ins;${gimp_dir}\\plug-ins\\script-fu;${gimp_plugin_dir}\\plug-ins")
+
+# Set the path for the script-fu plug-in.  This value is ignored by
+#  the GIMP if the script-fu plug-in is never run.
+(script-fu-path "${gimp_dir}\\scripts;${gimp_data_dir}\\scripts")
+
+# Set the path to modules that are to be initialized at startup
+(module-path "${gimp_dir}\\modules;${gimp_plugin_dir}\\modules")
+
+# The tile cache is used to make sure the gimp doesn't thrash
+# tiles between memory and disk. Setting this value higher will
+# cause the gimp to use less swap space, but will also cause
+# the gimp to use more memory. Conversely, a smaller cache size
+# causes the gimp to use more swap space and less memory.
+# Note: the gimp will still run even if `tile-cache-size' is
+# set to 0. The actual size can contain a suffix of 'm', 'M',
+# 'k', 'K', 'b' or 'B', which makes the gimp interpret the
+# size as being specified in megabytes, kilobytes and bytes
+# respectively. If no suffix is specified the size defaults to
+# being specified in kilobytes.
+(tile-cache-size 10m)
+
+# Speed of marching ants in the selection outline
+#  this value is in milliseconds
+#  (less time indicates faster marching)
+(marching-ants-speed 300)
+
+# Set the number of operations kept on the undo stack
+(undo-levels 5)
+
+# Set the color-cube resource for dithering on 8-bit displays
+#  The 4 values stand for Shades of red, green, blue and grays
+#  Multiplying the # of shades of each primary color yields
+#  the total number of colors that will be allocated from the
+#  gimp colormap.  This number should not exceed 256.  Most of the
+#  colors remaining after the allocation of the colorcube
+#  will be left to the system palette in an effort to reduce
+#  colormap "flashing".
+(color-cube 6 6 4 24)
+
+# Install a GIMP colormap by default -- only for 8-bit displays
+# (install-colormap)
+
+# Specify that marching ants for selected regions will be drawn