dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

app/config/Makefile.am app/config/gimpconfig-dump.c more work on 

2003-01-13  Sven Neumann  <sven@gimp.org>

	* app/config/Makefile.am
	* app/config/gimpconfig-dump.c
	* app/config/gimpconfig-serialize.c: more work on gimpconfig-dump.

	* configure.in
	* docs/Makefile.am
	* docs/gimprc-1.3.5.in: removed ...
	* docs/gimprc-1.3.5: ... and replaced with a new version generated
	using gimpconfig-dump (although it's not perfect yet).
This commit is contained in:
Sven Neumann 2003-01-12 23:57:26 +00:00 committed by Sven Neumann
parent 033778fe57
commit e0ea1dbcfb
11 changed files with 702 additions and 1031 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
ChangeLog
View File

@ -1,3 +1,15 @@
2003-01-13 Sven Neumann <sven@gimp.org>
* app/config/Makefile.am
* app/config/gimpconfig-dump.c
* app/config/gimpconfig-serialize.c: more work on gimpconfig-dump.
* configure.in
* docs/Makefile.am
* docs/gimprc-1.3.5.in: removed ...
* docs/gimprc-1.3.5: ... and replaced with a new version generated
using gimpconfig-dump (although it's not perfect yet).
2003-01-12 Dave Neary <bolsh@gimp.org>
* plug-ins/common/plugin-def.pl

2
app/config/.cvsignore
View File

@ -5,7 +5,7 @@ Makefile.in
*.lo
foorc
gimprc
gimprc.5
gimprc-1.3.5
gimpconfig-dump
libappconfig.la
test-config

2
app/config/Makefile.am
View File

@ -76,7 +76,7 @@ gimprc: gimpconfig-dump
./$< --system-gimprc > gimprc 2>/dev/null
man: gimpconfig-dump
./$< --man-page > gimprc.5 2>/dev/null
./$< --man-page > gimprc-1.3.5 2>/dev/null
#

131
app/config/gimpconfig-dump.c
View File

@ -43,9 +43,12 @@
#include "gimprc.h"
static gint dump_system_gimprc (void);
static gint dump_man_page (void);
static gchar * dump_get_comment (GParamSpec *param_spec);
static gint dump_system_gimprc (gint fd);
static gint dump_man_page (gint fd);
static gchar * dump_describe_param (GParamSpec *param_spec);
static void dump_with_linebreaks (gint fd,
const gchar *text);
int
@ -60,11 +63,11 @@ main (int argc,
{
if (strcmp (argv[1], "--system-gimprc") == 0)
{
return dump_system_gimprc ();
return dump_system_gimprc (1);
}
else if (strcmp (argv[1], "--man-page") == 0)
{
return dump_man_page ();
return dump_man_page (1);
}
else if (strcmp (argv[1], "--version") == 0)
{
@ -118,7 +121,7 @@ static const gchar *system_gimprc_header =
"\n";
static gint
dump_system_gimprc (void)
dump_system_gimprc (gint fd)
{
GObjectClass *klass;
GParamSpec **property_specs;
@ -129,7 +132,7 @@ dump_system_gimprc (void)
str = g_string_new (system_gimprc_header);
write (1, str->str, str->len);
write (fd, str->str, str->len);
rc = g_object_new (GIMP_TYPE_RC, NULL);
klass = G_OBJECT_GET_CLASS (rc);
@ -146,7 +149,7 @@ dump_system_gimprc (void)
g_string_assign (str, "");
comment = dump_get_comment (prop_spec);
comment = dump_describe_param (prop_spec);
if (comment)
{
gimp_config_serialize_comment (str, comment);
@ -160,7 +163,7 @@ dump_system_gimprc (void)
{
g_string_append (str, "\n");
write (1, str->str, str->len);
write (fd, str->str, str->len);
}
}
@ -210,12 +213,55 @@ static const gchar *man_page_header =
"Either spaces or tabs may be used to separate the name from the value.\n"
".PP\n"
".SH PROPERTIES\n"
"Valid properties and their types are:\n"
"Valid properties and their default values are:\n"
"\n";
static const gchar *man_page_path =
".PP\n"
".SH PATH EXPANSION\n"
"Strings of type PATH are expanded in a manner similar to\n"
".BR bash (1).\n"
"Specifically: tilde (~) is expanded to the user's home directory. Note that\n"
"the bash feature of being able to refer to other user's home directories\n"
"by writing ~userid/ is not valid in this file.\n"
"\n"
"${variable} is expanded to the current value of an environment variable.\n"
"There are a few variables that are pre-defined:\n"
".TP\n"
".I gimp_dir\n"
"The personal gimp directory which is set to the value of the environment\n"
"variable GIMP_DIRECTORY or to ~/.gimp-1.3.\n"
".TP\n"
".I gimp_data_dir\n"
"Nase for paths to shareable data, which is set to the value of the\n"
"environment variable GIMP_DATADIR or to a compiled-in default value.\n"
".TP\n"
".I gimp_plug_in_dir\n"
"Base to paths for architecture-specific plugins and modules, which is set\n"
"to the value of the environment variable GIMP_PLUGINDIR or to a\n"
"compiled-in default value.\n"
".TP\n"
".I gimp_sysconf_dir\n"
"Path to configuration files, which is set to the value of the environment\n"
"variable GIMP_SYSCONFDIR or to a compiled-in default value.\n\n";
static const gchar *man_page_footer =
".SH FILES\n"
".TP\n"
".I ${prefix}/etc/gimp/1.3/gimprc\n"
"System-wide configuration file\n"
".TP\n"
".I \\fB$HOME\\fP/.gimp-1.3/gimprc\n"
"Per-user configuration file\n"
"\n"
".SH \"SEE ALSO\"\n"
".BR gimp (1),\n"
".BR gimptool (1),\n"
".BR gimp-remote (1)\n";
static gint
dump_man_page (void)
dump_man_page (gint fd)
{
GObjectClass *klass;
GParamSpec **property_specs;
@ -225,9 +271,9 @@ dump_man_page (void)
guint i;
str = g_string_new (NULL);
g_string_printf (str, man_page_header, GIMP_VERSION);
write (1, str->str, str->len);
g_string_printf (str, man_page_header, GIMP_VERSION);
write (fd, str->str, str->len);
rc = g_object_new (GIMP_TYPE_RC, NULL);
klass = G_OBJECT_GET_CLASS (rc);
@ -237,21 +283,25 @@ dump_man_page (void)
for (i = 0; i < n_property_specs; i++)
{
GParamSpec *prop_spec = property_specs[i];
gchar *comment;
gchar *desc;
if (! (prop_spec->flags & GIMP_PARAM_SERIALIZE))
continue;
g_string_assign (str, "");
comment = dump_get_comment (prop_spec);
g_free (comment);
g_string_assign (str, ".TP\n");
if (gimp_config_serialize_property (rc, prop_spec, str, TRUE))
{
g_string_append (str, "\n");
write (1, str->str, str->len);
write (fd, str->str, str->len);
desc = dump_describe_param (prop_spec);
dump_with_linebreaks (fd, desc);
write (fd, "\n", 1);
g_free (desc);
}
}
@ -261,12 +311,15 @@ dump_man_page (void)
g_string_free (str, TRUE);
write (fd, man_page_path, strlen (man_page_path));
write (fd, man_page_footer, strlen (man_page_footer));
return EXIT_SUCCESS;
}
static gchar *
dump_get_comment (GParamSpec *param_spec)
dump_describe_param (GParamSpec *param_spec)
{
GType type;
const gchar *blurb;
@ -277,7 +330,9 @@ dump_get_comment (GParamSpec *param_spec)
if (!blurb)
{
g_warning ("FIXME: Property '%s' has no blurb.", param_spec->name);
blurb = param_spec->name;
blurb = g_strdup_printf ("The %s property has no description.",
param_spec->name);
}
type = param_spec->value_type;
@ -413,6 +468,40 @@ dump_get_comment (GParamSpec *param_spec)
}
#define LINE_LENGTH 78
static void
dump_with_linebreaks (gint fd,
const gchar *text)
{
const gchar *t;
gint i, len, space;
len = strlen (text);
while (len > 0)
{
for (t = text, i = 0, space = 0;
*t != '\n' && (i <= LINE_LENGTH || space == 0) && i < len;
t++, i++)
{
if (g_ascii_isspace (*t))
space = i;
}
if (i > LINE_LENGTH && space && *t != '\n')
i = space;
write (fd, text, i);
write (fd, "\n", 1);
i++;
text += i;
len -= i;
}
}
/*
* some dummy funcs so we can properly link this beast

15
app/config/gimpconfig-serialize.c
View File

@ -438,6 +438,17 @@ gimp_config_serialize_unknown_tokens (GObject *object,
return (write (fd, str->str, str->len) != -1);
}
#define LINE_LENGTH 75
/**
* gimp_config_serialize_comment:
* @str: a #GString.
* @comment: the comment to serialize
*
* Appends the @comment to @str and inserts linebreaks and hash-marks to
* format it as a comment.
**/
void
gimp_config_serialize_comment (GString *str,
const gchar *comment)
@ -450,14 +461,14 @@ gimp_config_serialize_comment (GString *str,
while (len > 0)
{
for (s = comment, i = 0, space = 0;
*s != '\n' && (i <= 76 || space == 0) && i < len;
*s != '\n' && (i <= LINE_LENGTH || space == 0) && i < len;
s++, i++)
{
if (g_ascii_isspace (*s))
space = i;
}
if (i > 76 && space && *s != '\n')
if (i > LINE_LENGTH && space && *s != '\n')
i = space;
g_string_append_len (str, "# ", 2);

1
configure.in
View File

@ -1182,7 +1182,6 @@ devel-docs/libgimpmodule/Makefile
devel-docs/libgimpwidgets/Makefile
docs/Makefile
docs/gimp-1.3.1
docs/gimprc-1.3.5
docs/gimptool-1.3.1
docs/gimp-remote-1.3.1
tips/Makefile

10
docs/Makefile.am
View File

@ -1,15 +1,15 @@
## Process this file with automake to produce Makefile.in
# Don't install any man-pages for now. They need to be updated and
# would clash with older gimp installations.
man_MANS = gimp-1.3.1 gimptool-1.3.1 gimprc-1.3.5 gimp-remote-1.3.1
man_MANS = \
gimp-1.3.1 \
gimptool-1.3.1 \
gimprc-1.3.5 \
gimp-remote-1.3.1
EXTRA_DIST = \
gimp-1.3.1.in \
gimptool-1.3.1.in \
gimp-remote-1.3.1.in \
gimprc-1.3.5.in \
Wilber.svg \
Wilber.xcf.gz \
Wilber.xcf.gz.README \

547
docs/gimprc-1.3.5 Normal file
View File

@ -0,0 +1,547 @@
.\" This man-page is auto-generated by gimpconfig-dump.
.TH GIMPRC 5 "Version 1.3.12" "GIMP Manual Pages"
.SH NAME
gimprc \- gimp configuration file
.SH DESCRIPTION
The
.B gimprc
file is a configuation file read by the gimp when it starts up. There
are two of these: one system-wide one stored in
${prefix}/etc/gimp/1.3/gimprc and a per-user \fB$HOME\fP/.gimp-1.3/gimprc
which may override system settings.
Comments are introduced by a hash sign (#), and continue until the end
of the line. Blank lines are ignored.
The
.B gimprc
file associates values with properties. These properties may be set
by lisp-like assignments of the form:
.IP
\f3(\f2property-name\ value\f3)\f1
.TP
where:
.TP 10
.I property-name
is one of the property names described below.
.TP
.I value
is the value the property is to be set to.
.PP
Either spaces or tabs may be used to separate the name from the value.
.PP
.SH PROPERTIES
Valid properties and their default values are:
.TP
(temp-path "${gimp_dir}/tmp")
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 or is cleared on
machine reboot such as /tmp. This is a single folder.
.TP
(swap-path "${gimp_dir}")
Set the swap file location. The gimp uses a tile based memory allocation
scheme. The swap file is used to quickly and easily swap tiles 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 mounted over NFS. For these reasons, it may be
desirable to put your swap file in "/tmp". This is a single folder.
.TP
(stingy-memory-use no)
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. Possible values are yes and no.
.TP
(num-processors 1)
On multiprocessor machines, if GIMP has been compiled with --enable-mp this
sets how many processors GIMP should use simultaneously. This is an integer
value.
.TP
(tile-cache-size 32M)
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.
The integer size can contain a suffix of 'B', 'K', 'M' or 'G' which makes GIMP
interpret the size as being specified in bytes, kilobytes, megabytes or
gigabytes. If no suffix is specified the size defaults to being specified in
kilobytes.
.TP
(interpolation-type linear)
Set the level of interpolation used for scaling and other transformations.
Possible values are none, linear and cubic.
.TP
(plug-in-path "${gimp_dir}/plug-ins:${gimp_plug_in_dir}/plug-ins")
Set the plug-in search path. This is a colon-separated list of folders to
search.
.TP
(tool-plug-in-path "${gimp_dir}/tool-plug-ins:${gimp_plug_in_dir}/tool-plug-ins")
The tool-plug-in-path property has no description. This is a colon-separated
list of folders to search.
.TP
(module-path "${gimp_dir}/modules:${gimp_plug_in_dir}/modules")
Set the module search path. This is a colon-separated list of folders to
search.
.TP
(environ-path "${gimp_dir}/environ:${gimp_plug_in_dir}/environ")
The environ-path property has no description. This is a colon-separated list
of folders to search.
.TP
(brush-path "${gimp_dir}/brushes:${gimp_data_dir}/brushes")
Set the brush search path. This is a colon-separated list of folders to
search.
.TP
(pattern-path "${gimp_dir}/patterns:${gimp_data_dir}/patterns")
Set the pattern search path. This is a colon-separated list of folders to
search.
.TP
(palette-path "${gimp_dir}/palettes:${gimp_data_dir}/palettes")
Set the palette search path. This is a colon-separated list of folders to
search.
.TP
(gradient-path "${gimp_dir}/gradients:${gimp_data_dir}/gradients")
Set the gradient search path. This is a colon-separated list of folders to
search.
.TP
(default-comment "Created with The GIMP")
The default-comment property has no description. This is a string value.
.TP
(default-image-type rgb)
Set the default image type in the File/New dialog. Possible values are rgb,
gray and indexed.
.TP
(default-image-width 256)
Set the default image width in the File/New dialog. This is an integer value.
.TP
(default-image-height 256)
Set the default image height in the File/New dialog. This is an integer
value.
.TP
(default-unit inches)
Set the default unit for new images and for the File/New dialog. This units
will be used for coordinate display when not in dot-for-dot mode. The unit
can be one inches, millimeters, points or picas plus those in your user units
database.
.TP
(default-xresolution 72.000000)
Set the default horizontal resolution for new images and for the File/New
dialog. This value is always in dpi (dots per inch). This is a float value.
.TP
(default-yresolution 72.000000)
Set the default vertical resolution for new images and for the File/New
dialog. This value is always in dpi (dots per inch). This is a float value.
.TP
(default-resolution-unit inches)
Set the units for the display of the default resolution in the File/New
dialog. The unit can be one inches, millimeters, points or picas plus those
in your user units database.
.TP
(undo-levels 5)
Set the number of operations kept on the undo stack. This is an integer
value.
.TP
(pluginrc-path "${gimp_dir}/pluginrc")
The pluginrc-path property has no description. This is a single filename.
.TP
(preview-size small)
Set the default preview size. Possible values are none, tiny, extra-small,
small, medium, large, extra-large, huge, enormous and gigantic.
.TP
(thumbnail-size normal)
The thumbnail-size property has no description. Possible values are none,
normal and large.
.TP
(gamma-correction 1.000000)
This setting is ignored. This is a float value.
.TP
(install-colormap no)
Install a private colormap; might be useful on pseudocolor visuals. Possible
values are yes and no.
.TP
(min-colors 144)
The min-colors property has no description. This is an integer value.
.TP
(marching-ants-speed 300)
Speed of marching ants in the selection outline. This value is in
milliseconds (less time indicates faster marching). This is an integer value.
.TP
(colormap-cycling no)
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. Possible values are yes and
no.
.TP
(resize-windows-on-zoom no)
When zooming into and out of images, this option enables the automatic
resizing of windows. Possible values are yes and no.
.TP
(resize-windows-on-resize no)
When the physical image size changes, this option enables the automatic
resizing of windows. Possible values are yes and no.
.TP
(default-dot-for-dot yes)
The default-dot-for-dot property has no description. Possible values are yes
and no.
.TP
(perfect-mouse no)
If set to true, the X server is queried for the mouse's current position on
each motion event, rather than relying on the position hint. This means
painting with large brushes should be more accurate, but it may be slower.
Perversely, on some X servers turning on this option results in faster
painting. Possible values are yes and no.
.TP
(cursor-mode tool-icon)
The cursor-mode property has no description. Possible values are tool-icon,
tool-crosshair and crosshair.
.TP
(cursor-updating yes)
Context-dependent cursors are cool. They are enabled by default. However,
they require overhead that you may want to do without. Possible values are
yes and no.
.TP
(image-title-format "%f-%p.%i (%t)")
Set the text to appear in image window titles. Certain % character sequences
are recognised and expanded as follows:
%% literal percent sign
%f bare filename, or "Untitled"
%F full path to file, or "Untitled"
%p PDB image id
%i view instance number
%t image type (RGB, grayscale, indexed)
%z zoom factor as a percentage
%s source scale factor
%d destination scale factor
%Dx expands to x if the image is dirty, the empty string otherwise
%Cx expands to x if the image is clean, the empty string otherwise
%m memory used by the image
%l the number of layers
%L the name of the active layer/channel
%w image width in pixels
%W image width in real-world units
%h image height in pixels
%H image height in real-world units
%u unit symbol
%U unit abbreviation
This is a string value.
.TP
(image-status-format "%f-%p.%i (%t)")
Set the text to appear in image window status bars. See image-title-format for
the list of possible % sequences. This is a string value.
.TP
(show-menubar no)
Set the menubar visibility. This can also be toggled with the View->Toggle
Menubar command. Possible values are yes and no.
.TP
(show-rulers yes)
Set the ruler visibility. This can also be toggled with the View->Toggle
Rulers command. Possible values are yes and no.
.TP
(show-statusbar yes)
Controlling statusbar visibility. This can also be toggled with the
View->Toggle Statusbar command. Possible values are yes and no.
.TP
(confirm-on-close yes)
Ask for confirmation before closing an image without saving. Possible values
are yes and no.
.TP
(monitor-xresolution 72.000000)
Set the monitor's horizontal resolution, in dots per inch. If set to 0,
forces the X server to be queried for both horizontal and vertical resolution
information. This is a float value.
.TP
(monitor-yresolution 72.000000)
Set the monitor's vertical resolution, in dots per inch. If set to 0, forces
the X server to be queried for both horizontal and vertical resolution
information. This is a float value.
.TP
(monitor-resolution-from-windowing-system yes)
The monitor-resolution-from-windowing-system property has no description.
Possible values are yes and no.
.TP
(navigation-preview-size medium)
The navigation-preview-size property has no description. Possible values are
none, tiny, extra-small, small, medium, large, extra-large, huge, enormous and
gigantic.
.TP
(canvas-padding-mode default)
The canvas-padding-mode property has no description. Possible values are
default, light-check, dark-check and custom.
.TP
(canvas-padding-color (color-rgba 1.000000 1.000000 1.000000 1.000000))
The canvas-padding-color property has no description. The color is specified
in the form (color-rgba red green blue alpha) with channel values as floats
between 0.0 and 1.0.
.TP
(transparency-size medium-checks)
Sets the size of the checkerboard used to display transparency. Possible
values are small-checks, medium-checks and large-checks.
.TP
(transparency-type gray-checks)
Set the manner in which transparency is displayed in images. Possible values
are light-checks, gray-checks, dark-checks, white-only, gray-only and
black-only.
.TP
(default-threshold 15)
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. This is an integer value.
.TP
(info-window-per-display no)
The info-window-per-display property has no description. Possible values are
yes and no.
.TP
(trust-dirty-flag no)
The trust-dirty-flag property has no description. Possible values are yes and
no.
.TP
(save-device-status no)
Remember the current tool, pattern, color, and brush across GIMP sessions.
Possible values are yes and no.
.TP
(save-session-info yes)
Remember the positions and sizes of the main dialogs and asks your
window-manager to place them there again the next time you use the GIMP.
Possible values are yes and no.
.TP
(restore-session yes)
The restore-session property has no description. Possible values are yes and
no.
.TP
(show-tips yes)
Set to display a handy GIMP tip on startup. Possible values are yes and no.
.TP
(show-tool-tips yes)
Set to display tooltips. Possible values are yes and no.
.TP
(tearoff-menus yes)
The tearoff-menus property has no description. Possible values are yes and
no.
.TP
(last-opened-size 4)
How many recently opened image filenames to keep on the File menu. This is an
integer value.
.TP
(max-new-image-size 32M)
The max-new-image-size property has no description. The integer size can
contain a suffix of 'B', 'K', 'M' or 'G' which makes GIMP interpret the size
as being specified in bytes, kilobytes, megabytes or gigabytes. If no suffix
is specified the size defaults to being specified in kilobytes.
.TP
(theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
The theme-path property has no description. This is a colon-separated list of
folders to search.
.TP
(use-help yes)
The use-help property has no description. Possible values are yes and no.
.TP
(help-browser gimp)
The help-browser property has no description. Possible values are gimp and
netscape.
.TP
(fractalexplorer-path "${gimp_dir}/fractalexplorer:${gimp_data_dir}/fractalexplorer")
Where to search for fractals used by the Fractal Explorer plug-in. This is a
colon-separated list of folders to search.
.TP
(gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
Where to search for Gfig figures used by the Gfig plug-in. This is a
colon-separated list of folders to search.
.TP
(gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
Where to search for gflares used by the GFlare plug-in. This is a
colon-separated list of folders to search.
.TP
(gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gimpressionist")
Where to search for data used by the Gimpressionist plug-in. This is a
colon-separated list of folders to search.
.TP
(script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
This path will be searched for scripts when the Script-Fu plug-in is run.
This is a colon-separated list of folders to search.
.PP
.SH PATH EXPANSION
Strings of type PATH are expanded in a manner similar to
.BR bash (1).
Specifically: tilde (~) is expanded to the user's home directory. Note that
the bash feature of being able to refer to other user's home directories
by writing ~userid/ is not valid in this file.
${variable} is expanded to the current value of an environment variable.
There are a few variables that are pre-defined:
.TP
.I gimp_dir
The personal gimp directory which is set to the value of the environment
variable GIMP_DIRECTORY or to ~/.gimp-1.3.
.TP
.I gimp_data_dir
Nase for paths to shareable data, which is set to the value of the
environment variable GIMP_DATADIR or to a compiled-in default value.
.TP
.I gimp_plug_in_dir
Base to paths for architecture-specific plugins and modules, which is set
to the value of the environment variable GIMP_PLUGINDIR or to a
compiled-in default value.
.TP
.I gimp_sysconf_dir
Path to configuration files, which is set to the value of the environment
variable GIMP_SYSCONFDIR or to a compiled-in default value.
.SH FILES
.TP
.I ${prefix}/etc/gimp/1.3/gimprc
System-wide configuration file
.TP
.I \fB$HOME\fP/.gimp-1.3/gimprc
Per-user configuration file
.SH "SEE ALSO"
.BR gimp (1),
.BR gimptool (1),
.BR gimp-remote (1)

499
docs/gimprc-1.3.5.in
View File

@ -1,499 +0,0 @@
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" This manpage is Copyright (C) 1999 Austin Donnelly <austin@gimp.org>
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the gimp is constantly changing, this manual page may be
.\" incorrect or out-of-date. The author(s) assume no responsibility
.\" for errors or omissions, or for damages resulting from the use of
.\" the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Sun Feb 7 22:22:38 GMT 1999 Austin Donnelly <austin@gimp.org>
.\" * initial revision
.\"
.\" Sat Feb 13 23:47:36 GMT 1999 Austin Donnelly <austin@gimp.org>
.\" * added section on path expansion, and renamed to gimprc.5.in
.\"
.\" Wed Mar 3 13:09:52 MET 1999 Sven Neumann <sven@gimp.org>
.\" * reflect the changes that were made to the resolution stuff
.\"
.\" Thu Oct 12 20:14:36 PDT 2000 Ben Gertzfield <che@debian.org>
.\" * Move gimprc to gimpsysconfdir, make FILES section reflect this
.\" * Removed .gimp-1.1 hard ref, replace with gimpdir
.\"
.TH GIMPRC 5 "14 Oct 2000" "Version @GIMP_VERSION@" "GIMP Manual Pages"
.SH NAME
gimprc \- gimp configuration file
.SH DESCRIPTION
The
.B gimprc
file is a configuation file read by the gimp when it starts up. There
are two of these: one system-wide one stored in
@gimpsysconfdir@/gimprc and a per-user \fB$HOME\fP/@gimpdir@/gimprc
which may override system settings.
Comments are introduced by a hash sign (#), and continue until the
end of the line. Blank lines are ignored.
The
.B gimprc
file associates values with properties. These properties may be set
by lisp-like assignments of the form:
.IP
\f3(\f2property-name\ \ \ value\f3)\f1
.TP
where:
.TP 10
.I property-name
is one of the property names described below.
.TP
.I value
is the value the property is to be set to.
.PP
Either spaces or tabs may be used to separate the name from the value.
The values have an associated type, described below:
.TP
.I STRING
A sequence of characters surrounded by double-quotes ("). A backslash
(\\) may be used to escape either double-quote or itself to generate a
literal double-quote or a literal backslash.
.TP
.I PATH
Same as STRING, but path-expansion (see below) is also performed.
.TP
.I DOUBLE
An optional minus sign (-) followed by zero or more decimal digits,
and optionally a decimal-point (.) followed by zero or more decimal
digits.
.TP
.I FLOAT
Same as DOUBLE.
.TP
.I INT
Same as DOUBLE, except the value is rounded to the next lowest integer.
.TP
.I BOOLEAN
One of
.BR true ", " on ", " yes ", "
.BR false ", " off ", or " no "."
Alternatively, the empty string is interpreted to mean
.BR true "."
.TP
.I POSITION
Same as two INTs separated by whitespace.
.TP
.I MEMSIZE
An INT followed by a size specifier. A size specifier is one of
.BR m ", " M ", "
.BR k ", " K ", "
.BR b ", or " B "."
The size specified may be omitted, in which case it defaults to
.BR k "."
.TP
.I IMAGETYPE
One of
.BR rgb ", " grey ", or " gray "."
.TP
.I COLORCUBE
Four whitespace separated INTs, giving the number of shades of red,
green, blue and grey (respectively) in the color cube.
.TP
.I PREVIEWSIZE
One of
.BR none ", "tiny ", " small ", " medium ", "large " or " huge ", "
or an INT. tiny is 24x24, small is 32x32, medium is 48x48,
large is 64x64 and huge is 128x128.
.TP
.I UNIT
One of
.BR inches ", " millimeters ", " picas ", or " points
or the identifier of one of the units you have defined in your user
units database.
.PP
.SH PROPERTIES
Valid properties and their types:
.TP
.I temp-path PATH
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 or is cleared on machine
reboot such as /tmp.
.TP
.I swap-path PATH
Set the swap file location. The gimp uses a tile based memory
allocation scheme. The swap file is used to quickly and easily
swap tiles 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 mounted over NFS. For these reasons, it may
be desirable to put your swap file in "/tmp".
.TP
.I brush-path PATH
Set the brush search path. This is a colon-separated list of
directories to be searched for brushes.
.TP
.I pattern-path PATH
Set the pattern search path. This is a colon-separated list of
directories to be searched for patterns.
.TP
.I plug-in-path PATH
Set the plug-in search path. This is a colon-separated list of
directories which will be scanned at startup to register new plugins.
.TP
.I palette-path PATH
Set the palette search path. This is a colon-separated list of
directories to be searched for palettes.
.TP
.I gradient-path PATH
Set the gradient search path. This is a colon-separated list of
directories to be searched for gradients.
.TP
.I module-path PATH
Set the module search path. This is a colon-separated list of
directories which will be scanned at startup for modules to be loaded.
.TP
.I default-brush STRING
Specify a default brush. This doesn't actually do anything any more,
since the default brush is set as part of the saved device status.
.TP
.I default-pattern STRING
Specify a default pattern. The pattern is searched for in the
specified pattern path.
.TP
.I default-palette STRING
Specify a default palette. The palette is searched for in the
specified palette path.
.TP
.I default-gradient STRING
Specify a default gradient. The gradient is searched for in the
specified gradient path.
.TP
.I gamma-correction DOUBLE
Set the gamma correction value 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. XXX is this valid info? 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 setting the value to 1.0.
.TP
.I color-cube COLORCUBE
Set the displays color cube. No longer used in gimp-1.2.x since the
introduction of GdkRgb.
.TP
.I install-colormap BOOLEAN
Install a private colormap by default - not actually used anymore since
the introduction of GdkRgb.
.TP
.I tile-cache-size MEMSIZE
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.
.TP
.I marching-ants-speed INT
Speed of marching ants in the selection outline. This value is in
milliseconds (less time indicates faster marching).
.TP
.I last-opened-size INT
How many recently opened image filenames to keep on the File menu.
.TP
.I undo-levels INT
Set the number of operations kept on the undo stack.
.TP
.I transparency-type INT
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, or 5 - Black Only.
.TP
.I transparency-size INT
Check size can be one of 0 - Small, 1 - Medium, or 2 - Large
.TP
.I perfect-mouse BOOLEAN
If set to true, the X server is queried for the mouse's current
position on each motion event, rather than relying on the position
hint. This means painting with large brushes should be more accurate,
but it may be slower. Perversely, on some X servers turning on this
option results in faster painting.
.TP
.I colormap-cycling BOOLEAN
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.
.TP
.I default-threshold INT
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.
.TP
.I stingy-memory-use BOOLEAN
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.
.TP
.I resize-windows-on-zoom BOOLEAN
When zooming into and out of images, this option enables the automatic
resizing of windows.
.TP
.I dont-resize-windows-on-zoom BOOLEAN
Negated version of resize-windows-on-zoom.
.TP
.I resize-windows-on-resize BOOLEAN
When the physical image size changes, this option enables the automatic
resizing of windows.
.TP
.I dont-resize-windows-on-zoom BOOLEAN
Negated version of resize-windows-on-resize.
.TP
.I cursor-updating BOOLEAN
Context-dependent cursors are cool. They are enabled by default.
However, they require overhead that you may want to do without.
.TP
.I no-cursor-updating BOOLEAN
Negated version of cursor-updating.
.TP
.I preview-size PREVIEWSIZE
Set the layer preview size.
.TP
.I show-rulers BOOLEAN
Set the 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.
.TP
.I dont-show-rulers BOOLEAN
Negated version of show-rulers.
.TP
.I show-statusbar BOOLEAN
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.
.TP
.I dont-show-statusbar BOOLEAN
Negated version of show-statusbar.
.TP
.I auto-save BOOLEAN
Auto saving is not yet implemented! Nothing will be auto-saved, no
matter how you set this.
.TP
.I dont-auto-save BOOLEAN
Negated version of auto-save.
.TP
.I cubic-interpolation BOOLEAN
Set the level of interpolation. If set, this option enables cubic
interpolation when scaling or transforming. By default, GIMP uses
linear interpolation, which is faster, but has poorer quality.
.TP
.I confirm-on-close BOOLEAN
Ask for confirmation before closing an image without saving. This is
the default.
.TP
.I dont-confirm-on-close BOOLEAN
Negated version of confirm-on-close.
.TP
.I save-session-info BOOLEAN
Remember the positions and sizes of the main dialogs and asks your
window-manager to place them there again the next time you use the
GIMP.
.TP
.I dont-save-session-info BOOLEAN
Negated version of save-session-info.
.TP
.I save-device-status BOOLEAN
Remember the current tool, pattern, color, and brush across GIMP
sessions.
.TP
.I dont-save-device-status BOOLEAN
Negated version of save-device-status.
.TP
.I always-restore-session BOOLEAN
Let GIMP try to restore your last saved session.
.TP
.I show-tips BOOLEAN
Set to display a handy GIMP tip on startup.
.TP
.I dont-show-tips BOOLEAN
Negated version of show-tips.
.TP
.I show-tool-tips BOOLEAN
Set to display tooltips in the toolbox.
.TP
.I dont-show-tool-tips BOOLEAN
Negated version of show-tool-tips.
.TP
.I default-image-size POSITION
Set the default image size in the File/New dialog.
.TP
.I default-image-type IMAGETYPE
Set the default image type in the File/New dialog.
.TP
.I default-units UNIT
Set the default units for new images and for the File/New dialog.
This units will be used for coordinate display when not in dot-for-dot
mode. The default units can be one of inches , millimeters, points or
picas or the identifier of one of the units defined in your user units
database. The default is inches.
.TP
.I default-xresolution FLOAT
Set the default horizontal resolution for new images and for the
File/New dialog. This value is always in dpi (dots per inch).
.TP
.I default-yresolution FLOAT
Set the default vertical resolution for new images and for the
File/New dialog. This value is always in dpi (dots per inch).
.TP
.I default-resolution-units UNIT
Set the units for the display of the default resolution in the
File/New dialog. The default resolution units can be one of inches,
millimeters, points or picas or the identifier of one of the units
defined in your user unit database. The default is inches.
.TP
.I monitor-xresolution FLOAT
Set the monitor's horizontal resolution, in dots per inch. If set to
0, forces the X server to be queried for both horizontal and vertical
resolution information.
.TP
.I monitor-yresolution FLOAT
Set the monitor's vertical resolution, in dots per inch. If set to
0, forces the X server to be queried for both horizontal and vertical
resolution information.
.TP
.I num-processors INT
On multiprocessor machines, if GIMP has been compiled with --enable-mp
this sets how many processors GIMP should use simultaneously.
.TP
.I image-title-format STRING
Set the text to appear in image window titles. Certain % character
sequences are recognised and expanded as follows:
%% literal percent sign
.br
%f bare filename, or "Untitled"
.br
%F full path to file, or "Untitled"
.br
%p PDB image id
.br
%i view instance number
.br
%t image type (RGB, indexed, greyscale)
.br
%z zoom factor as a percentage
.br
%s source scale factor
.br
%d destination scale factor
.br
%Dx expands to x if the image is dirty, the empty string
otherwise. The x can be any character, eg %D*.
.br
%Cx expands to x if the image is clean, the empty string
otherwise. The x can be any character, eg %Co.
.br
%m memory used by the image
.br
%l the number of layers
.br
%L the name of the active layer/channel
.br
%w image width in pixels
.br
%W image width in real-world units
.br
%h image height in pixels
.br
%H image height in real-world units
.br
%u unit symbol
.br
%U unit abbreviation
The default title format string is "%f-%p.%i (%t)".
.TP
.I image-status-format STRING
Set the text to appear in image window status bars. See image-title-format
for the list of possible % sequences.
The default status format string is "%f-%p.%i (%t)".
.PP
.SH PATH EXPANSION
Strings of type PATH are expanded in a manner similar to
.BR bash (1).
Specifically: tilde (~) is expanded to the user's home directory, and
${variable} is expanded to the current value of the variable. Note
that the bash feature of being able to refer to other user's home
directories by writing ~userid/ is not valid in this file.
The only variable initially defined is
.I gimp_dir
, which is set to either the interned value
.B @gimpdir@
or the environment variable GIMP_DIRECTORY. If the path in
GIMP_DIRECTORY is relative, it is considered relative to your home
directory. The same variable expansion syntax can be used to refer to
environment variables. New variables may be defined so long as their
name does not shadow one of the property names given in the previous
section. Variables are set using the following syntax:
.IP
\f3(\f2variable-name\ \ \ PATH\f3)\f1
.PP
Note that the right hand side of this assignment is itself path
expanded before setting the value of the variable.
Typically, the system-wide gimprc file will set a few convenience
variables:
.TP
.I prefix
The installation prefix for this build, @prefix@.
.TP
.I exec_prefix
The path to architecture-specific executables, @exec_prefix@.
.TP
.I gimp_data_dir
Path to sharable data, @gimpdatadir@.
.TP
.I gimp_plugin_dir
Base for paths to architecture-specific plugins and modules,
@gimpplugindir@.
.PP
.SH FILES
.TP
.I @gimpsysconfdir@/gimprc
System-wide configuration file
.TP
.I $HOME/@gimpdir@/gimprc
Per-user configuration file
.SH "SEE ALSO"
.BR gimp (1),
.BR gimptool (1),
.BR gimp-remote (1)

499
docs/gimprc.5.in
View File

@ -1,499 +0,0 @@
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" This manpage is Copyright (C) 1999 Austin Donnelly <austin@gimp.org>
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the gimp is constantly changing, this manual page may be
.\" incorrect or out-of-date. The author(s) assume no responsibility
.\" for errors or omissions, or for damages resulting from the use of
.\" the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Sun Feb 7 22:22:38 GMT 1999 Austin Donnelly <austin@gimp.org>
.\" * initial revision
.\"
.\" Sat Feb 13 23:47:36 GMT 1999 Austin Donnelly <austin@gimp.org>
.\" * added section on path expansion, and renamed to gimprc.5.in
.\"
.\" Wed Mar 3 13:09:52 MET 1999 Sven Neumann <sven@gimp.org>
.\" * reflect the changes that were made to the resolution stuff
.\"
.\" Thu Oct 12 20:14:36 PDT 2000 Ben Gertzfield <che@debian.org>
.\" * Move gimprc to gimpsysconfdir, make FILES section reflect this
.\" * Removed .gimp-1.1 hard ref, replace with gimpdir
.\"
.TH GIMPRC 5 "14 Oct 2000" "Version @GIMP_VERSION@" "GIMP Manual Pages"
.SH NAME
gimprc \- gimp configuration file
.SH DESCRIPTION
The
.B gimprc
file is a configuation file read by the gimp when it starts up. There
are two of these: one system-wide one stored in
@gimpsysconfdir@/gimprc and a per-user \fB$HOME\fP/@gimpdir@/gimprc
which may override system settings.
Comments are introduced by a hash sign (#), and continue until the
end of the line. Blank lines are ignored.
The
.B gimprc
file associates values with properties. These properties may be set
by lisp-like assignments of the form:
.IP
\f3(\f2property-name\ \ \ value\f3)\f1
.TP
where:
.TP 10
.I property-name
is one of the property names described below.
.TP
.I value
is the value the property is to be set to.
.PP
Either spaces or tabs may be used to separate the name from the value.
The values have an associated type, described below:
.TP
.I STRING
A sequence of characters surrounded by double-quotes ("). A backslash
(\\) may be used to escape either double-quote or itself to generate a
literal double-quote or a literal backslash.
.TP
.I PATH
Same as STRING, but path-expansion (see below) is also performed.
.TP
.I DOUBLE
An optional minus sign (-) followed by zero or more decimal digits,
and optionally a decimal-point (.) followed by zero or more decimal
digits.
.TP
.I FLOAT
Same as DOUBLE.
.TP
.I INT
Same as DOUBLE, except the value is rounded to the next lowest integer.
.TP
.I BOOLEAN
One of
.BR true ", " on ", " yes ", "
.BR false ", " off ", or " no "."
Alternatively, the empty string is interpreted to mean
.BR true "."
.TP
.I POSITION
Same as two INTs separated by whitespace.
.TP
.I MEMSIZE
An INT followed by a size specifier. A size specifier is one of
.BR m ", " M ", "
.BR k ", " K ", "
.BR b ", or " B "."
The size specified may be omitted, in which case it defaults to
.BR k "."
.TP
.I IMAGETYPE
One of
.BR rgb ", " grey ", or " gray "."
.TP
.I COLORCUBE
Four whitespace separated INTs, giving the number of shades of red,
green, blue and grey (respectively) in the color cube.
.TP
.I PREVIEWSIZE
One of
.BR none ", "tiny ", " small ", " medium ", "large " or " huge ", "
or an INT. tiny is 24x24, small is 32x32, medium is 48x48,
large is 64x64 and huge is 128x128.
.TP
.I UNIT
One of
.BR inches ", " millimeters ", " picas ", or " points
or the identifier of one of the units you have defined in your user
units database.
.PP
.SH PROPERTIES
Valid properties and their types:
.TP
.I temp-path PATH
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 or is cleared on machine
reboot such as /tmp.
.TP
.I swap-path PATH
Set the swap file location. The gimp uses a tile based memory
allocation scheme. The swap file is used to quickly and easily
swap tiles 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 mounted over NFS. For these reasons, it may
be desirable to put your swap file in "/tmp".
.TP
.I brush-path PATH
Set the brush search path. This is a colon-separated list of
directories to be searched for brushes.
.TP
.I pattern-path PATH
Set the pattern search path. This is a colon-separated list of
directories to be searched for patterns.
.TP
.I plug-in-path PATH
Set the plug-in search path. This is a colon-separated list of
directories which will be scanned at startup to register new plugins.
.TP
.I palette-path PATH
Set the palette search path. This is a colon-separated list of
directories to be searched for palettes.
.TP
.I gradient-path PATH
Set the gradient search path. This is a colon-separated list of
directories to be searched for gradients.
.TP
.I module-path PATH
Set the module search path. This is a colon-separated list of
directories which will be scanned at startup for modules to be loaded.
.TP
.I default-brush STRING
Specify a default brush. This doesn't actually do anything any more,
since the default brush is set as part of the saved device status.
.TP
.I default-pattern STRING
Specify a default pattern. The pattern is searched for in the
specified pattern path.
.TP
.I default-palette STRING
Specify a default palette. The palette is searched for in the
specified palette path.
.TP
.I default-gradient STRING
Specify a default gradient. The gradient is searched for in the
specified gradient path.
.TP
.I gamma-correction DOUBLE
Set the gamma correction value 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. XXX is this valid info? 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 setting the value to 1.0.
.TP
.I color-cube COLORCUBE
Set the displays color cube. No longer used in gimp-1.2.x since the
introduction of GdkRgb.
.TP
.I install-colormap BOOLEAN
Install a private colormap by default - not actually used anymore since
the introduction of GdkRgb.
.TP
.I tile-cache-size MEMSIZE
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.
.TP
.I marching-ants-speed INT
Speed of marching ants in the selection outline. This value is in
milliseconds (less time indicates faster marching).
.TP
.I last-opened-size INT
How many recently opened image filenames to keep on the File menu.
.TP
.I undo-levels INT
Set the number of operations kept on the undo stack.
.TP
.I transparency-type INT
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, or 5 - Black Only.
.TP
.I transparency-size INT
Check size can be one of 0 - Small, 1 - Medium, or 2 - Large
.TP
.I perfect-mouse BOOLEAN
If set to true, the X server is queried for the mouse's current
position on each motion event, rather than relying on the position
hint. This means painting with large brushes should be more accurate,
but it may be slower. Perversely, on some X servers turning on this
option results in faster painting.
.TP
.I colormap-cycling BOOLEAN
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.
.TP
.I default-threshold INT
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.
.TP
.I stingy-memory-use BOOLEAN
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.
.TP
.I resize-windows-on-zoom BOOLEAN
When zooming into and out of images, this option enables the automatic
resizing of windows.
.TP
.I dont-resize-windows-on-zoom BOOLEAN
Negated version of resize-windows-on-zoom.
.TP
.I resize-windows-on-resize BOOLEAN
When the physical image size changes, this option enables the automatic
resizing of windows.
.TP
.I dont-resize-windows-on-zoom BOOLEAN
Negated version of resize-windows-on-resize.
.TP
.I cursor-updating BOOLEAN
Context-dependent cursors are cool. They are enabled by default.
However, they require overhead that you may want to do without.
.TP
.I no-cursor-updating BOOLEAN
Negated version of cursor-updating.
.TP
.I preview-size PREVIEWSIZE
Set the layer preview size.
.TP
.I show-rulers BOOLEAN
Set the 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.
.TP
.I dont-show-rulers BOOLEAN
Negated version of show-rulers.
.TP
.I show-statusbar BOOLEAN
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.
.TP
.I dont-show-statusbar BOOLEAN
Negated version of show-statusbar.
.TP
.I auto-save BOOLEAN
Auto saving is not yet implemented! Nothing will be auto-saved, no
matter how you set this.
.TP
.I dont-auto-save BOOLEAN
Negated version of auto-save.
.TP
.I cubic-interpolation BOOLEAN
Set the level of interpolation. If set, this option enables cubic
interpolation when scaling or transforming. By default, GIMP uses
linear interpolation, which is faster, but has poorer quality.
.TP
.I confirm-on-close BOOLEAN
Ask for confirmation before closing an image without saving. This is
the default.
.TP
.I dont-confirm-on-close BOOLEAN
Negated version of confirm-on-close.
.TP
.I save-session-info BOOLEAN
Remember the positions and sizes of the main dialogs and asks your
window-manager to place them there again the next time you use the
GIMP.
.TP
.I dont-save-session-info BOOLEAN
Negated version of save-session-info.
.TP
.I save-device-status BOOLEAN
Remember the current tool, pattern, color, and brush across GIMP
sessions.
.TP
.I dont-save-device-status BOOLEAN
Negated version of save-device-status.
.TP
.I always-restore-session BOOLEAN
Let GIMP try to restore your last saved session.
.TP
.I show-tips BOOLEAN
Set to display a handy GIMP tip on startup.
.TP
.I dont-show-tips BOOLEAN
Negated version of show-tips.
.TP
.I show-tool-tips BOOLEAN
Set to display tooltips in the toolbox.
.TP
.I dont-show-tool-tips BOOLEAN
Negated version of show-tool-tips.
.TP
.I default-image-size POSITION
Set the default image size in the File/New dialog.
.TP
.I default-image-type IMAGETYPE
Set the default image type in the File/New dialog.
.TP
.I default-units UNIT
Set the default units for new images and for the File/New dialog.
This units will be used for coordinate display when not in dot-for-dot
mode. The default units can be one of inches , millimeters, points or
picas or the identifier of one of the units defined in your user units
database. The default is inches.
.TP
.I default-xresolution FLOAT
Set the default horizontal resolution for new images and for the
File/New dialog. This value is always in dpi (dots per inch).
.TP
.I default-yresolution FLOAT
Set the default vertical resolution for new images and for the
File/New dialog. This value is always in dpi (dots per inch).
.TP
.I default-resolution-units UNIT
Set the units for the display of the default resolution in the
File/New dialog. The default resolution units can be one of inches,
millimeters, points or picas or the identifier of one of the units
defined in your user unit database. The default is inches.
.TP
.I monitor-xresolution FLOAT
Set the monitor's horizontal resolution, in dots per inch. If set to
0, forces the X server to be queried for both horizontal and vertical
resolution information.
.TP
.I monitor-yresolution FLOAT
Set the monitor's vertical resolution, in dots per inch. If set to
0, forces the X server to be queried for both horizontal and vertical
resolution information.
.TP
.I num-processors INT
On multiprocessor machines, if GIMP has been compiled with --enable-mp
this sets how many processors GIMP should use simultaneously.
.TP
.I image-title-format STRING
Set the text to appear in image window titles. Certain % character
sequences are recognised and expanded as follows:
%% literal percent sign
.br
%f bare filename, or "Untitled"
.br
%F full path to file, or "Untitled"
.br
%p PDB image id
.br
%i view instance number
.br
%t image type (RGB, indexed, greyscale)
.br
%z zoom factor as a percentage
.br
%s source scale factor
.br
%d destination scale factor
.br
%Dx expands to x if the image is dirty, the empty string
otherwise. The x can be any character, eg %D*.
.br
%Cx expands to x if the image is clean, the empty string
otherwise. The x can be any character, eg %Co.
.br
%m memory used by the image
.br
%l the number of layers
.br
%L the name of the active layer/channel
.br
%w image width in pixels
.br
%W image width in real-world units
.br
%h image height in pixels
.br
%H image height in real-world units
.br
%u unit symbol
.br
%U unit abbreviation
The default title format string is "%f-%p.%i (%t)".
.TP
.I image-status-format STRING
Set the text to appear in image window status bars. See image-title-format
for the list of possible % sequences.
The default status format string is "%f-%p.%i (%t)".
.PP
.SH PATH EXPANSION
Strings of type PATH are expanded in a manner similar to
.BR bash (1).
Specifically: tilde (~) is expanded to the user's home directory, and
${variable} is expanded to the current value of the variable. Note
that the bash feature of being able to refer to other user's home
directories by writing ~userid/ is not valid in this file.
The only variable initially defined is
.I gimp_dir
, which is set to either the interned value
.B @gimpdir@
or the environment variable GIMP_DIRECTORY. If the path in
GIMP_DIRECTORY is relative, it is considered relative to your home
directory. The same variable expansion syntax can be used to refer to
environment variables. New variables may be defined so long as their
name does not shadow one of the property names given in the previous
section. Variables are set using the following syntax:
.IP
\f3(\f2variable-name\ \ \ PATH\f3)\f1
.PP
Note that the right hand side of this assignment is itself path
expanded before setting the value of the variable.
Typically, the system-wide gimprc file will set a few convenience
variables:
.TP
.I prefix
The installation prefix for this build, @prefix@.
.TP
.I exec_prefix
The path to architecture-specific executables, @exec_prefix@.
.TP
.I gimp_data_dir
Path to sharable data, @gimpdatadir@.
.TP
.I gimp_plugin_dir
Base for paths to architecture-specific plugins and modules,
@gimpplugindir@.
.PP
.SH FILES
.TP
.I @gimpsysconfdir@/gimprc
System-wide configuration file
.TP
.I $HOME/@gimpdir@/gimprc
Per-user configuration file
.SH "SEE ALSO"
.BR gimp (1),
.BR gimptool (1),
.BR gimp-remote (1)

15
libgimpconfig/gimpconfig-serialize.c
View File

@ -438,6 +438,17 @@ gimp_config_serialize_unknown_tokens (GObject *object,
return (write (fd, str->str, str->len) != -1);
}
#define LINE_LENGTH 75
/**
* gimp_config_serialize_comment:
* @str: a #GString.
* @comment: the comment to serialize
*
* Appends the @comment to @str and inserts linebreaks and hash-marks to
* format it as a comment.
**/
void
gimp_config_serialize_comment (GString *str,
const gchar *comment)
@ -450,14 +461,14 @@ gimp_config_serialize_comment (GString *str,
while (len > 0)
{
for (s = comment, i = 0, space = 0;
*s != '\n' && (i <= 76 || space == 0) && i < len;
*s != '\n' && (i <= LINE_LENGTH || space == 0) && i < len;
s++, i++)
{
if (g_ascii_isspace (*s))
space = i;
}
if (i > 76 && space && *s != '\n')
if (i > LINE_LENGTH && space && *s != '\n')
i = space;
g_string_append_len (str, "# ", 2);