dallasgroot/Gimp
dallasgroot/Gimp
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs, etc: regenerate the default gimprc and its manpage

Browse source
This commit is contained in:
Michael Natterer 2020-10-25 19:15:58 +01:00
parent fa37ca9aa0
commit 12cf70596d
2 changed files with 231 additions and 54 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

153
docs/gimprc.5.in
View file

@ -36,7 +36,7 @@ Either spaces or tabs may be used to separate the name from the value.
Valid properties and their default values are:
.TP
(temp-path "${gimp_dir}/tmp")
(temp-path "${gimp_temp_dir}")
Sets the folder for temporary storage. Files will appear here during the
course of running GIMP. Most files will disappear when GIMP exits, but some
@ -44,7 +44,7 @@ files are likely to remain, so it is best if this folder not be one that is
shared by other users. This is a single folder.
.TP
(swap-path "${gimp_dir}")
(swap-path "${gimp_cache_dir}")
Sets the swap file location. GIMP uses a tile based memory allocation scheme.
The swap file is used to quickly and easily swap tiles out to disk and back
@ -53,6 +53,12 @@ large images. Also, things can get horribly slow if the swap file is created
on a folder 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
(swap-compression "fast")
The compression method used for tile data stored in the swap file. This is a
string value.
.TP
(num-processors 1)
@ -286,8 +292,8 @@ are yes and no.
(width 2001)
(height 1984)
(unit pixels)
(xresolution 300.000000)
(yresolution 300.000000)
(xresolution 300)
(yresolution 300)
(resolution-unit inches)
(image-type rgb)
(precision u8-non-linear)
@ -300,13 +306,13 @@ Sets the default image in the "File/New" dialog. This is a parameter list.
.TP
(default-grid
(style solid)
(fgcolor (color-rgba 0.000000 0.000000 0.000000 1.000000))
(bgcolor (color-rgba 1.000000 1.000000 1.000000 1.000000))
(xspacing 10.000000)
(yspacing 10.000000)
(fgcolor (color-rgba 0 0 0 1))
(bgcolor (color-rgba 1 1 1 1))
(xspacing 10)
(yspacing 10)
(spacing-unit inches)
(xoffset 0.000000)
(yoffset 0.000000)
(xoffset 0)
(yoffset 0)
(offset-unit inches))
Specify a default image grid. This is a parameter list.
@ -392,7 +398,7 @@ is specified the size defaults to being specified in kilobytes.
(simulation-use-black-point-compensation no)
(simulation-optimize yes)
(simulation-gamut-check no)
(out-of-gamut-color (color-rgb 1.000000 0.000000 1.000000)))
(out-of-gamut-color (color-rgb 1 0 1)))
Defines the color management behavior. This is a parameter list.
@ -403,7 +409,7 @@ Keep a permanent record of all opened and saved files in the Recent Documents
list. Possible values are yes and no.
.TP
(quick-mask-color (color-rgba 1.000000 0.000000 0.000000 0.500000))
(quick-mask-color (color-rgba 1 0 0 0.5))
Sets the default quick mask color. The color is specified in the form
(color-rgba red green blue alpha) with channel values as floats in the range
@ -434,11 +440,22 @@ yes and no.
Which plug-in to use for importing raw digital camera files. This is a single
filename.
.TP
(export-file-type png)
Export file type used by default. Possible values are png, jpg, ora, psd,
pdf, tif, bmp and webp.
.TP
(export-color-profile yes)
Export the image's color profile by default. Possible values are yes and no.
.TP
(export-comment yes)
Export the image's comment by default. Possible values are yes and no.
.TP
(export-metadata-exif yes)
@ -460,6 +477,37 @@ Export IPTC metadata by default. Possible values are yes and no.
Try generating debug data for bug reporting when appropriate. Possible values
are warning, critical, fatal and never.
.TP
(check-updates yes)
Check for availability of GIMP updates through background internet queries.
Possible values are yes and no.
.TP
(check-update-timestamp 0)
Timestamp of the last update check. (null)
.TP
(last-release-timestamp 0)
The timestamp for the last known release date. (null)
.TP
The last known release version of GIMP as queried from official website. This
is a string value.
.TP
(last-revision 0)
The timestamp for the last known release date. This is an integer value.
.TP
The last known release version of GIMP as queried from official website. This
is a string value.
.TP
(transparency-size medium-checks)
@ -499,6 +547,11 @@ When enabled, the image window will automatically resize itself whenever the
physical image size changes. This setting only takes effect in multi-window
mode. Possible values are yes and no.
.TP
(default-show-all no)
Show full image content by default. Possible values are yes and no.
.TP
(default-dot-for-dot yes)
@ -531,6 +584,12 @@ values are yes and no.
When enabled, all paint tools will show a preview of the current brush's
outline. Possible values are yes and no.
.TP
(snap-brush-outline no)
When enabled, the brush outline will snap to individual dabs while painting.
Possible values are yes and no.
.TP
(show-paint-tool-cursor yes)
@ -688,14 +747,14 @@ certain % character sequences are recognised and expanded as follows:
.br
.TP
(monitor-xresolution 96.000000)
(monitor-xresolution 96)
Sets 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 96.000000)
(monitor-yresolution 96)
Sets 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
@ -722,6 +781,7 @@ large, extra-large, huge, enormous and gigantic.
(show-scrollbars yes)
(show-selection yes)
(show-layer-boundary yes)
(show-canvas-boundary yes)
(show-guides yes)
(show-grid no)
(show-sample-points yes)
@ -730,7 +790,8 @@ large, extra-large, huge, enormous and gigantic.
(snap-to-canvas no)
(snap-to-path no)
(padding-mode default)
(padding-color (color-rgb 1.000000 1.000000 1.000000)))
(padding-color (color-rgb 1 1 1))
(padding-in-show-all no))
Sets the default settings for the image view. This is a parameter list.
@ -742,6 +803,7 @@ Sets the default settings for the image view. This is a parameter list.
(show-scrollbars yes)
(show-selection yes)
(show-layer-boundary yes)
(show-canvas-boundary yes)
(show-guides yes)
(show-grid no)
(show-sample-points yes)
@ -750,7 +812,8 @@ Sets the default settings for the image view. This is a parameter list.
(snap-to-canvas no)
(snap-to-path no)
(padding-mode default)
(padding-color (color-rgb 1.000000 1.000000 1.000000)))
(padding-color (color-rgb 1 1 1))
(padding-in-show-all no))
Sets the default settings used when an image is viewed in fullscreen mode.
This is a parameter list.
@ -780,6 +843,12 @@ Possible values are low and high.
Bugs in event history buffer are frequent so in case of cursor offset problems
turning it off helps. Possible values are yes and no.
.TP
(edit-non-visible no)
When enabled, non-visible layers can be edited as normal. Possible values are
yes and no.
.TP
(move-tool-changes-active no)
@ -905,6 +974,12 @@ no.
Show the GIMP mascot at the top of the toolbox. Possible values are yes and
no.
.TP
(toolbox-groups yes)
Use a single toolbox button for grouped tools. Possible values are yes and
no.
.TP
(theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
@ -1015,7 +1090,13 @@ Enable the Seamless Clone tool. Possible values are yes and no.
(color-profile-policy ask)
How to handle embedded color profiles when opening a file. Possible values
are ask, keep and convert.
are ask, keep, convert-builtin and convert-preferred.
.TP
(metadata-rotation-policy ask)
How to handle "Orientation" metadata when opening a file. Possible values are
ask, keep and rotate.
.TP
@ -1153,7 +1234,7 @@ Sets the default composite mode for the 'New Layer' dialog. Possible values
are auto, union, clip-to-backdrop, clip-to-layer and intersection.
.TP
(layer-new-opacity 1.000000)
(layer-new-opacity 1)
Sets the default opacity for the 'New Layer' dialog. This is a float value.
@ -1207,7 +1288,7 @@ Sets the default channel name for the 'New Channel' dialog. This is a string
value.
.TP
(channel-new-color (color-rgba 0.000000 0.000000 0.000000 0.500000))
(channel-new-color (color-rgba 0 0 0 0.5))
Sets the default color and opacity for the 'New Channel' dialog. The color is
specified in the form (color-rgba red green blue alpha) with channel values as
@ -1247,19 +1328,25 @@ Sets the default 'Scale imported paths to fit size' state for the 'Import
Path' dialog. Possible values are yes and no.
.TP
(selection-feather-radius 5.000000)
(selection-feather-radius 5)
Sets the default feather radius for the 'Feather Selection' dialog. This is a
float value.
.TP
(selection-grow-radius 1.000000)
(selection-feather-edge-lock yes)
Sets the default 'Selected areas continue outside the image' setting for the
\&'Feather Selection' dialog. Possible values are yes and no.
.TP
(selection-grow-radius 1)
Sets the default grow radius for the 'Grow Selection' dialog. This is a float
value.
.TP
(selection-shrink-radius 1.000000)
(selection-shrink-radius 1)
Sets the default shrink radius for the 'Shrink Selection' dialog. This is a
float value.
@ -1271,7 +1358,7 @@ Sets the default 'Selected areas continue outside the image' setting for the
\&'Shrink Selection' dialog. Possible values are yes and no.
.TP
(selection-border-radius 5.000000)
(selection-border-radius 5)
Sets the default border radius for the 'Border Selection' dialog. This is a
float value.
@ -1291,7 +1378,9 @@ Sets the default 'Selected areas continue outside the image' setting for the
.TP
(fill-options
(style solid)
(antialias yes))
(antialias yes)
(feather no)
(feather-radius 10))
The default fill options for the fill dialogs. This is a parameter list.
@ -1299,13 +1388,15 @@ The default fill options for the fill dialogs. This is a parameter list.
(stroke-options
(style solid)
(antialias yes)
(feather no)
(feather-radius 10)
(method line)
(width 6.000000)
(width 6)
(unit pixels)
(cap-style butt)
(join-style miter)
(miter-limit 10.000000)
(dash-offset 0.000000)
(miter-limit 10)
(dash-offset 0)
(dash-info 0)
(emulate-brush-dynamics no))
@ -1370,6 +1461,14 @@ compiled-in default value @gimpplugindir@.
Path to configuration files, which is set to the value of the environment
variable GIMP3_SYSCONFDIR or to the compiled-in default value
@gimpsysconfdir@.
.TP
.I gimp_cache_dir
Path to cached files, which is set to the value of the environment
variable GIMP3_CACHEDIR or to the system default for per-user cached files.
.TP
.I gimp_temp_dir
Path to temporary files, which is set to the value of the environment
variable GIMP3_TEMPDIR or to the system default for temporary files.
.SH FILES
.TP

132
etc/gimprc.in
View file

@ -17,7 +17,7 @@
# some files are likely to remain, so it is best if this folder not be one
# that is shared by other users. This is a single folder.
#
# (temp-path "${gimp_dir}/tmp")
# (temp-path "${gimp_temp_dir}")
# Sets the swap file location. GIMP uses a tile based memory allocation
# scheme. The swap file is used to quickly and easily swap tiles out to disk
@ -27,7 +27,12 @@
# it may be desirable to put your swap file in "/tmp". This is a single
# folder.
#
# (swap-path "${gimp_dir}")
# (swap-path "${gimp_cache_dir}")
# The compression method used for tile data stored in the swap file. This is
# a string value.
#
# (swap-compression "fast")
# Sets how many threads GIMP should use for operations that support it. This
# is an integer value.
@ -226,8 +231,8 @@
# (width 2001)
# (height 1984)
# (unit pixels)
# (xresolution 300.000000)
# (yresolution 300.000000)
# (xresolution 300)
# (yresolution 300)
# (resolution-unit inches)
# (image-type rgb)
# (precision u8-non-linear)
@ -239,13 +244,13 @@
#
# (default-grid
# (style solid)
# (fgcolor (color-rgba 0.000000 0.000000 0.000000 1.000000))
# (bgcolor (color-rgba 1.000000 1.000000 1.000000 1.000000))
# (xspacing 10.000000)
# (yspacing 10.000000)
# (fgcolor (color-rgba 0 0 0 1))
# (bgcolor (color-rgba 1 1 1 1))
# (xspacing 10)
# (yspacing 10)
# (spacing-unit inches)
# (xoffset 0.000000)
# (yoffset 0.000000)
# (xoffset 0)
# (yoffset 0)
# (offset-unit inches))
# Sets the minimal number of operations that can be undone. More undo levels
@ -321,7 +326,7 @@
# (simulation-use-black-point-compensation no)
# (simulation-optimize yes)
# (simulation-gamut-check no)
# (out-of-gamut-color (color-rgb 1.000000 0.000000 1.000000)))
# (out-of-gamut-color (color-rgb 1 0 1)))
# Keep a permanent record of all opened and saved files in the Recent
# Documents list. Possible values are yes and no.
@ -332,7 +337,7 @@
# (color-rgba red green blue alpha) with channel values as floats in the
# range of 0.0 to 1.0.
#
# (quick-mask-color (color-rgba 1.000000 0.000000 0.000000 0.500000))
# (quick-mask-color (color-rgba 1 0 0 0.5))
# Promote imported images to floating point precision. Does not apply to
# indexed images. Possible values are yes and no.
@ -355,11 +360,20 @@
#
# (import-raw-plug-in "")
# Export file type used by default. Possible values are png, jpg, ora, psd,
# pdf, tif, bmp and webp.
#
# (export-file-type png)
# Export the image's color profile by default. Possible values are yes and
# no.
#
# (export-color-profile yes)
# Export the image's comment by default. Possible values are yes and no.
#
# (export-comment yes)
# Export Exif metadata by default. Possible values are yes and no.
#
# (export-metadata-exif yes)
@ -377,6 +391,33 @@
#
# (debug-policy warning)
# Check for availability of GIMP updates through background internet queries.
# Possible values are yes and no.
#
# (check-updates yes)
# Timestamp of the last update check. (null)
#
# (check-update-timestamp 0)
# The timestamp for the last known release date. (null)
#
# (last-release-timestamp 0)
# The last known release version of GIMP as queried from official website.
# This is a string value.
#
#
# The timestamp for the last known release date. This is an integer value.
#
# (last-revision 0)
# The last known release version of GIMP as queried from official website.
# This is a string value.
#
#
# Sets the size of the checkerboard used to display transparency. Possible
# values are small-checks, medium-checks and large-checks.
#
@ -411,6 +452,10 @@
#
# (resize-windows-on-resize no)
# Show full image content by default. Possible values are yes and no.
#
# (default-show-all no)
# When enabled, this will ensure that each pixel of an image gets mapped to a
# pixel on the screen. Possible values are yes and no.
#
@ -438,6 +483,11 @@
#
# (show-brush-outline yes)
# When enabled, the brush outline will snap to individual dabs while
# painting. Possible values are yes and no.
#
# (snap-brush-outline no)
# When enabled, the mouse pointer will be shown over the image while using a
# paint tool. Possible values are yes and no.
#
@ -526,13 +576,13 @@
# forces the X server to be queried for both horizontal and vertical
# resolution information. This is a float value.
#
# (monitor-xresolution 96.000000)
# (monitor-xresolution 96)
# Sets 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.
#
# (monitor-yresolution 96.000000)
# (monitor-yresolution 96)
# When enabled, GIMP will use the monitor resolution from the windowing
# system. Possible values are yes and no.
@ -554,6 +604,7 @@
# (show-scrollbars yes)
# (show-selection yes)
# (show-layer-boundary yes)
# (show-canvas-boundary yes)
# (show-guides yes)
# (show-grid no)
# (show-sample-points yes)
@ -562,7 +613,8 @@
# (snap-to-canvas no)
# (snap-to-path no)
# (padding-mode default)
# (padding-color (color-rgb 1.000000 1.000000 1.000000)))
# (padding-color (color-rgb 1 1 1))
# (padding-in-show-all no))
# Sets the default settings used when an image is viewed in fullscreen mode.
# This is a parameter list.
@ -574,6 +626,7 @@
# (show-scrollbars yes)
# (show-selection yes)
# (show-layer-boundary yes)
# (show-canvas-boundary yes)
# (show-guides yes)
# (show-grid no)
# (show-sample-points yes)
@ -582,7 +635,8 @@
# (snap-to-canvas no)
# (snap-to-path no)
# (padding-mode default)
# (padding-color (color-rgb 1.000000 1.000000 1.000000)))
# (padding-color (color-rgb 1 1 1))
# (padding-in-show-all no))
# When enabled, an image will become the active image when its image window
# receives the focus. This is useful for window managers using "click to
@ -605,6 +659,11 @@
#
# (use-event-history no)
# When enabled, non-visible layers can be edited as normal. Possible values
# are yes and no.
#
# (edit-non-visible no)
# If enabled, the move tool sets the edited layer or path as active. This
# used to be the default behaviour in older versions. Possible values are
# yes and no.
@ -711,6 +770,11 @@
#
# (toolbox-wilber yes)
# Use a single toolbox button for grouped tools. Possible values are yes and
# no.
#
# (toolbox-groups yes)
# Sets the theme search path. This is a colon-separated list of folders to
# search.
#
@ -801,10 +865,15 @@
# (playground-seamless-clone-tool no)
# How to handle embedded color profiles when opening a file. Possible values
# are ask, keep and convert.
# are ask, keep, convert-builtin and convert-preferred.
#
# (color-profile-policy ask)
# How to handle "Orientation" metadata when opening a file. Possible values
# are ask, keep and rotate.
#
# (metadata-rotation-policy ask)
# Sets the default folder path for all color profile file dialogs. This is a
# single filename.
#
@ -924,7 +993,7 @@
# Sets the default opacity for the 'New Layer' dialog. This is a float
# value.
#
# (layer-new-opacity 1.000000)
# (layer-new-opacity 1)
# Sets the default fill type for the 'New Layer' dialog. Possible values are
# foreground, background, white, transparent and pattern.
@ -971,7 +1040,7 @@
# is specified in the form (color-rgba red green blue alpha) with channel
# values as floats in the range of 0.0 to 1.0.
#
# (channel-new-color (color-rgba 0.000000 0.000000 0.000000 0.500000))
# (channel-new-color (color-rgba 0 0 0 0.5))
# Sets the default path name for the 'New Path' dialog. This is a string
# value.
@ -1006,17 +1075,22 @@
# Sets the default feather radius for the 'Feather Selection' dialog. This
# is a float value.
#
# (selection-feather-radius 5.000000)
# (selection-feather-radius 5)
# Sets the default 'Selected areas continue outside the image' setting for
# the 'Feather Selection' dialog. Possible values are yes and no.
#
# (selection-feather-edge-lock yes)
# Sets the default grow radius for the 'Grow Selection' dialog. This is a
# float value.
#
# (selection-grow-radius 1.000000)
# (selection-grow-radius 1)
# Sets the default shrink radius for the 'Shrink Selection' dialog. This is
# a float value.
#
# (selection-shrink-radius 1.000000)
# (selection-shrink-radius 1)
# Sets the default 'Selected areas continue outside the image' setting for
# the 'Shrink Selection' dialog. Possible values are yes and no.
@ -1026,7 +1100,7 @@
# Sets the default border radius for the 'Border Selection' dialog. This is
# a float value.
#
# (selection-border-radius 5.000000)
# (selection-border-radius 5)
# Sets the default border style for the 'Border Selection' dialog. Possible
# values are hard, smooth and feathered.
@ -1042,7 +1116,9 @@
#
# (fill-options
# (style solid)
# (antialias yes))
# (antialias yes)
# (feather no)
# (feather-radius 10))
# The default stroke options for the stroke dialogs. This is a parameter
# list.
@ -1050,13 +1126,15 @@
# (stroke-options
# (style solid)
# (antialias yes)
# (feather no)
# (feather-radius 10)
# (method line)
# (width 6.000000)
# (width 6)
# (unit pixels)
# (cap-style butt)
# (join-style miter)
# (miter-limit 10.000000)
# (dash-offset 0.000000)
# (miter-limit 10)
# (dash-offset 0)
# (dash-info 0)
# (emulate-brush-dynamics no))