notgne2/tuxpaint-pencil-sharpener
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Refresh manpages after localization wrapper wrapup

Browse source
This commit is contained in:
Bill Kendrick 2021-08-15 01:19:59 -07:00
parent 5f64ebd732
commit ec20799b4a
6 changed files with 943 additions and 816 deletions
Download patch file Download diff file Expand all files Collapse all files

8
docs/CHANGES.txt
View file

@ -8,7 +8,7 @@ http://www.tuxpaint.org/
$Id$ $Id$
2021.August.14 (0.9.27) 2021.August.15 (0.9.27)
* Documentation updates * Documentation updates
--------------------- ---------------------
* Ensured Tux Paint's built-in help ("tuxpaint --help"), * Ensured Tux Paint's built-in help ("tuxpaint --help"),
@ -24,9 +24,9 @@ $Id$
to more closely (but not precisely) match the organization to more closely (but not precisely) match the organization
noted above. noted above.
* WIP - tuxpaint(1) manpage is now managed & translatable * tuxpaint(1) manpage is now managed & translatable via the
via `tuxpaint-docs` project, just like the HTML & plaintext 'tuxpaint-docs' project, just like the HTML & plaintext
documentation files. documentation files (since 0.9.26).
2021.June.28 (0.9.26) 2021.June.28 (0.9.26)
* New Features * New Features

345
man/en/tuxpaint.1
View file

@ -377,22 +377,22 @@ blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
List solid (blank) colors at the end, or beginning (default) of the List solid (blank) colors at the end, or beginning (default) of the options
options displayed when using the \fINew\fP tool to start a new picture. displayed when using the New tool to start a new picture.
.SS CONTROL SIMPLIFICATION .SS CONTROL SIMPLIFICATION
.TP 8 .TP 8
.B \-\-noquit \-\-quit .B \-\-noquit \-\-quit
Disable or enable (default) the on-screen Quit button and [Escape] Disable or enable (default) the on-screen Quit button and [Escape] key for
key for quitting Tux Paint. Instead, use the window close quitting Tux Paint. Instead, use the window close button in the titlebar,
button in the titlebar, the [Al]+[F4] key sequence, or the the [Alt]+[F4] key sequence, or the [Shift]+[Control]+[Escape] key
[Shift]+[Control]+[Escape] key sequence. sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With "--nostamps" set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the Stamps
Stamps tool will not be available. This option can be used to reduce tool will not be available. This option can be used to reduce the time Tux
the time Tux Paint takes to load, and reduce the amount of RAM it requires. Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
.B \-\-nostampcontrols \-\-stampcontrols .B \-\-nostampcontrols \-\-stampcontrols
@ -402,9 +402,9 @@ in all ways.)
.TP 8 .TP 8
.B \-\-nomagiccontrols \-\-magiccontrols .B \-\-nomagiccontrols \-\-magiccontrols
Disable or enable (default) buttons to control Magic tools. Controls include Disable or enable (default) buttons to control Magic tools. Controls
controlling whether a Magic tool is used like a paint brush, or if it include controlling whether a Magic tool is used like a paint brush, or if
affects the entire image at once. (Note: Not all Magic tools will be it affects the entire image at once. (Note: Not all Magic tools will be
controllable.) controllable.)
.TP 8 .TP 8
@ -415,14 +415,14 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the Label tool, which lets you create Disable or enable (default) the Label tool, which lets you create text
text which can be altered or moved later. which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
.l .l
\fItuxpaint\fP accepts the following options to alter how you control \fItuxpaint\fP accepts the following options to alter how you control Tux
Tux Paint. They can be used along with, instead of, or to override options Paint. They can be used along with, instead of, or to override options set
set in configuration files. (See below.) in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
@ -433,14 +433,13 @@ trouble displaying the mouse pointer, and/or leave 'trails' on the screen.
.TP 8 .TP 8
.B \-\-hidecursor \-\-showcursor .B \-\-hidecursor \-\-showcursor
Completely hide, or enable (default) the mouse pointer in Tux Paint. Completely hide, or enable (default) the mouse pointer in Tux Paint. This
This can be useful on touchscreen devices, such as tablet PCs. can be useful on touchscreen devices, such as tablet PCs.
.SS KEYBOARD .SS KEYBOARD
.TP 8 .TP 8
.B \-\-noshortcuts \-\-shortcuts .B \-\-noshortcuts \-\-shortcuts
If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) <? /* --[no]shortcuts */ wordwrap(sprintf(gettext(If \"%s\" mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) will be disabled. Default mode is for shortcuts to be enabled."), "--noshortcuts")) . "\n" ?>
will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
@ -451,10 +450,10 @@ confined to the Tux Paint window. Default is to not grab.
.TP 8 .TP 8
.B \-\-nowheelmouse \-\-wheelmouse .B \-\-nowheelmouse \-\-wheelmouse
By default, the wheel (jog dial) on a mouse will be used to scroll the By default, the wheel (jog dial) on a mouse will be used to scroll the
'selector' on the right of the screen. This can be disabled, and the 'selector' on the right of the screen. This can be disabled, and the wheel
wheel completely ignored, with the \fI\-\-nowheelmouse\fP option. completely ignored, with the "--nowheelmouse" option. This is useful for
This is useful for children who aren't yet comfortable with the mouse. children who aren't yet comfortable with the mouse. Default is to support
Default is to support the wheel. the wheel.
.TP 8 .TP 8
.B \-\-mouse-accessibility .B \-\-mouse-accessibility
@ -463,24 +462,23 @@ you click, move, and click again to end the motion.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The "--keyboard" option lets the mouse pointer in Tux Paint be The "--keyboard" option lets the mouse pointer in Tux Paint be controlled
controlled with the keyboard. The [Up], [Down], [Left], and [Right] with the keyboard. The [Up], [Down], [Left], and [Right] arrow keys move
arrow keys move the pointer. [Spacebar] acts as the mouse button. the pointer. [Spacebar] acts as the mouse button.
.TP 8 .TP 8
.B \-\-nobuttondistinction \-\-buttondistinction .B \-\-nobuttondistinction \-\-buttondistinction
By default, only mouse button #1 (typically the leftmost mouse button By default, only mouse button #1 (typically the leftmost mouse button on
on mice with more than one button) can be used for interacting with mice with more than one button) can be used for interacting with Tux Paint.
Tux Paint. With the "--nobuttondistinction" option, With the "--nobuttondistinction" option, mouse buttons #2 (middle) and #3
mouse buttons #2 (middle) and #3 (right) can be used, as well. (right) can be used, as well. This is useful for children who aren't yet
This is useful for children who aren't yet comfortable with the mouse. comfortable with the mouse. Default is to only recognize button #1.
Default is to only recognize button #1.
.SS ONSCREEN KEYBOARD .SS ONSCREEN KEYBOARD
.TP 8 .TP 8
.B \-\-onscreen-keyboard .B \-\-onscreen-keyboard
Presents a clickable on-screen keyboard when using the Text and Presents a clickable on-screen keyboard when using the Text and Label
Label tools. tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -494,40 +492,49 @@ which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
.B \-\-joystick-dev=\fIDEVICE\fP .B \-\-joystick-dev=\fIDEVICE\fP
Specify which joystick device should be used by Tux Paint. Default value is 0 (the first joystick). Specify which joystick device should be used by Tux Paint. Default value is
0 (the first joystick).
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List the system's available joysticks and exit. (Does not launch Tux Paint.) List the system's available joysticks and exit. (Does not launch Tux
Paint.)
.TP 8 .TP 8
.B \-\-joystick-slowness=\fISPEED\fP .B \-\-joystick-slowness=\fISPEED\fP
Sets a delay at each axis motion, allowing to slow the joystick. Allowed values are from 0 to 500. Default value is 15. Sets a delay at each axis motion, allowing to slow the joystick. Allowed
values are from 0 to 500. Default value is 15.
.TP 8 .TP 8
.B \-\-joystick-threshold=\fITHRESHOLD\fP .B \-\-joystick-threshold=\fITHRESHOLD\fP
Sets the minimum level of axis motion to start moving the pointer. Allowed values are from 0 to 32766. Default value is 3200. Sets the minimum level of axis motion to start moving the pointer. Allowed
values are from 0 to 32766. Default value is 3200.
.TP 8 .TP 8
.B \-\-joystick-maxsteps=\fISTEPS\fP .B \-\-joystick-maxsteps=\fISTEPS\fP
Sets the maximum pixels the pointer will move at once. Allowed values are from 1 to 7. Default value is 7. Sets the maximum pixels the pointer will move at once. Allowed values are
from 1 to 7. Default value is 7.
.TP 8 .TP 8
.B \-\-joystick-hat-timeout=\fIMILLISECONDS\fP .B \-\-joystick-hat-timeout=\fIMILLISECONDS\fP
Sets the delay after wich the pointer will start moving automatically if the hat is keeped pushed. Allowed values are from 0 to 3000. Default value is 1000. Sets the delay after wich the pointer will start moving automatically if
the hat is keeped pushed. Allowed values are from 0 to 3000. Default value
is 1000.
.TP 8 .TP 8
.B \-\-joystick-hat-slowness=\fISPEED\fP .B \-\-joystick-hat-slowness=\fISPEED\fP
Sets a delay at each automatic motion, allowing to slow the speed of the hat. Allowed values are from 0 to 500. Default value is 15. Sets a delay at each automatic motion, allowing to slow the speed of the
hat. Allowed values are from 0 to 500. Default value is 15.
.TP 8 .TP 8
.B \-\-joystick-btn-escape=\fIBUTTON\fP .B \-\-joystick-btn-escape=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be used to generate a escape event. Useful to dismiss dialogs and quit. Selects the joystick button number, as seen by SDL, that will be used to
generate a escape event. Useful to dismiss dialogs and quit.
.TP 8 .TP 8
.B \-\-joystick-btn-\fICOMMAND\fP=\fIBUTTON\fP .B \-\-joystick-btn-\fICOMMAND\fP=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be a shortcut to Selects the joystick button number, as seen by SDL, that will be a shortcut
various tools within Tux Paint. to various tools within Tux Paint.
.PP .PP
.RS .RS
@ -579,16 +586,15 @@ print | Print (immediate)
.TP 8 .TP 8
.B \-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\fP .B \-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\fP
A set of joystick button numbers, as seen by SDL, that should A set of joystick button numbers, as seen by SDL, that should be ignored.
be ignored. Otherwise, unless they are used by one of the Otherwise, unless they are used by one of the "--joystick-btn-..." options
"--joystick-btn-..." options above, buttons will be seen as a mouse above, buttons will be seen as a mouse left-click. Comma-separated.
left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
.l .l
\fItuxpaint\fP accepts the following options to alter how Tux Paint \fItuxpaint\fP accepts the following options to alter how Tux Paint handles
handles printing. They can be used along with, instead of, or to printing. They can be used along with, instead of, or to override options
override options set in configuration files. (See below.) set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
@ -597,50 +603,48 @@ Disable or enable (default) the Print command within Tux Paint.
.TP 8 .TP 8
.B \-\-printdelay=\fISECONDS\fP \-\-printdelay=0 .B \-\-printdelay=\fISECONDS\fP \-\-printdelay=0
Only allow printing (via the \fIPrint\fP command) once every \fISECONDS\fP Only allow printing (via the Print command) once every SECONDS seconds.
seconds. Default is 0 (no limitation). Default is 0 (no limitation).
.SS SHOW PRINTER DIALOG .SS SHOW PRINTER DIALOG
.TP 8 .TP 8
.B \-\-altprintmod \-\-altprintnever \-\-altprintalways .B \-\-altprintmod \-\-altprintnever \-\-altprintalways
These options control whether an system printer dialog appears when the These options control whether an system printer dialog appears when the
user clicks the \fIPrint\fP button. By default (\-\-altprintmod), pressing user clicks the Print button. By default ("--altprintmod"), pressing [Alt]
\fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're while clicking Print will bring up a dialog (unless you're in fullscreen
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, mode). With "--altprintalways", the dialog will always appear, even if
even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog [Alt] is not being held. With "--altprintnever", the dialog will never
will never appear, even if \fI[Alt]\fP is being held. appear, even if [Alt] is being held.
.SS SAVE PRINTER CONFIGURATION .SS SAVE PRINTER CONFIGURATION
.TP 8 .TP 8
.B \-\-printcfg \-\-noprintcfg .B \-\-printcfg \-\-noprintcfg
(Windows and Mac OS X only.) Enable or disable loading and saving of (Windows and Mac OS X only.) Enable or disable loading and saving of
printer settings. By default, \fITux Paint\fP will print to the default printer settings. By default, Tux Paint will print to the default printer
printer with default settings. Pressing \fI[Alt]\fP while pushing the with default settings. Pressing [Alt] while pushing the Print button will
\fIPrint\fP button will cause a printer dialog to appear (as long as you're cause a printer dialog to appear (as long as you're not in fullscreen mode;
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, see also "--altprintalways" and "--altprintnever", below.) Unless
below.) Unless \-\-noprintcfg is used, your previous settings will "--noprintcfg" is used, your previous settings will be loaded when Tux
be loaded when \fITux Paint\fP starts up, and setting changes will be saved Paint starts up, and setting changes will be saved for next time.
for next time.
.SS PRINT COMMANDS .SS PRINT COMMANDS
.TP 8 .TP 8
.B \-\-printcommand \fICOMMAND\fP .B \-\-printcommand \fICOMMAND\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.)
Have Tux Paint print via an alternate command, rather than lpr(1). Have Tux Paint print via an alternate command, rather than lpr(1).
.TP 8 .TP 8
.B \-\-altprintcommand \fICOMMAND\fP .B \-\-altprintcommand \fICOMMAND\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Have Tux Paint print via an
Have Tux Paint print via an alternate command, when a dialog is expect alternate command, when a dialog is expect (e.g., when holding [Alt] while
(e.g., when holding \fI[Alt]\fP while clicking "Print"; see above), clicking Print; see above), rather than kprinter.
rather than kprinter.
.SS PAPER SIZE .SS PAPER SIZE
.TP 8 .TP 8
.B \-\-papersize \fIPAPERSIZE\fP .B \-\-papersize \fIPAPERSIZE\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Ask Tux Paint to generate
Ask \fITux Paint\fP to generate PostScript of a particular paper size. PostScript of a particular paper size. Valid sizes are those supported by
Valid sizes are those supported by libpaper. See papersize(5). libpaper. See papersize(5).
.SH OPTIONS - SAVING .SH OPTIONS - SAVING
.l .l
@ -651,86 +655,82 @@ instead of, or to override options set in configuration files. (See below.)
.SS SAVE OVER EARLIER WORK .SS SAVE OVER EARLIER WORK
.TP 8 .TP 8
.B \-\-saveover \-\-saveovernew \-\-saveoverask .B \-\-saveover \-\-saveovernew \-\-saveoverask
If, when saving a picture, an older version of the file will be overwritten, If, when saving a picture, an older version of the file will be
\fITux Paint\fP will, by default, ask for confirmation: either overwritten, Tux Paint will, by default, ask for confirmation: either save
\fIsave over\fP the old file, or \fIcreate\fP a new file. This prompt over the old file, or create a new file. This prompt can be disabled with
can be disabled with \fI\-\-saveover\fP (which always saves over older versions "--saveover" (which always saves over older versions of pictures) or
of pictures) or \fI\-\-saveovernew\fP (which always saves a new file). "--saveovernew" (which always saves a new file). The default is to prompt
The default is to prompt (\fI\-\-saveoverask\fP). ("--saveover").
.SS SAVE AND EXPORT DIRECTORIES .SS SAVE AND EXPORT DIRECTORIES
.TP 8 .TP 8
.B \-\-savedir \fIDIR\fP .B \-\-savedir \fIDIR\fP
Specify where \fITux Paint\fP should save and load its drawings. Specify where Tux Paint should save and load its drawings.
.TP 8 .TP 8
.B \-\-exportdir \fIDIR\fP .B \-\-exportdir \fIDIR\fP
Specify where \fITux Paint\fP should export drawings and animations. Specify where Tux Paint should export drawings and animations.
.SS MORE SAVING OPTIONS .SS MORE SAVING OPTIONS
.TP 8 .TP 8
.B \-\-nosave \-\-save .B \-\-nosave \-\-save
The \fInosave\fP option disables \fITux Paint's\fP ability to save files. The --nosave option disables Tux Paint's ability to save files. This can be
This can be used in situations where the program is only being used for used in situations where the program is only being used for fun, or in a
fun, or in a test environment. test environment.
.TP 8 .TP 8
.B \-\-autosave \-\-noautosave .B \-\-autosave \-\-noautosave
The \fIautosave\fP option prevents \fITux Paint\fP from asking whether you The --autosave option prevents ITux Paint P from asking whether you want
want to save the current picture when quitting, and assumes you do. to save the current picture when quitting, and assumes you do.
.SH OPTIONS - DATA FILES .SH OPTIONS - DATA FILES
.l .l
\fItuxpaint\fP accepts the following options to alter where Tux Paint \fItuxpaint\fP accepts the following options to alter where Tux Paint loads
loads data (stamps, brushes, etc.) They can be used along with, instead data (stamps, brushes, etc.) They can be used along with, instead of, or
of, or to override options set in configuration files. (See below.) to override options set in configuration files. (See below.)
.TP 8 .TP 8
.B \-\-datadir \fIDIR\fP .B \-\-datadir \fIDIR\fP
Specify where \fITux Paint\fP should look for personal data files Specify where Tux Paint should look for personal data files (brushes,
(brushes, stamps, etc.). stamps, etc.).
.TP 8 .TP 8
.B \-\-colorfile \fIFILE\fP .B \-\-colorfile \fIFILE\fP
This option allows you to override the default color palette in \fITux Paint\fP This option allows you to override the default color palette in Tux Paint
and replace it with your own. The file should be a plain ASCII text file and replace it with your own. The file should be a plain ASCII text file
containing one color description per line. Colors may be in decimal or containing one color description per line. Colors may be in decimal or 6-
6- or 3-digit hexadecimal, and followed by a description. (For example, or 3-digit hexadecimal, and followed by a description. (For example,
"\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".) "\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".)
.SH OPTIONS - LANGUAGE .SH OPTIONS - LANGUAGE
.l .l
\fItuxpaint\fP accepts the following options to alter the language used \fItuxpaint\fP accepts the following options to alter the language used by
by Tux Paint's interface, and other related settings. They can be used Tux Paint's interface, and other related settings. They can be used along
along with, instead of, or to override options set in configuration with, instead of, or to override options set in configuration
files. (See below.) files. (See below.)
.l .l
Various parts of \fITux Paint\fP have been translated into numerous languages. Various parts of Tux Paint have been translated into numerous languages.
\fITux Paint\fP will try its best to honor your \fIlocale\fP setting Tux Paint will try its best to honor your locale setting (i.e., the "LANG"
(i.e., the \fILANG\fP environment variable), if possible. environment variable), if possible. You can also specifically set the
You can also specifically set the language using options on the command-line language using options on the command-line or in a configuration file.
or in a configuration file.
.TP 8 .TP 8
.B \-\-locale \fILOCALE\fP .B \-\-locale \fILOCALE\fP
Specify the language to use, based on locale name (which is typically of the Specify the language to use, based on locale name (which is typically of
form \fIlanguage\fP[_\fIterritory\fP][.\fIcodeset\fP][@\fImodifier\fP], the form "language[_territory][.codeset][@modifier], where "language" is an
where \fIlanguage\fP is an ISO 639 language code, ISO 639 language code, "territory" is an ISO 3166 country code, and
\fIterritory\fP is an ISO 3166 country code, and "codeset" is a character set or encoding identifier like "ISO-8859-1" or
\fIcodeset\fP is a character set or encoding identifier like ISO-8859-1 or "UTF-8".)
UTF-8.)
.PP .PP
.RS .RS
For example, \fIde_DE@euro\fP for German, or \fIpt_BR\fP For example, "de_DE@euro" for German, or "pt_BR" for Brazilian Portuguese.
for Brazilian Portuguese.
.RE .RE
.TP 8 .TP 8
.B \-\-lang \fILANGUAGE\fP .B \-\-lang \fILANGUAGE\fP
Specify the language to use, based on the language's name Specify the language to use, based on the language's name (as recognized by
(as recognized by \fITux Paint\fP). Choose one of the language names Tux Paint). Choose one of the language names listed below:
listed below:
.PP .PP
.RS .RS
.PD 0 .PD 0
@ -1130,107 +1130,130 @@ Display a lists of all supported languages.
.TP 8 .TP 8
.B \-\-mirrorstamps \-\-dontmirrorstamps .B \-\-mirrorstamps \-\-dontmirrorstamps
With \fImirrorstamps\fP set, stamps which can be mirrored will appear With "--mirrorstamps" set, stamps which can be mirrored will appear
mirrored by default. This can be useful when used by people who prefer mirrored by default. This can be useful when used by people who prefer
things right-to-left over left-to-right. things right-to-left over left-to-right.
.SS FONTS .SS FONTS
.TP 8 .TP 8
.B \-\-nosysfonts \-\-sysfonts .B \-\-nosysfonts \-\-sysfonts
\fITux Paint\fP normally attempts to search for additional TrueType Fonts Tux Paint normally attempts to search for additional TrueType Fonts
installed in common places on your system. If this causes trouble, or you'd installed in common places on your system. If this causes trouble, or
prefer to only make fonts installed in \fITux Paint\fP's directory available, you'd prefer to only make fonts installed in Tux Paint's directory
use the \fInosysfonts\fP option to disable this feature. available, use the "--nosysfonts" option to disable this feature.
.TP 8 .TP 8
.B \-\-alllocalefonts \-\-currentlocalefont .B \-\-alllocalefonts \-\-currentlocalefont
Tux Paint avoids loading any fonts in its 'locale' font subdirectory, Tux Paint avoids loading any fonts found in its "locale" font subdirectory,
except any that match the current locale \fITux Paint\fP is running under. except any that match the current locale Tux Paint is running under. Use
Use the \fIalllocalefonts\fP option to load all such fonts, for use in the the "--alllocalefonts" option to load all such fonts, for use in the Text
"Text" tool. (This is the old behavior, prior to version 0.9.21.) and Label tools. (This was the default behavior, prior to version 0.9.21.)
.SH OPTIONS - MISCELLANEOUS .SH OPTIONS - MISCELLANEOUS
.l .l
\fItuxpaint\fP accepts the following options to alter its behavior. \fItuxpaint\fP accepts the following options to alter its behavior. They
They can be used along with, instead of, or to override options set in can be used along with, instead of, or to override options set in
configuration files. (See below.) configuration files. (See below.)
.TP 8 .TP 8
.B \-\-nosysconfig .B \-\-nosysconfig
With this option, \fITux Paint\fP will not attempt to read the With this option, Tux Paint will not attempt to read the system-wide
system-wide configuration file (typically \fI/etc/tuxpaint/tuxpaint.conf\fP). configuration file (typically "/etc/tuxpaint/tuxpaint.conf" or
"/usr/local/etc/tuxpaint/tuxpaint.conf").
.TP 8 .TP 8
.B \-\-nolockfile .B \-\-nolockfile
By default, \fITux Paint\fP uses a lockfile (stored in the user's By default, Tux Paint uses a lockfile (stored in the user's local Tux Paint directory) which prevents it from being launched more than once in 30 seconds. (Sometimes children get too eager, or user interfaces only require one click, but users think they need to double-click.) This option makes Tux Paint ignore the current lockfile.
local Tux Paint directory) which prevents it from being launched more than
once in 30 seconds. (Sometimes children get too eager, or user interfaces
only require one click, but users think they need to double-click.)
This option makes \fITux Paint\fP ignore the current lockfile.
.SH ENVIRONMENT .SH ENVIRONMENT
.ad l .ad l
While \fITux Paint\fP may refer to a number of environment variables indirectly While Tux Paint may refer to a number of environment variables indirectly
(e.g., via \fISDL(3)\fP), it only directly accesses the following: (e.g., via SDL(3)), it directly accesses the following: (See "FILES" below,
as well.)
.PP .PP
.TP 8 .TP 8
.B HOME .B HOME
to determine where picture files go when using the \fISave\fP and \fIOpen\fP to determine where picture files go when using the Save and Open commands
commands within \fITux Paint\fP, to keep track of the current image, within Tux Paint, to keep track of the current image, when quitting and
when quitting and restarting \fITux Paint\fP, and to get the user's restarting Tux Paint, and to get the user's configuration file.
configuration file.
.TP 8 .TP 8
.B LANG .B LANG, LC_ALL, LANGUAGE, and LC_MESSAGES
to determine language to use, if \fIsetlocale(3)\fP refers to 'LC_MESSAGES'. to determine language to use, if setlocale(3) refers to "LC_MESSAGES".
.TP 8
.B SDL_VIDEO_ALLOW_SCREENSAVER
Set this environment variable to '1' to allow a screensaver to appear while
Tux Paint is running. This can also be done via the "--allowscreensaver"
option.
.TP 8
.B SDL_VIDEO_WINDOW_POS
If this is NOT set, Tux Paint will set it to "center", to attempt to place
the Tux Paint window in the center of a display. If it IS set (e.g., to
"nopref", meaning "no preference"), Tux Paint will not override it.
.SH FILES .SH FILES
.TP 8 .TP 8
.B /etc/tuxpaint/tuxpaint.conf .B [/usr/local/]/etc/tuxpaint/tuxpaint.conf
System-wide configuration file. It is read first System-wide configuration file. It is read first (unless the
(unless the \fI\-\-nosysconfig\fP option was given on the command-line). "--nosysconfig" option was given on the command-line).
.RS .RS
.PP .PP
(Created during installation.) (Created during installation.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaintrc .B $HOME/.tuxpaintrc
User's configuration file. It can be used to set default options User's configuration file. It can be used to set default options (rather
(rather than setting them on the command-line every time), and/or to than setting them on the command-line every time), and/or to override any
override any settings in the system-wide configuration file. settings in the system-wide configuration file.
.RS .RS
.PP .PP
(Not created or edited automatically; must be created manually. (Not created or edited automatically; must be created manually. You can do
You can do this by hand, or use '\fITux Paint Config.\fP.') this by hand, or use tuxpaint-config(1).)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/saved/ .B $HOME/.tuxpaint/saved/
A directory of previously-saved images (and thumbnails). Only files in this A directory of previously-saved images (and thumbnails). Only files in
directory will be made available using the \fIOpen\fP command within this directory will be made available using the Open command within Tux
\fITux Paint\fP. (See \fItuxpaint-import(1)\fP.) Paint. Overridden via the "--savedir" option.
.RS .RS
.PP .PP
(Created when \fISave\fP command is used.) (Created when Save command is used.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/current_id.txt .B $HOME/.tuxpaint/current_id.txt
A reference to the image which was being edited when \fITux Paint\fP was A reference to the image which was being edited when Tux Paint was last
last quit. (This image is automatically loaded the next time \fITux Paint\fP quit. (This image is automatically loaded the next time Tux Paint is
is re-run.) re-run, unless the "--startblank" option is set.)
.RS .RS
.PP .PP
(Created when \fITux Paint\fP is \fIQuit\fP.) (Created when Tux Paint is Quit.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/lockfile.dat .B $HOME/.tuxpaint/lockfile.dat
A lockfile that prevents \fITux Paint\fP from being launched more than once A lockfile that prevents Tux Paint from being launched more than once every
every 30 seconds. Disable checking the lockfile by using the 30 seconds. Disable checking the lockfile by using the "--nolockfile"
\'\-\-nolockfile\' command-line argument. option.
.RS .RS
.PP .PP
(There's no reason to delete the lockfile, as it contains a timestamp (There's no reason to delete the lockfile, as it contains a timestamp
inside which causes it to expire after 30 seconds.) inside which causes it to expire after 30 seconds.)
.RE .RE
.TP 8
.B $XDG_CONFIG_HOME[XDG_PICTURES_DIR]/TuxPaint/
A directory where images and animations should be exported (via options
found in Tux Paint's Open dialog), if the "--exportdir" option is not used
to override it. If "$XDG_CONFIG_HOME" is set, a configuration file
"user-dirs.dirs" will be scanned within the directory it points to; if not,
Tux Paint will attempt to do so within "$HOME/.config/". If a setting
named "XDG_PICTURES_DIR" is found, it will be used as the location to
export images. If all else fails, then "$HOME/Pictures/" will be used. A
"TuxPaint" subdirectory will be created.
.TP 8
.B $XDG_DATA_HOME/Trash/ or $HOME/.local/share/Trash/
A directory where images are placed when the Erase option is used from the
Open dialog.
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify it This program is free software; you can redistribute it and/or modify it
@ -1515,4 +1538,4 @@ Huang Zuzhen.
.BR krita (1), .BR krita (1),
.BR gcompris (1) .BR gcompris (1)
.PP .PP
And documentation within /usr/[local/]share/doc/tuxpaint/.

345
man/es_ES.UTF-8/tuxpaint.1
View file

@ -377,22 +377,22 @@ blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
List solid (blank) colors at the end, or beginning (default) of the List solid (blank) colors at the end, or beginning (default) of the options
options displayed when using the \fINew\fP tool to start a new picture. displayed when using the New tool to start a new picture.
.SS CONTROL SIMPLIFICATION .SS CONTROL SIMPLIFICATION
.TP 8 .TP 8
.B \-\-noquit \-\-quit .B \-\-noquit \-\-quit
Disable or enable (default) the on-screen Quit button and [Escape] Disable or enable (default) the on-screen Quit button and [Escape] key for
key for quitting Tux Paint. Instead, use the window close quitting Tux Paint. Instead, use the window close button in the titlebar,
button in the titlebar, the [Al]+[F4] key sequence, or the the [Alt]+[F4] key sequence, or the [Shift]+[Control]+[Escape] key
[Shift]+[Control]+[Escape] key sequence. sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With "--nostamps" set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the Stamps
Stamps tool will not be available. This option can be used to reduce tool will not be available. This option can be used to reduce the time Tux
the time Tux Paint takes to load, and reduce the amount of RAM it requires. Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
.B \-\-nostampcontrols \-\-stampcontrols .B \-\-nostampcontrols \-\-stampcontrols
@ -402,9 +402,9 @@ in all ways.)
.TP 8 .TP 8
.B \-\-nomagiccontrols \-\-magiccontrols .B \-\-nomagiccontrols \-\-magiccontrols
Disable or enable (default) buttons to control Magic tools. Controls include Disable or enable (default) buttons to control Magic tools. Controls
controlling whether a Magic tool is used like a paint brush, or if it include controlling whether a Magic tool is used like a paint brush, or if
affects the entire image at once. (Note: Not all Magic tools will be it affects the entire image at once. (Note: Not all Magic tools will be
controllable.) controllable.)
.TP 8 .TP 8
@ -415,14 +415,14 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the Label tool, which lets you create Disable or enable (default) the Label tool, which lets you create text
text which can be altered or moved later. which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
.l .l
\fItuxpaint\fP accepts the following options to alter how you control \fItuxpaint\fP accepts the following options to alter how you control Tux
Tux Paint. They can be used along with, instead of, or to override options Paint. They can be used along with, instead of, or to override options set
set in configuration files. (See below.) in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
@ -433,14 +433,13 @@ trouble displaying the mouse pointer, and/or leave 'trails' on the screen.
.TP 8 .TP 8
.B \-\-hidecursor \-\-showcursor .B \-\-hidecursor \-\-showcursor
Completely hide, or enable (default) the mouse pointer in Tux Paint. Completely hide, or enable (default) the mouse pointer in Tux Paint. This
This can be useful on touchscreen devices, such as tablet PCs. can be useful on touchscreen devices, such as tablet PCs.
.SS KEYBOARD .SS KEYBOARD
.TP 8 .TP 8
.B \-\-noshortcuts \-\-shortcuts .B \-\-noshortcuts \-\-shortcuts
If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) <? /* --[no]shortcuts */ wordwrap(sprintf(gettext(If \"%s\" mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) will be disabled. Default mode is for shortcuts to be enabled."), "--noshortcuts")) . "\n" ?>
will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
@ -451,10 +450,10 @@ confined to the Tux Paint window. Default is to not grab.
.TP 8 .TP 8
.B \-\-nowheelmouse \-\-wheelmouse .B \-\-nowheelmouse \-\-wheelmouse
By default, the wheel (jog dial) on a mouse will be used to scroll the By default, the wheel (jog dial) on a mouse will be used to scroll the
'selector' on the right of the screen. This can be disabled, and the 'selector' on the right of the screen. This can be disabled, and the wheel
wheel completely ignored, with the \fI\-\-nowheelmouse\fP option. completely ignored, with the "--nowheelmouse" option. This is useful for
This is useful for children who aren't yet comfortable with the mouse. children who aren't yet comfortable with the mouse. Default is to support
Default is to support the wheel. the wheel.
.TP 8 .TP 8
.B \-\-mouse-accessibility .B \-\-mouse-accessibility
@ -463,24 +462,23 @@ you click, move, and click again to end the motion.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The "--keyboard" option lets the mouse pointer in Tux Paint be The "--keyboard" option lets the mouse pointer in Tux Paint be controlled
controlled with the keyboard. The [Up], [Down], [Left], and [Right] with the keyboard. The [Up], [Down], [Left], and [Right] arrow keys move
arrow keys move the pointer. [Spacebar] acts as the mouse button. the pointer. [Spacebar] acts as the mouse button.
.TP 8 .TP 8
.B \-\-nobuttondistinction \-\-buttondistinction .B \-\-nobuttondistinction \-\-buttondistinction
By default, only mouse button #1 (typically the leftmost mouse button By default, only mouse button #1 (typically the leftmost mouse button on
on mice with more than one button) can be used for interacting with mice with more than one button) can be used for interacting with Tux Paint.
Tux Paint. With the "--nobuttondistinction" option, With the "--nobuttondistinction" option, mouse buttons #2 (middle) and #3
mouse buttons #2 (middle) and #3 (right) can be used, as well. (right) can be used, as well. This is useful for children who aren't yet
This is useful for children who aren't yet comfortable with the mouse. comfortable with the mouse. Default is to only recognize button #1.
Default is to only recognize button #1.
.SS ONSCREEN KEYBOARD .SS ONSCREEN KEYBOARD
.TP 8 .TP 8
.B \-\-onscreen-keyboard .B \-\-onscreen-keyboard
Presents a clickable on-screen keyboard when using the Text and Presents a clickable on-screen keyboard when using the Text and Label
Label tools. tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -494,40 +492,49 @@ which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
.B \-\-joystick-dev=\fIDEVICE\fP .B \-\-joystick-dev=\fIDEVICE\fP
Specify which joystick device should be used by Tux Paint. Default value is 0 (the first joystick). Specify which joystick device should be used by Tux Paint. Default value is
0 (the first joystick).
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List the system's available joysticks and exit. (Does not launch Tux Paint.) List the system's available joysticks and exit. (Does not launch Tux
Paint.)
.TP 8 .TP 8
.B \-\-joystick-slowness=\fISPEED\fP .B \-\-joystick-slowness=\fISPEED\fP
Sets a delay at each axis motion, allowing to slow the joystick. Allowed values are from 0 to 500. Default value is 15. Sets a delay at each axis motion, allowing to slow the joystick. Allowed
values are from 0 to 500. Default value is 15.
.TP 8 .TP 8
.B \-\-joystick-threshold=\fITHRESHOLD\fP .B \-\-joystick-threshold=\fITHRESHOLD\fP
Sets the minimum level of axis motion to start moving the pointer. Allowed values are from 0 to 32766. Default value is 3200. Sets the minimum level of axis motion to start moving the pointer. Allowed
values are from 0 to 32766. Default value is 3200.
.TP 8 .TP 8
.B \-\-joystick-maxsteps=\fISTEPS\fP .B \-\-joystick-maxsteps=\fISTEPS\fP
Sets the maximum pixels the pointer will move at once. Allowed values are from 1 to 7. Default value is 7. Sets the maximum pixels the pointer will move at once. Allowed values are
from 1 to 7. Default value is 7.
.TP 8 .TP 8
.B \-\-joystick-hat-timeout=\fIMILLISECONDS\fP .B \-\-joystick-hat-timeout=\fIMILLISECONDS\fP
Sets the delay after wich the pointer will start moving automatically if the hat is keeped pushed. Allowed values are from 0 to 3000. Default value is 1000. Sets the delay after wich the pointer will start moving automatically if
the hat is keeped pushed. Allowed values are from 0 to 3000. Default value
is 1000.
.TP 8 .TP 8
.B \-\-joystick-hat-slowness=\fISPEED\fP .B \-\-joystick-hat-slowness=\fISPEED\fP
Sets a delay at each automatic motion, allowing to slow the speed of the hat. Allowed values are from 0 to 500. Default value is 15. Sets a delay at each automatic motion, allowing to slow the speed of the
hat. Allowed values are from 0 to 500. Default value is 15.
.TP 8 .TP 8
.B \-\-joystick-btn-escape=\fIBUTTON\fP .B \-\-joystick-btn-escape=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be used to generate a escape event. Useful to dismiss dialogs and quit. Selects the joystick button number, as seen by SDL, that will be used to
generate a escape event. Useful to dismiss dialogs and quit.
.TP 8 .TP 8
.B \-\-joystick-btn-\fICOMMAND\fP=\fIBUTTON\fP .B \-\-joystick-btn-\fICOMMAND\fP=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be a shortcut to Selects the joystick button number, as seen by SDL, that will be a shortcut
various tools within Tux Paint. to various tools within Tux Paint.
.PP .PP
.RS .RS
@ -579,16 +586,15 @@ print | Print (immediate)
.TP 8 .TP 8
.B \-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\fP .B \-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\fP
A set of joystick button numbers, as seen by SDL, that should A set of joystick button numbers, as seen by SDL, that should be ignored.
be ignored. Otherwise, unless they are used by one of the Otherwise, unless they are used by one of the "--joystick-btn-..." options
"--joystick-btn-..." options above, buttons will be seen as a mouse above, buttons will be seen as a mouse left-click. Comma-separated.
left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
.l .l
\fItuxpaint\fP accepts the following options to alter how Tux Paint \fItuxpaint\fP accepts the following options to alter how Tux Paint handles
handles printing. They can be used along with, instead of, or to printing. They can be used along with, instead of, or to override options
override options set in configuration files. (See below.) set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
@ -597,50 +603,48 @@ Disable or enable (default) the Print command within Tux Paint.
.TP 8 .TP 8
.B \-\-printdelay=\fISECONDS\fP \-\-printdelay=0 .B \-\-printdelay=\fISECONDS\fP \-\-printdelay=0
Only allow printing (via the \fIPrint\fP command) once every \fISECONDS\fP Only allow printing (via the Print command) once every SECONDS seconds.
seconds. Default is 0 (no limitation). Default is 0 (no limitation).
.SS SHOW PRINTER DIALOG .SS SHOW PRINTER DIALOG
.TP 8 .TP 8
.B \-\-altprintmod \-\-altprintnever \-\-altprintalways .B \-\-altprintmod \-\-altprintnever \-\-altprintalways
These options control whether an system printer dialog appears when the These options control whether an system printer dialog appears when the
user clicks the \fIPrint\fP button. By default (\-\-altprintmod), pressing user clicks the Print button. By default ("--altprintmod"), pressing [Alt]
\fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're while clicking Print will bring up a dialog (unless you're in fullscreen
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, mode). With "--altprintalways", the dialog will always appear, even if
even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog [Alt] is not being held. With "--altprintnever", the dialog will never
will never appear, even if \fI[Alt]\fP is being held. appear, even if [Alt] is being held.
.SS SAVE PRINTER CONFIGURATION .SS SAVE PRINTER CONFIGURATION
.TP 8 .TP 8
.B \-\-printcfg \-\-noprintcfg .B \-\-printcfg \-\-noprintcfg
(Windows and Mac OS X only.) Enable or disable loading and saving of (Windows and Mac OS X only.) Enable or disable loading and saving of
printer settings. By default, \fITux Paint\fP will print to the default printer settings. By default, Tux Paint will print to the default printer
printer with default settings. Pressing \fI[Alt]\fP while pushing the with default settings. Pressing [Alt] while pushing the Print button will
\fIPrint\fP button will cause a printer dialog to appear (as long as you're cause a printer dialog to appear (as long as you're not in fullscreen mode;
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, see also "--altprintalways" and "--altprintnever", below.) Unless
below.) Unless \-\-noprintcfg is used, your previous settings will "--noprintcfg" is used, your previous settings will be loaded when Tux
be loaded when \fITux Paint\fP starts up, and setting changes will be saved Paint starts up, and setting changes will be saved for next time.
for next time.
.SS PRINT COMMANDS .SS PRINT COMMANDS
.TP 8 .TP 8
.B \-\-printcommand \fICOMMAND\fP .B \-\-printcommand \fICOMMAND\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.)
Have Tux Paint print via an alternate command, rather than lpr(1). Have Tux Paint print via an alternate command, rather than lpr(1).
.TP 8 .TP 8
.B \-\-altprintcommand \fICOMMAND\fP .B \-\-altprintcommand \fICOMMAND\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Have Tux Paint print via an
Have Tux Paint print via an alternate command, when a dialog is expect alternate command, when a dialog is expect (e.g., when holding [Alt] while
(e.g., when holding \fI[Alt]\fP while clicking "Print"; see above), clicking Print; see above), rather than kprinter.
rather than kprinter.
.SS PAPER SIZE .SS PAPER SIZE
.TP 8 .TP 8
.B \-\-papersize \fIPAPERSIZE\fP .B \-\-papersize \fIPAPERSIZE\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Ask Tux Paint to generate
Ask \fITux Paint\fP to generate PostScript of a particular paper size. PostScript of a particular paper size. Valid sizes are those supported by
Valid sizes are those supported by libpaper. See papersize(5). libpaper. See papersize(5).
.SH OPTIONS - SAVING .SH OPTIONS - SAVING
.l .l
@ -651,86 +655,82 @@ instead of, or to override options set in configuration files. (See below.)
.SS SAVE OVER EARLIER WORK .SS SAVE OVER EARLIER WORK
.TP 8 .TP 8
.B \-\-saveover \-\-saveovernew \-\-saveoverask .B \-\-saveover \-\-saveovernew \-\-saveoverask
If, when saving a picture, an older version of the file will be overwritten, If, when saving a picture, an older version of the file will be
\fITux Paint\fP will, by default, ask for confirmation: either overwritten, Tux Paint will, by default, ask for confirmation: either save
\fIsave over\fP the old file, or \fIcreate\fP a new file. This prompt over the old file, or create a new file. This prompt can be disabled with
can be disabled with \fI\-\-saveover\fP (which always saves over older versions "--saveover" (which always saves over older versions of pictures) or
of pictures) or \fI\-\-saveovernew\fP (which always saves a new file). "--saveovernew" (which always saves a new file). The default is to prompt
The default is to prompt (\fI\-\-saveoverask\fP). ("--saveover").
.SS SAVE AND EXPORT DIRECTORIES .SS SAVE AND EXPORT DIRECTORIES
.TP 8 .TP 8
.B \-\-savedir \fIDIR\fP .B \-\-savedir \fIDIR\fP
Specify where \fITux Paint\fP should save and load its drawings. Specify where Tux Paint should save and load its drawings.
.TP 8 .TP 8
.B \-\-exportdir \fIDIR\fP .B \-\-exportdir \fIDIR\fP
Specify where \fITux Paint\fP should export drawings and animations. Specify where Tux Paint should export drawings and animations.
.SS MORE SAVING OPTIONS .SS MORE SAVING OPTIONS
.TP 8 .TP 8
.B \-\-nosave \-\-save .B \-\-nosave \-\-save
The \fInosave\fP option disables \fITux Paint's\fP ability to save files. The --nosave option disables Tux Paint's ability to save files. This can be
This can be used in situations where the program is only being used for used in situations where the program is only being used for fun, or in a
fun, or in a test environment. test environment.
.TP 8 .TP 8
.B \-\-autosave \-\-noautosave .B \-\-autosave \-\-noautosave
The \fIautosave\fP option prevents \fITux Paint\fP from asking whether you The --autosave option prevents ITux Paint P from asking whether you want
want to save the current picture when quitting, and assumes you do. to save the current picture when quitting, and assumes you do.
.SH OPTIONS - DATA FILES .SH OPTIONS - DATA FILES
.l .l
\fItuxpaint\fP accepts the following options to alter where Tux Paint \fItuxpaint\fP accepts the following options to alter where Tux Paint loads
loads data (stamps, brushes, etc.) They can be used along with, instead data (stamps, brushes, etc.) They can be used along with, instead of, or
of, or to override options set in configuration files. (See below.) to override options set in configuration files. (See below.)
.TP 8 .TP 8
.B \-\-datadir \fIDIR\fP .B \-\-datadir \fIDIR\fP
Specify where \fITux Paint\fP should look for personal data files Specify where Tux Paint should look for personal data files (brushes,
(brushes, stamps, etc.). stamps, etc.).
.TP 8 .TP 8
.B \-\-colorfile \fIFILE\fP .B \-\-colorfile \fIFILE\fP
This option allows you to override the default color palette in \fITux Paint\fP This option allows you to override the default color palette in Tux Paint
and replace it with your own. The file should be a plain ASCII text file and replace it with your own. The file should be a plain ASCII text file
containing one color description per line. Colors may be in decimal or containing one color description per line. Colors may be in decimal or 6-
6- or 3-digit hexadecimal, and followed by a description. (For example, or 3-digit hexadecimal, and followed by a description. (For example,
"\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".) "\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".)
.SH OPTIONS - LANGUAGE .SH OPTIONS - LANGUAGE
.l .l
\fItuxpaint\fP accepts the following options to alter the language used \fItuxpaint\fP accepts the following options to alter the language used by
by Tux Paint's interface, and other related settings. They can be used Tux Paint's interface, and other related settings. They can be used along
along with, instead of, or to override options set in configuration with, instead of, or to override options set in configuration
files. (See below.) files. (See below.)
.l .l
Various parts of \fITux Paint\fP have been translated into numerous languages. Various parts of Tux Paint have been translated into numerous languages.
\fITux Paint\fP will try its best to honor your \fIlocale\fP setting Tux Paint will try its best to honor your locale setting (i.e., the "LANG"
(i.e., the \fILANG\fP environment variable), if possible. environment variable), if possible. You can also specifically set the
You can also specifically set the language using options on the command-line language using options on the command-line or in a configuration file.
or in a configuration file.
.TP 8 .TP 8
.B \-\-locale \fILOCALE\fP .B \-\-locale \fILOCALE\fP
Specify the language to use, based on locale name (which is typically of the Specify the language to use, based on locale name (which is typically of
form \fIlanguage\fP[_\fIterritory\fP][.\fIcodeset\fP][@\fImodifier\fP], the form "language[_territory][.codeset][@modifier], where "language" is an
where \fIlanguage\fP is an ISO 639 language code, ISO 639 language code, "territory" is an ISO 3166 country code, and
\fIterritory\fP is an ISO 3166 country code, and "codeset" is a character set or encoding identifier like "ISO-8859-1" or
\fIcodeset\fP is a character set or encoding identifier like ISO-8859-1 or "UTF-8".)
UTF-8.)
.PP .PP
.RS .RS
For example, \fIde_DE@euro\fP for German, or \fIpt_BR\fP For example, "de_DE@euro" for German, or "pt_BR" for Brazilian Portuguese.
for Brazilian Portuguese.
.RE .RE
.TP 8 .TP 8
.B \-\-lang \fILANGUAGE\fP .B \-\-lang \fILANGUAGE\fP
Specify the language to use, based on the language's name Specify the language to use, based on the language's name (as recognized by
(as recognized by \fITux Paint\fP). Choose one of the language names Tux Paint). Choose one of the language names listed below:
listed below:
.PP .PP
.RS .RS
.PD 0 .PD 0
@ -1130,107 +1130,130 @@ Display a lists of all supported languages.
.TP 8 .TP 8
.B \-\-mirrorstamps \-\-dontmirrorstamps .B \-\-mirrorstamps \-\-dontmirrorstamps
With \fImirrorstamps\fP set, stamps which can be mirrored will appear With "--mirrorstamps" set, stamps which can be mirrored will appear
mirrored by default. This can be useful when used by people who prefer mirrored by default. This can be useful when used by people who prefer
things right-to-left over left-to-right. things right-to-left over left-to-right.
.SS FONTS .SS FONTS
.TP 8 .TP 8
.B \-\-nosysfonts \-\-sysfonts .B \-\-nosysfonts \-\-sysfonts
\fITux Paint\fP normally attempts to search for additional TrueType Fonts Tux Paint normally attempts to search for additional TrueType Fonts
installed in common places on your system. If this causes trouble, or you'd installed in common places on your system. If this causes trouble, or
prefer to only make fonts installed in \fITux Paint\fP's directory available, you'd prefer to only make fonts installed in Tux Paint's directory
use the \fInosysfonts\fP option to disable this feature. available, use the "--nosysfonts" option to disable this feature.
.TP 8 .TP 8
.B \-\-alllocalefonts \-\-currentlocalefont .B \-\-alllocalefonts \-\-currentlocalefont
Tux Paint avoids loading any fonts in its 'locale' font subdirectory, Tux Paint avoids loading any fonts found in its "locale" font subdirectory,
except any that match the current locale \fITux Paint\fP is running under. except any that match the current locale Tux Paint is running under. Use
Use the \fIalllocalefonts\fP option to load all such fonts, for use in the the "--alllocalefonts" option to load all such fonts, for use in the Text
"Text" tool. (This is the old behavior, prior to version 0.9.21.) and Label tools. (This was the default behavior, prior to version 0.9.21.)
.SH OPTIONS - MISCELLANEOUS .SH OPTIONS - MISCELLANEOUS
.l .l
\fItuxpaint\fP accepts the following options to alter its behavior. \fItuxpaint\fP accepts the following options to alter its behavior. They
They can be used along with, instead of, or to override options set in can be used along with, instead of, or to override options set in
configuration files. (See below.) configuration files. (See below.)
.TP 8 .TP 8
.B \-\-nosysconfig .B \-\-nosysconfig
With this option, \fITux Paint\fP will not attempt to read the With this option, Tux Paint will not attempt to read the system-wide
system-wide configuration file (typically \fI/etc/tuxpaint/tuxpaint.conf\fP). configuration file (typically "/etc/tuxpaint/tuxpaint.conf" or
"/usr/local/etc/tuxpaint/tuxpaint.conf").
.TP 8 .TP 8
.B \-\-nolockfile .B \-\-nolockfile
By default, \fITux Paint\fP uses a lockfile (stored in the user's By default, Tux Paint uses a lockfile (stored in the user's local Tux Paint directory) which prevents it from being launched more than once in 30 seconds. (Sometimes children get too eager, or user interfaces only require one click, but users think they need to double-click.) This option makes Tux Paint ignore the current lockfile.
local Tux Paint directory) which prevents it from being launched more than
once in 30 seconds. (Sometimes children get too eager, or user interfaces
only require one click, but users think they need to double-click.)
This option makes \fITux Paint\fP ignore the current lockfile.
.SH ENVIRONMENT .SH ENVIRONMENT
.ad l .ad l
While \fITux Paint\fP may refer to a number of environment variables indirectly While Tux Paint may refer to a number of environment variables indirectly
(e.g., via \fISDL(3)\fP), it only directly accesses the following: (e.g., via SDL(3)), it directly accesses the following: (See "FILES" below,
as well.)
.PP .PP
.TP 8 .TP 8
.B HOME .B HOME
to determine where picture files go when using the \fISave\fP and \fIOpen\fP to determine where picture files go when using the Save and Open commands
commands within \fITux Paint\fP, to keep track of the current image, within Tux Paint, to keep track of the current image, when quitting and
when quitting and restarting \fITux Paint\fP, and to get the user's restarting Tux Paint, and to get the user's configuration file.
configuration file.
.TP 8 .TP 8
.B LANG .B LANG, LC_ALL, LANGUAGE, and LC_MESSAGES
to determine language to use, if \fIsetlocale(3)\fP refers to 'LC_MESSAGES'. to determine language to use, if setlocale(3) refers to "LC_MESSAGES".
.TP 8
.B SDL_VIDEO_ALLOW_SCREENSAVER
Set this environment variable to '1' to allow a screensaver to appear while
Tux Paint is running. This can also be done via the "--allowscreensaver"
option.
.TP 8
.B SDL_VIDEO_WINDOW_POS
If this is NOT set, Tux Paint will set it to "center", to attempt to place
the Tux Paint window in the center of a display. If it IS set (e.g., to
"nopref", meaning "no preference"), Tux Paint will not override it.
.SH FILES .SH FILES
.TP 8 .TP 8
.B /etc/tuxpaint/tuxpaint.conf .B [/usr/local/]/etc/tuxpaint/tuxpaint.conf
System-wide configuration file. It is read first System-wide configuration file. It is read first (unless the
(unless the \fI\-\-nosysconfig\fP option was given on the command-line). "--nosysconfig" option was given on the command-line).
.RS .RS
.PP .PP
(Created during installation.) (Created during installation.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaintrc .B $HOME/.tuxpaintrc
User's configuration file. It can be used to set default options User's configuration file. It can be used to set default options (rather
(rather than setting them on the command-line every time), and/or to than setting them on the command-line every time), and/or to override any
override any settings in the system-wide configuration file. settings in the system-wide configuration file.
.RS .RS
.PP .PP
(Not created or edited automatically; must be created manually. (Not created or edited automatically; must be created manually. You can do
You can do this by hand, or use '\fITux Paint Config.\fP.') this by hand, or use tuxpaint-config(1).)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/saved/ .B $HOME/.tuxpaint/saved/
A directory of previously-saved images (and thumbnails). Only files in this A directory of previously-saved images (and thumbnails). Only files in
directory will be made available using the \fIOpen\fP command within this directory will be made available using the Open command within Tux
\fITux Paint\fP. (See \fItuxpaint-import(1)\fP.) Paint. Overridden via the "--savedir" option.
.RS .RS
.PP .PP
(Created when \fISave\fP command is used.) (Created when Save command is used.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/current_id.txt .B $HOME/.tuxpaint/current_id.txt
A reference to the image which was being edited when \fITux Paint\fP was A reference to the image which was being edited when Tux Paint was last
last quit. (This image is automatically loaded the next time \fITux Paint\fP quit. (This image is automatically loaded the next time Tux Paint is
is re-run.) re-run, unless the "--startblank" option is set.)
.RS .RS
.PP .PP
(Created when \fITux Paint\fP is \fIQuit\fP.) (Created when Tux Paint is Quit.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/lockfile.dat .B $HOME/.tuxpaint/lockfile.dat
A lockfile that prevents \fITux Paint\fP from being launched more than once A lockfile that prevents Tux Paint from being launched more than once every
every 30 seconds. Disable checking the lockfile by using the 30 seconds. Disable checking the lockfile by using the "--nolockfile"
\'\-\-nolockfile\' command-line argument. option.
.RS .RS
.PP .PP
(There's no reason to delete the lockfile, as it contains a timestamp (There's no reason to delete the lockfile, as it contains a timestamp
inside which causes it to expire after 30 seconds.) inside which causes it to expire after 30 seconds.)
.RE .RE
.TP 8
.B $XDG_CONFIG_HOME[XDG_PICTURES_DIR]/TuxPaint/
A directory where images and animations should be exported (via options
found in Tux Paint's Open dialog), if the "--exportdir" option is not used
to override it. If "$XDG_CONFIG_HOME" is set, a configuration file
"user-dirs.dirs" will be scanned within the directory it points to; if not,
Tux Paint will attempt to do so within "$HOME/.config/". If a setting
named "XDG_PICTURES_DIR" is found, it will be used as the location to
export images. If all else fails, then "$HOME/Pictures/" will be used. A
"TuxPaint" subdirectory will be created.
.TP 8
.B $XDG_DATA_HOME/Trash/ or $HOME/.local/share/Trash/
A directory where images are placed when the Erase option is used from the
Open dialog.
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify it This program is free software; you can redistribute it and/or modify it
@ -1515,4 +1538,4 @@ Huang Zuzhen.
.BR krita (1), .BR krita (1),
.BR gcompris (1) .BR gcompris (1)
.PP .PP
And documentation within /usr/[local/]share/doc/tuxpaint/.

355
man/fr_FR.UTF-8/tuxpaint.1
View file

@ -377,22 +377,22 @@ blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
List solid (blank) colors at the end, or beginning (default) of the List solid (blank) colors at the end, or beginning (default) of the options
options displayed when using the \fINew\fP tool to start a new picture. displayed when using the New tool to start a new picture.
.SS CONTROL SIMPLIFICATION .SS CONTROL SIMPLIFICATION
.TP 8 .TP 8
.B \-\-noquit \-\-quit .B \-\-noquit \-\-quit
Disable or enable (default) the on-screen Quit button and [Escape] Disable or enable (default) the on-screen Quit button and [Escape] key for
key for quitting Tux Paint. Instead, use the window close quitting Tux Paint. Instead, use the window close button in the titlebar,
button in the titlebar, the [Al]+[F4] key sequence, or the the [Alt]+[F4] key sequence, or the [Shift]+[Control]+[Escape] key
[Shift]+[Control]+[Escape] key sequence. sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With "--nostamps" set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the Stamps
Stamps tool will not be available. This option can be used to reduce tool will not be available. This option can be used to reduce the time Tux
the time Tux Paint takes to load, and reduce the amount of RAM it requires. Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
.B \-\-nostampcontrols \-\-stampcontrols .B \-\-nostampcontrols \-\-stampcontrols
@ -402,9 +402,9 @@ in all ways.)
.TP 8 .TP 8
.B \-\-nomagiccontrols \-\-magiccontrols .B \-\-nomagiccontrols \-\-magiccontrols
Disable or enable (default) buttons to control Magic tools. Controls include Disable or enable (default) buttons to control Magic tools. Controls
controlling whether a Magic tool is used like a paint brush, or if it include controlling whether a Magic tool is used like a paint brush, or if
affects the entire image at once. (Note: Not all Magic tools will be it affects the entire image at once. (Note: Not all Magic tools will be
controllable.) controllable.)
.TP 8 .TP 8
@ -415,14 +415,14 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the Label tool, which lets you create Disable or enable (default) the Label tool, which lets you create text
text which can be altered or moved later. which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
.l .l
\fItuxpaint\fP accepts the following options to alter how you control \fItuxpaint\fP accepts the following options to alter how you control Tux
Tux Paint. They can be used along with, instead of, or to override options Paint. They can be used along with, instead of, or to override options set
set in configuration files. (See below.) in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
@ -433,14 +433,13 @@ trouble displaying the mouse pointer, and/or leave 'trails' on the screen.
.TP 8 .TP 8
.B \-\-hidecursor \-\-showcursor .B \-\-hidecursor \-\-showcursor
Completely hide, or enable (default) the mouse pointer in Tux Paint. Completely hide, or enable (default) the mouse pointer in Tux Paint. This
This can be useful on touchscreen devices, such as tablet PCs. can be useful on touchscreen devices, such as tablet PCs.
.SS KEYBOARD .SS KEYBOARD
.TP 8 .TP 8
.B \-\-noshortcuts \-\-shortcuts .B \-\-noshortcuts \-\-shortcuts
If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) <? /* --[no]shortcuts */ wordwrap(sprintf(gettext(If \"%s\" mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) will be disabled. Default mode is for shortcuts to be enabled."), "--noshortcuts")) . "\n" ?>
will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
@ -451,36 +450,36 @@ confined to the Tux Paint window. Default is to not grab.
.TP 8 .TP 8
.B \-\-nowheelmouse \-\-wheelmouse .B \-\-nowheelmouse \-\-wheelmouse
By default, the wheel (jog dial) on a mouse will be used to scroll the By default, the wheel (jog dial) on a mouse will be used to scroll the
'selector' on the right of the screen. This can be disabled, and the 'selector' on the right of the screen. This can be disabled, and the wheel
wheel completely ignored, with the \fI\-\-nowheelmouse\fP option. completely ignored, with the "--nowheelmouse" option. This is useful for
This is useful for children who aren't yet comfortable with the mouse. children who aren't yet comfortable with the mouse. Default is to support
Default is to support the wheel. the wheel.
.TP 8 .TP 8
.B \-\-mouse-accessibility .B \-\-mouse-accessibility
In this mode, instead of clicking, dragging and releasing (e.g., to draw), Dans ce mode, au lieu de cliquer, de faire glisser et de relâcher (par
you click, move, and click again to end the motion. exemple, pour dessiner), vous cliquez, déplacez et cliquez à nouveau pour
terminer le mouvement.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The "--keyboard" option lets the mouse pointer in Tux Paint be The "--keyboard" option lets the mouse pointer in Tux Paint be controlled
controlled with the keyboard. The [Up], [Down], [Left], and [Right] with the keyboard. The [Up], [Down], [Left], and [Right] arrow keys move
arrow keys move the pointer. [Spacebar] acts as the mouse button. the pointer. [Spacebar] acts as the mouse button.
.TP 8 .TP 8
.B \-\-nobuttondistinction \-\-buttondistinction .B \-\-nobuttondistinction \-\-buttondistinction
By default, only mouse button #1 (typically the leftmost mouse button By default, only mouse button #1 (typically the leftmost mouse button on
on mice with more than one button) can be used for interacting with mice with more than one button) can be used for interacting with Tux Paint.
Tux Paint. With the "--nobuttondistinction" option, With the "--nobuttondistinction" option, mouse buttons #2 (middle) and #3
mouse buttons #2 (middle) and #3 (right) can be used, as well. (right) can be used, as well. This is useful for children who aren't yet
This is useful for children who aren't yet comfortable with the mouse. comfortable with the mouse. Default is to only recognize button #1.
Default is to only recognize button #1.
.SS ONSCREEN KEYBOARD .SS ONSCREEN KEYBOARD
.TP 8 .TP 8
.B \-\-onscreen-keyboard .B \-\-onscreen-keyboard
Presents a clickable on-screen keyboard when using the Text and Presents a clickable on-screen keyboard when using the Text and Label
Label tools. tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -494,40 +493,54 @@ which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
.B \-\-joystick-dev=\fIDEVICE\fP .B \-\-joystick-dev=\fIDEVICE\fP
Specify which joystick device should be used by Tux Paint. Default value is 0 (the first joystick). Spécifie quel périphérique joystick doit être utilisé par Tux Paint.
La valeur par défaut est 0 (le premier joystick).
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List the system's available joysticks and exit. (Does not launch Tux Paint.) List the system's available joysticks and exit. (Does not launch Tux
Paint.)
.TP 8 .TP 8
.B \-\-joystick-slowness=\fISPEED\fP .B \-\-joystick-slowness=\fISPEED\fP
Sets a delay at each axis motion, allowing to slow the joystick. Allowed values are from 0 to 500. Default value is 15. Définit un retard à chaque mouvement d'axe, permettant de ralentir le
joystick. Les valeurs autorisées sont comprises entre 0 et 500. La valeur
par défaut est 15.
.TP 8 .TP 8
.B \-\-joystick-threshold=\fITHRESHOLD\fP .B \-\-joystick-threshold=\fITHRESHOLD\fP
Sets the minimum level of axis motion to start moving the pointer. Allowed values are from 0 to 32766. Default value is 3200. Définit le niveau minimum de mouvement de l'axe pour commencer à
déplacer le pointeur. Les valeurs autorisées sont comprises entre 0 et
32766. La valeur par défaut est 3200.
.TP 8 .TP 8
.B \-\-joystick-maxsteps=\fISTEPS\fP .B \-\-joystick-maxsteps=\fISTEPS\fP
Sets the maximum pixels the pointer will move at once. Allowed values are from 1 to 7. Default value is 7. Définit le nombre de pixels maximums que le pointeur déplacera à la
fois. Les valeurs autorisées vont de 1 à 7. La valeur par défaut est 7.
.TP 8 .TP 8
.B \-\-joystick-hat-timeout=\fIMILLISECONDS\fP .B \-\-joystick-hat-timeout=\fIMILLISECONDS\fP
Sets the delay after wich the pointer will start moving automatically if the hat is keeped pushed. Allowed values are from 0 to 3000. Default value is 1000. Définit le délai après lequel le pointeur commencera à se déplacer
automatiquement si le chapeau est maintenu enfoncé. Les valeurs
autorisées sont comprises entre 0 et 3 000. La valeur par défaut est 1
000.
.TP 8 .TP 8
.B \-\-joystick-hat-slowness=\fISPEED\fP .B \-\-joystick-hat-slowness=\fISPEED\fP
Sets a delay at each automatic motion, allowing to slow the speed of the hat. Allowed values are from 0 to 500. Default value is 15. Définit un délai à chaque mouvement automatique, permettant de ralentir
la vitesse du chapeau. Les valeurs autorisées sont comprises entre 0 et
500. La valeur par défaut est 15.
.TP 8 .TP 8
.B \-\-joystick-btn-escape=\fIBUTTON\fP .B \-\-joystick-btn-escape=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be used to generate a escape event. Useful to dismiss dialogs and quit. Sélectionne le numéro du bouton du joystick, tel que vu par SDL, qui sera
utilisé pour générer un événement d'échappement. Utile pour fermer
les dialogues et quitter.
.TP 8 .TP 8
.B \-\-joystick-btn-\fICOMMAND\fP=\fIBUTTON\fP .B \-\-joystick-btn-\fICOMMAND\fP=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be a shortcut to Selects the joystick button number, as seen by SDL, that will be a shortcut
various tools within Tux Paint. to various tools within Tux Paint.
.PP .PP
.RS .RS
@ -579,16 +592,15 @@ print | Print (immediate)
.TP 8 .TP 8
.B \-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\fP .B \-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\fP
A set of joystick button numbers, as seen by SDL, that should A set of joystick button numbers, as seen by SDL, that should be ignored.
be ignored. Otherwise, unless they are used by one of the Otherwise, unless they are used by one of the "--joystick-btn-..." options
"--joystick-btn-..." options above, buttons will be seen as a mouse above, buttons will be seen as a mouse left-click. Comma-separated.
left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
.l .l
\fItuxpaint\fP accepts the following options to alter how Tux Paint \fItuxpaint\fP accepts the following options to alter how Tux Paint handles
handles printing. They can be used along with, instead of, or to printing. They can be used along with, instead of, or to override options
override options set in configuration files. (See below.) set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
@ -597,50 +609,48 @@ Disable or enable (default) the Print command within Tux Paint.
.TP 8 .TP 8
.B \-\-printdelay=\fISECONDES\fP \-\-printdelay=0 .B \-\-printdelay=\fISECONDES\fP \-\-printdelay=0
Only allow printing (via the \fIPrint\fP command) once every \fISECONDS\fP Only allow printing (via the Print command) once every SECONDS seconds.
seconds. Default is 0 (no limitation). Default is 0 (no limitation).
.SS SHOW PRINTER DIALOG .SS SHOW PRINTER DIALOG
.TP 8 .TP 8
.B \-\-altprintmod \-\-altprintnever \-\-altprintalways .B \-\-altprintmod \-\-altprintnever \-\-altprintalways
These options control whether an system printer dialog appears when the These options control whether an system printer dialog appears when the
user clicks the \fIPrint\fP button. By default (\-\-altprintmod), pressing user clicks the Print button. By default ("--altprintmod"), pressing [Alt]
\fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're while clicking Print will bring up a dialog (unless you're in fullscreen
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, mode). With "--altprintalways", the dialog will always appear, even if
even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog [Alt] is not being held. With "--altprintnever", the dialog will never
will never appear, even if \fI[Alt]\fP is being held. appear, even if [Alt] is being held.
.SS SAVE PRINTER CONFIGURATION .SS SAVE PRINTER CONFIGURATION
.TP 8 .TP 8
.B \-\-printcfg \-\-noprintcfg .B \-\-printcfg \-\-noprintcfg
(Windows and Mac OS X only.) Enable or disable loading and saving of (Windows and Mac OS X only.) Enable or disable loading and saving of
printer settings. By default, \fITux Paint\fP will print to the default printer settings. By default, Tux Paint will print to the default printer
printer with default settings. Pressing \fI[Alt]\fP while pushing the with default settings. Pressing [Alt] while pushing the Print button will
\fIPrint\fP button will cause a printer dialog to appear (as long as you're cause a printer dialog to appear (as long as you're not in fullscreen mode;
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, see also "--altprintalways" and "--altprintnever", below.) Unless
below.) Unless \-\-noprintcfg is used, your previous settings will "--noprintcfg" is used, your previous settings will be loaded when Tux
be loaded when \fITux Paint\fP starts up, and setting changes will be saved Paint starts up, and setting changes will be saved for next time.
for next time.
.SS PRINT COMMANDS .SS PRINT COMMANDS
.TP 8 .TP 8
.B \-\-printcommand \fICOMMAND\fP .B \-\-printcommand \fICOMMAND\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.)
Have Tux Paint print via an alternate command, rather than lpr(1). Have Tux Paint print via an alternate command, rather than lpr(1).
.TP 8 .TP 8
.B \-\-altprintcommand \fICOMMAND\fP .B \-\-altprintcommand \fICOMMAND\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Have Tux Paint print via an
Have Tux Paint print via an alternate command, when a dialog is expect alternate command, when a dialog is expect (e.g., when holding [Alt] while
(e.g., when holding \fI[Alt]\fP while clicking "Print"; see above), clicking Print; see above), rather than kprinter.
rather than kprinter.
.SS PAPER SIZE .SS PAPER SIZE
.TP 8 .TP 8
.B \-\-papersize \fIPAPERSIZE\fP .B \-\-papersize \fIPAPERSIZE\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Ask Tux Paint to generate
Ask \fITux Paint\fP to generate PostScript of a particular paper size. PostScript of a particular paper size. Valid sizes are those supported by
Valid sizes are those supported by libpaper. See papersize(5). libpaper. See papersize(5).
.SH OPTIONS - SAVING .SH OPTIONS - SAVING
.l .l
@ -651,86 +661,82 @@ instead of, or to override options set in configuration files. (See below.)
.SS SAVE OVER EARLIER WORK .SS SAVE OVER EARLIER WORK
.TP 8 .TP 8
.B \-\-saveover \-\-saveovernew \-\-saveoverask .B \-\-saveover \-\-saveovernew \-\-saveoverask
If, when saving a picture, an older version of the file will be overwritten, If, when saving a picture, an older version of the file will be
\fITux Paint\fP will, by default, ask for confirmation: either overwritten, Tux Paint will, by default, ask for confirmation: either save
\fIsave over\fP the old file, or \fIcreate\fP a new file. This prompt over the old file, or create a new file. This prompt can be disabled with
can be disabled with \fI\-\-saveover\fP (which always saves over older versions "--saveover" (which always saves over older versions of pictures) or
of pictures) or \fI\-\-saveovernew\fP (which always saves a new file). "--saveovernew" (which always saves a new file). The default is to prompt
The default is to prompt (\fI\-\-saveoverask\fP). ("--saveover").
.SS SAVE AND EXPORT DIRECTORIES .SS SAVE AND EXPORT DIRECTORIES
.TP 8 .TP 8
.B \-\-savedir \fIDIR\fP .B \-\-savedir \fIDIR\fP
Specify where \fITux Paint\fP should save and load its drawings. Specify where Tux Paint should save and load its drawings.
.TP 8 .TP 8
.B \-\-exportdir \fIDIR\fP .B \-\-exportdir \fIDIR\fP
Specify where \fITux Paint\fP should export drawings and animations. Specify where Tux Paint should export drawings and animations.
.SS MORE SAVING OPTIONS .SS MORE SAVING OPTIONS
.TP 8 .TP 8
.B \-\-nosave \-\-save .B \-\-nosave \-\-save
The \fInosave\fP option disables \fITux Paint's\fP ability to save files. The --nosave option disables Tux Paint's ability to save files. This can be
This can be used in situations where the program is only being used for used in situations where the program is only being used for fun, or in a
fun, or in a test environment. test environment.
.TP 8 .TP 8
.B \-\-autosave \-\-noautosave .B \-\-autosave \-\-noautosave
The \fIautosave\fP option prevents \fITux Paint\fP from asking whether you The --autosave option prevents ITux Paint P from asking whether you want
want to save the current picture when quitting, and assumes you do. to save the current picture when quitting, and assumes you do.
.SH OPTIONS - DATA FILES .SH OPTIONS - DATA FILES
.l .l
\fItuxpaint\fP accepts the following options to alter where Tux Paint \fItuxpaint\fP accepts the following options to alter where Tux Paint loads
loads data (stamps, brushes, etc.) They can be used along with, instead data (stamps, brushes, etc.) They can be used along with, instead of, or
of, or to override options set in configuration files. (See below.) to override options set in configuration files. (See below.)
.TP 8 .TP 8
.B \-\-datadir \fIDIR\fP .B \-\-datadir \fIDIR\fP
Specify where \fITux Paint\fP should look for personal data files Specify where Tux Paint should look for personal data files (brushes,
(brushes, stamps, etc.). stamps, etc.).
.TP 8 .TP 8
.B \-\-colorfile \fIFILE\fP .B \-\-colorfile \fIFILE\fP
This option allows you to override the default color palette in \fITux Paint\fP This option allows you to override the default color palette in Tux Paint
and replace it with your own. The file should be a plain ASCII text file and replace it with your own. The file should be a plain ASCII text file
containing one color description per line. Colors may be in decimal or containing one color description per line. Colors may be in decimal or 6-
6- or 3-digit hexadecimal, and followed by a description. (For example, or 3-digit hexadecimal, and followed by a description. (For example,
"\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".) "\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".)
.SH OPTIONS - LANGUAGE .SH OPTIONS - LANGUAGE
.l .l
\fItuxpaint\fP accepts the following options to alter the language used \fItuxpaint\fP accepts the following options to alter the language used by
by Tux Paint's interface, and other related settings. They can be used Tux Paint's interface, and other related settings. They can be used along
along with, instead of, or to override options set in configuration with, instead of, or to override options set in configuration
files. (See below.) files. (See below.)
.l .l
Various parts of \fITux Paint\fP have been translated into numerous languages. Various parts of Tux Paint have been translated into numerous languages.
\fITux Paint\fP will try its best to honor your \fIlocale\fP setting Tux Paint will try its best to honor your locale setting (i.e., the "LANG"
(i.e., the \fILANG\fP environment variable), if possible. environment variable), if possible. You can also specifically set the
You can also specifically set the language using options on the command-line language using options on the command-line or in a configuration file.
or in a configuration file.
.TP 8 .TP 8
.B \-\-locale \fILOCALE\fP .B \-\-locale \fILOCALE\fP
Specify the language to use, based on locale name (which is typically of the Specify the language to use, based on locale name (which is typically of
form \fIlanguage\fP[_\fIterritory\fP][.\fIcodeset\fP][@\fImodifier\fP], the form "language[_territory][.codeset][@modifier], where "language" is an
where \fIlanguage\fP is an ISO 639 language code, ISO 639 language code, "territory" is an ISO 3166 country code, and
\fIterritory\fP is an ISO 3166 country code, and "codeset" is a character set or encoding identifier like "ISO-8859-1" or
\fIcodeset\fP is a character set or encoding identifier like ISO-8859-1 or "UTF-8".)
UTF-8.)
.PP .PP
.RS .RS
For example, \fIde_DE@euro\fP for German, or \fIpt_BR\fP For example, "de_DE@euro" for German, or "pt_BR" for Brazilian Portuguese.
for Brazilian Portuguese.
.RE .RE
.TP 8 .TP 8
.B \-\-lang \fILANGUAGE\fP .B \-\-lang \fILANGUAGE\fP
Specify the language to use, based on the language's name Specify the language to use, based on the language's name (as recognized by
(as recognized by \fITux Paint\fP). Choose one of the language names Tux Paint). Choose one of the language names listed below:
listed below:
.PP .PP
.RS .RS
.PD 0 .PD 0
@ -1130,107 +1136,130 @@ Display a lists of all supported languages.
.TP 8 .TP 8
.B \-\-mirrorstamps \-\-dontmirrorstamps .B \-\-mirrorstamps \-\-dontmirrorstamps
With \fImirrorstamps\fP set, stamps which can be mirrored will appear With "--mirrorstamps" set, stamps which can be mirrored will appear
mirrored by default. This can be useful when used by people who prefer mirrored by default. This can be useful when used by people who prefer
things right-to-left over left-to-right. things right-to-left over left-to-right.
.SS FONTS .SS FONTS
.TP 8 .TP 8
.B \-\-nosysfonts \-\-sysfonts .B \-\-nosysfonts \-\-sysfonts
\fITux Paint\fP normally attempts to search for additional TrueType Fonts Tux Paint normally attempts to search for additional TrueType Fonts
installed in common places on your system. If this causes trouble, or you'd installed in common places on your system. If this causes trouble, or
prefer to only make fonts installed in \fITux Paint\fP's directory available, you'd prefer to only make fonts installed in Tux Paint's directory
use the \fInosysfonts\fP option to disable this feature. available, use the "--nosysfonts" option to disable this feature.
.TP 8 .TP 8
.B \-\-alllocalefonts \-\-currentlocalefont .B \-\-alllocalefonts \-\-currentlocalefont
Tux Paint avoids loading any fonts in its 'locale' font subdirectory, Tux Paint avoids loading any fonts found in its "locale" font subdirectory,
except any that match the current locale \fITux Paint\fP is running under. except any that match the current locale Tux Paint is running under. Use
Use the \fIalllocalefonts\fP option to load all such fonts, for use in the the "--alllocalefonts" option to load all such fonts, for use in the Text
"Text" tool. (This is the old behavior, prior to version 0.9.21.) and Label tools. (This was the default behavior, prior to version 0.9.21.)
.SH OPTIONS - MISCELLANEOUS .SH OPTIONS - MISCELLANEOUS
.l .l
\fItuxpaint\fP accepts the following options to alter its behavior. \fItuxpaint\fP accepts the following options to alter its behavior. They
They can be used along with, instead of, or to override options set in can be used along with, instead of, or to override options set in
configuration files. (See below.) configuration files. (See below.)
.TP 8 .TP 8
.B \-\-nosysconfig .B \-\-nosysconfig
With this option, \fITux Paint\fP will not attempt to read the With this option, Tux Paint will not attempt to read the system-wide
system-wide configuration file (typically \fI/etc/tuxpaint/tuxpaint.conf\fP). configuration file (typically "/etc/tuxpaint/tuxpaint.conf" or
"/usr/local/etc/tuxpaint/tuxpaint.conf").
.TP 8 .TP 8
.B \-\-nolockfile .B \-\-nolockfile
By default, \fITux Paint\fP uses a lockfile (stored in the user's By default, Tux Paint uses a lockfile (stored in the user's local Tux Paint directory) which prevents it from being launched more than once in 30 seconds. (Sometimes children get too eager, or user interfaces only require one click, but users think they need to double-click.) This option makes Tux Paint ignore the current lockfile.
local Tux Paint directory) which prevents it from being launched more than
once in 30 seconds. (Sometimes children get too eager, or user interfaces
only require one click, but users think they need to double-click.)
This option makes \fITux Paint\fP ignore the current lockfile.
.SH ENVIRONMENT .SH ENVIRONMENT
.ad l .ad l
While \fITux Paint\fP may refer to a number of environment variables indirectly While Tux Paint may refer to a number of environment variables indirectly
(e.g., via \fISDL(3)\fP), it only directly accesses the following: (e.g., via SDL(3)), it directly accesses the following: (See "FILES" below,
as well.)
.PP .PP
.TP 8 .TP 8
.B HOME .B HOME
to determine where picture files go when using the \fISave\fP and \fIOpen\fP to determine where picture files go when using the Save and Open commands
commands within \fITux Paint\fP, to keep track of the current image, within Tux Paint, to keep track of the current image, when quitting and
when quitting and restarting \fITux Paint\fP, and to get the user's restarting Tux Paint, and to get the user's configuration file.
configuration file.
.TP 8 .TP 8
.B LANG .B LANG, LC_ALL, LANGUAGE, and LC_MESSAGES
to determine language to use, if \fIsetlocale(3)\fP refers to 'LC_MESSAGES'. to determine language to use, if setlocale(3) refers to "LC_MESSAGES".
.TP 8
.B SDL_VIDEO_ALLOW_SCREENSAVER
Set this environment variable to '1' to allow a screensaver to appear while
Tux Paint is running. This can also be done via the "--allowscreensaver"
option.
.TP 8
.B SDL_VIDEO_WINDOW_POS
If this is NOT set, Tux Paint will set it to "center", to attempt to place
the Tux Paint window in the center of a display. If it IS set (e.g., to
"nopref", meaning "no preference"), Tux Paint will not override it.
.SH FILES .SH FILES
.TP 8 .TP 8
.B /etc/tuxpaint/tuxpaint.conf .B [/usr/local/]/etc/tuxpaint/tuxpaint.conf
System-wide configuration file. It is read first System-wide configuration file. It is read first (unless the
(unless the \fI\-\-nosysconfig\fP option was given on the command-line). "--nosysconfig" option was given on the command-line).
.RS .RS
.PP .PP
(Created during installation.) (Created during installation.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaintrc .B $HOME/.tuxpaintrc
User's configuration file. It can be used to set default options User's configuration file. It can be used to set default options (rather
(rather than setting them on the command-line every time), and/or to than setting them on the command-line every time), and/or to override any
override any settings in the system-wide configuration file. settings in the system-wide configuration file.
.RS .RS
.PP .PP
(Not created or edited automatically; must be created manually. (Not created or edited automatically; must be created manually. You can do
You can do this by hand, or use '\fITux Paint Config.\fP.') this by hand, or use tuxpaint-config(1).)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/saved/ .B $HOME/.tuxpaint/saved/
A directory of previously-saved images (and thumbnails). Only files in this A directory of previously-saved images (and thumbnails). Only files in
directory will be made available using the \fIOpen\fP command within this directory will be made available using the Open command within Tux
\fITux Paint\fP. (See \fItuxpaint-import(1)\fP.) Paint. Overridden via the "--savedir" option.
.RS .RS
.PP .PP
(Created when \fISave\fP command is used.) (Created when Save command is used.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/current_id.txt .B $HOME/.tuxpaint/current_id.txt
A reference to the image which was being edited when \fITux Paint\fP was A reference to the image which was being edited when Tux Paint was last
last quit. (This image is automatically loaded the next time \fITux Paint\fP quit. (This image is automatically loaded the next time Tux Paint is
is re-run.) re-run, unless the "--startblank" option is set.)
.RS .RS
.PP .PP
(Created when \fITux Paint\fP is \fIQuit\fP.) (Created when Tux Paint is Quit.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/lockfile.dat .B $HOME/.tuxpaint/lockfile.dat
A lockfile that prevents \fITux Paint\fP from being launched more than once A lockfile that prevents Tux Paint from being launched more than once every
every 30 seconds. Disable checking the lockfile by using the 30 seconds. Disable checking the lockfile by using the "--nolockfile"
\'\-\-nolockfile\' command-line argument. option.
.RS .RS
.PP .PP
(There's no reason to delete the lockfile, as it contains a timestamp (There's no reason to delete the lockfile, as it contains a timestamp
inside which causes it to expire after 30 seconds.) inside which causes it to expire after 30 seconds.)
.RE .RE
.TP 8
.B $XDG_CONFIG_HOME[XDG_PICTURES_DIR]/TuxPaint/
A directory where images and animations should be exported (via options
found in Tux Paint's Open dialog), if the "--exportdir" option is not used
to override it. If "$XDG_CONFIG_HOME" is set, a configuration file
"user-dirs.dirs" will be scanned within the directory it points to; if not,
Tux Paint will attempt to do so within "$HOME/.config/". If a setting
named "XDG_PICTURES_DIR" is found, it will be used as the location to
export images. If all else fails, then "$HOME/Pictures/" will be used. A
"TuxPaint" subdirectory will be created.
.TP 8
.B $XDG_DATA_HOME/Trash/ or $HOME/.local/share/Trash/
A directory where images are placed when the Erase option is used from the
Open dialog.
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify it This program is free software; you can redistribute it and/or modify it
@ -1515,4 +1544,4 @@ Huang Zuzhen.
.BR krita (1), .BR krita (1),
.BR gcompris (1) .BR gcompris (1)
.PP .PP
And documentation within /usr/[local/]share/doc/tuxpaint/.

355
man/gl_ES.UTF-8/tuxpaint.1
View file

@ -377,22 +377,22 @@ blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
List solid (blank) colors at the end, or beginning (default) of the List solid (blank) colors at the end, or beginning (default) of the options
options displayed when using the \fINew\fP tool to start a new picture. displayed when using the New tool to start a new picture.
.SS CONTROL SIMPLIFICATION .SS CONTROL SIMPLIFICATION
.TP 8 .TP 8
.B \-\-noquit \-\-quit .B \-\-noquit \-\-quit
Disable or enable (default) the on-screen Quit button and [Escape] Disable or enable (default) the on-screen Quit button and [Escape] key for
key for quitting Tux Paint. Instead, use the window close quitting Tux Paint. Instead, use the window close button in the titlebar,
button in the titlebar, the [Al]+[F4] key sequence, or the the [Alt]+[F4] key sequence, or the [Shift]+[Control]+[Escape] key
[Shift]+[Control]+[Escape] key sequence. sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With "--nostamps" set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the Stamps
Stamps tool will not be available. This option can be used to reduce tool will not be available. This option can be used to reduce the time Tux
the time Tux Paint takes to load, and reduce the amount of RAM it requires. Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
.B \-\-nostampcontrols \-\-stampcontrols .B \-\-nostampcontrols \-\-stampcontrols
@ -402,9 +402,9 @@ in all ways.)
.TP 8 .TP 8
.B \-\-nomagiccontrols \-\-magiccontrols .B \-\-nomagiccontrols \-\-magiccontrols
Disable or enable (default) buttons to control Magic tools. Controls include Disable or enable (default) buttons to control Magic tools. Controls
controlling whether a Magic tool is used like a paint brush, or if it include controlling whether a Magic tool is used like a paint brush, or if
affects the entire image at once. (Note: Not all Magic tools will be it affects the entire image at once. (Note: Not all Magic tools will be
controllable.) controllable.)
.TP 8 .TP 8
@ -415,14 +415,14 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the Label tool, which lets you create Disable or enable (default) the Label tool, which lets you create text
text which can be altered or moved later. which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
.l .l
\fItuxpaint\fP accepts the following options to alter how you control \fItuxpaint\fP accepts the following options to alter how you control Tux
Tux Paint. They can be used along with, instead of, or to override options Paint. They can be used along with, instead of, or to override options set
set in configuration files. (See below.) in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
@ -433,14 +433,13 @@ trouble displaying the mouse pointer, and/or leave 'trails' on the screen.
.TP 8 .TP 8
.B \-\-hidecursor \-\-showcursor .B \-\-hidecursor \-\-showcursor
Completely hide, or enable (default) the mouse pointer in Tux Paint. Completely hide, or enable (default) the mouse pointer in Tux Paint. This
This can be useful on touchscreen devices, such as tablet PCs. can be useful on touchscreen devices, such as tablet PCs.
.SS KEYBOARD .SS KEYBOARD
.TP 8 .TP 8
.B \-\-noshortcuts \-\-shortcuts .B \-\-noshortcuts \-\-shortcuts
If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) <? /* --[no]shortcuts */ wordwrap(sprintf(gettext(If \"%s\" mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) will be disabled. Default mode is for shortcuts to be enabled."), "--noshortcuts")) . "\n" ?>
will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
@ -451,36 +450,35 @@ confined to the Tux Paint window. Default is to not grab.
.TP 8 .TP 8
.B \-\-nowheelmouse \-\-wheelmouse .B \-\-nowheelmouse \-\-wheelmouse
By default, the wheel (jog dial) on a mouse will be used to scroll the By default, the wheel (jog dial) on a mouse will be used to scroll the
'selector' on the right of the screen. This can be disabled, and the 'selector' on the right of the screen. This can be disabled, and the wheel
wheel completely ignored, with the \fI\-\-nowheelmouse\fP option. completely ignored, with the "--nowheelmouse" option. This is useful for
This is useful for children who aren't yet comfortable with the mouse. children who aren't yet comfortable with the mouse. Default is to support
Default is to support the wheel. the wheel.
.TP 8 .TP 8
.B \-\-mouse-accessibility .B \-\-mouse-accessibility
In this mode, instead of clicking, dragging and releasing (e.g., to draw), Neste modo, no canto de premer, arrastrar e soltar (por exemplo, para
you click, move, and click again to end the motion. debuxar), premese, móvese e premese de novo para rematar o movemento.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The "--keyboard" option lets the mouse pointer in Tux Paint be The "--keyboard" option lets the mouse pointer in Tux Paint be controlled
controlled with the keyboard. The [Up], [Down], [Left], and [Right] with the keyboard. The [Up], [Down], [Left], and [Right] arrow keys move
arrow keys move the pointer. [Spacebar] acts as the mouse button. the pointer. [Spacebar] acts as the mouse button.
.TP 8 .TP 8
.B \-\-nobuttondistinction \-\-buttondistinction .B \-\-nobuttondistinction \-\-buttondistinction
By default, only mouse button #1 (typically the leftmost mouse button By default, only mouse button #1 (typically the leftmost mouse button on
on mice with more than one button) can be used for interacting with mice with more than one button) can be used for interacting with Tux Paint.
Tux Paint. With the "--nobuttondistinction" option, With the "--nobuttondistinction" option, mouse buttons #2 (middle) and #3
mouse buttons #2 (middle) and #3 (right) can be used, as well. (right) can be used, as well. This is useful for children who aren't yet
This is useful for children who aren't yet comfortable with the mouse. comfortable with the mouse. Default is to only recognize button #1.
Default is to only recognize button #1.
.SS ONSCREEN KEYBOARD .SS ONSCREEN KEYBOARD
.TP 8 .TP 8
.B \-\-onscreen-keyboard .B \-\-onscreen-keyboard
Presents a clickable on-screen keyboard when using the Text and Presents a clickable on-screen keyboard when using the Text and Label
Label tools. tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -494,40 +492,53 @@ which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
.B \-\-joystick-dev=\fIDEVICE\fP .B \-\-joystick-dev=\fIDEVICE\fP
Specify which joystick device should be used by Tux Paint. Default value is 0 (the first joystick). Especifica que dispositivo de mando debe ser usado por Tux Paint. O valor
predeterminado é 0 (a primeira panca de mando — joystick).
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List the system's available joysticks and exit. (Does not launch Tux Paint.) List the system's available joysticks and exit. (Does not launch Tux
Paint.)
.TP 8 .TP 8
.B \-\-joystick-slowness=\fIVELOCIDADE\fP .B \-\-joystick-slowness=\fIVELOCIDADE\fP
Sets a delay at each axis motion, allowing to slow the joystick. Allowed values are from 0 to 500. Default value is 15. Estabelece un atraso en cada movemento do eixo, permitindo atrasar a panca
de mando (joystick). Os valores permitidos van de 0 a 500. O valor
predeterminado é 15.
.TP 8 .TP 8
.B \-\-joystick-threshold=\fILIMIAR\fP .B \-\-joystick-threshold=\fILIMIAR\fP
Sets the minimum level of axis motion to start moving the pointer. Allowed values are from 0 to 32766. Default value is 3200. Estabelece o nivel mínimo de movemento do eixe para comezar a mover o
punteiro. Os valores permitidos son de 0 a 32766. O valor predeterminado é
3200.
.TP 8 .TP 8
.B \-\-joystick-maxsteps=\fIPASOS\fP .B \-\-joystick-maxsteps=\fIPASOS\fP
Sets the maximum pixels the pointer will move at once. Allowed values are from 1 to 7. Default value is 7. Define os píxeles máximos que moverá o punteiro á vez. Os valores
permitidos van do 1 ao 7. O valor predeterminado é 7.
.TP 8 .TP 8
.B \-\-joystick-hat-timeout=\fIMILISEGUNDOS\fP .B \-\-joystick-hat-timeout=\fIMILISEGUNDOS\fP
Sets the delay after wich the pointer will start moving automatically if the hat is keeped pushed. Allowed values are from 0 to 3000. Default value is 1000. Estabelece o atraso após de que o punteiro comezará a moverse
automaticamente se se mantén premido o sombreiro. Os valores permitidos
van de 0 a 3000. O valor predeterminado é 1000.
.TP 8 .TP 8
.B \-\-joystick-hat-slowness=\fIVELOCIDADE\fP .B \-\-joystick-hat-slowness=\fIVELOCIDADE\fP
Sets a delay at each automatic motion, allowing to slow the speed of the hat. Allowed values are from 0 to 500. Default value is 15. Estabelece un atraso en cada movemento automático, o que permite diminuír
a velocidade do sombreiro. Os valores permitidos van de 0 a 500. O valor
predeterminado é 15.
.TP 8 .TP 8
.B \-\-joystick-btn-escape=\fIBUTTON\fP .B \-\-joystick-btn-escape=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be used to generate a escape event. Useful to dismiss dialogs and quit. Selecciona o número do botón da panca de control (joystick), tal e como o
ve SDL, que se usará para xerar un evento de escape. Útil para desactivar
os diálogos e saír.
.TP 8 .TP 8
.B \-\-joystick-btn-\fIORDE\fP=\fIBUTTON\fP .B \-\-joystick-btn-\fIORDE\fP=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be a shortcut to Selects the joystick button number, as seen by SDL, that will be a shortcut
various tools within Tux Paint. to various tools within Tux Paint.
.PP .PP
.RS .RS
@ -579,16 +590,15 @@ print | Print (immediate)
.TP 8 .TP 8
.B \-\-joystick-buttons-ignore=\fIBOTÓN1,BOTÓN2,...\fP .B \-\-joystick-buttons-ignore=\fIBOTÓN1,BOTÓN2,...\fP
A set of joystick button numbers, as seen by SDL, that should A set of joystick button numbers, as seen by SDL, that should be ignored.
be ignored. Otherwise, unless they are used by one of the Otherwise, unless they are used by one of the "--joystick-btn-..." options
"--joystick-btn-..." options above, buttons will be seen as a mouse above, buttons will be seen as a mouse left-click. Comma-separated.
left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
.l .l
\fItuxpaint\fP accepts the following options to alter how Tux Paint \fItuxpaint\fP accepts the following options to alter how Tux Paint handles
handles printing. They can be used along with, instead of, or to printing. They can be used along with, instead of, or to override options
override options set in configuration files. (See below.) set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
@ -597,50 +607,48 @@ Disable or enable (default) the Print command within Tux Paint.
.TP 8 .TP 8
.B \-\-printdelay=\fISEGUNDOS\fP \-\-printdelay=0 .B \-\-printdelay=\fISEGUNDOS\fP \-\-printdelay=0
Only allow printing (via the \fIPrint\fP command) once every \fISECONDS\fP Only allow printing (via the Print command) once every SECONDS seconds.
seconds. Default is 0 (no limitation). Default is 0 (no limitation).
.SS SHOW PRINTER DIALOG .SS SHOW PRINTER DIALOG
.TP 8 .TP 8
.B \-\-altprintmod \-\-altprintnever \-\-altprintalways .B \-\-altprintmod \-\-altprintnever \-\-altprintalways
These options control whether an system printer dialog appears when the These options control whether an system printer dialog appears when the
user clicks the \fIPrint\fP button. By default (\-\-altprintmod), pressing user clicks the Print button. By default ("--altprintmod"), pressing [Alt]
\fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're while clicking Print will bring up a dialog (unless you're in fullscreen
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, mode). With "--altprintalways", the dialog will always appear, even if
even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog [Alt] is not being held. With "--altprintnever", the dialog will never
will never appear, even if \fI[Alt]\fP is being held. appear, even if [Alt] is being held.
.SS SAVE PRINTER CONFIGURATION .SS SAVE PRINTER CONFIGURATION
.TP 8 .TP 8
.B \-\-printcfg \-\-noprintcfg .B \-\-printcfg \-\-noprintcfg
(Windows and Mac OS X only.) Enable or disable loading and saving of (Windows and Mac OS X only.) Enable or disable loading and saving of
printer settings. By default, \fITux Paint\fP will print to the default printer settings. By default, Tux Paint will print to the default printer
printer with default settings. Pressing \fI[Alt]\fP while pushing the with default settings. Pressing [Alt] while pushing the Print button will
\fIPrint\fP button will cause a printer dialog to appear (as long as you're cause a printer dialog to appear (as long as you're not in fullscreen mode;
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, see also "--altprintalways" and "--altprintnever", below.) Unless
below.) Unless \-\-noprintcfg is used, your previous settings will "--noprintcfg" is used, your previous settings will be loaded when Tux
be loaded when \fITux Paint\fP starts up, and setting changes will be saved Paint starts up, and setting changes will be saved for next time.
for next time.
.SS PRINT COMMANDS .SS PRINT COMMANDS
.TP 8 .TP 8
.B \-\-printcommand \fIORDE\fP .B \-\-printcommand \fIORDE\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.)
Have Tux Paint print via an alternate command, rather than lpr(1). Have Tux Paint print via an alternate command, rather than lpr(1).
.TP 8 .TP 8
.B \-\-altprintcommand \fIORDE\fP .B \-\-altprintcommand \fIORDE\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Have Tux Paint print via an
Have Tux Paint print via an alternate command, when a dialog is expect alternate command, when a dialog is expect (e.g., when holding [Alt] while
(e.g., when holding \fI[Alt]\fP while clicking "Print"; see above), clicking Print; see above), rather than kprinter.
rather than kprinter.
.SS PAPER SIZE .SS PAPER SIZE
.TP 8 .TP 8
.B \-\-papersize \fITAMAÑO_DO_PAPEL\fP .B \-\-papersize \fITAMAÑO_DO_PAPEL\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Ask Tux Paint to generate
Ask \fITux Paint\fP to generate PostScript of a particular paper size. PostScript of a particular paper size. Valid sizes are those supported by
Valid sizes are those supported by libpaper. See papersize(5). libpaper. See papersize(5).
.SH OPTIONS - SAVING .SH OPTIONS - SAVING
.l .l
@ -651,86 +659,82 @@ instead of, or to override options set in configuration files. (See below.)
.SS SAVE OVER EARLIER WORK .SS SAVE OVER EARLIER WORK
.TP 8 .TP 8
.B \-\-saveover \-\-saveovernew \-\-saveoverask .B \-\-saveover \-\-saveovernew \-\-saveoverask
If, when saving a picture, an older version of the file will be overwritten, If, when saving a picture, an older version of the file will be
\fITux Paint\fP will, by default, ask for confirmation: either overwritten, Tux Paint will, by default, ask for confirmation: either save
\fIsave over\fP the old file, or \fIcreate\fP a new file. This prompt over the old file, or create a new file. This prompt can be disabled with
can be disabled with \fI\-\-saveover\fP (which always saves over older versions "--saveover" (which always saves over older versions of pictures) or
of pictures) or \fI\-\-saveovernew\fP (which always saves a new file). "--saveovernew" (which always saves a new file). The default is to prompt
The default is to prompt (\fI\-\-saveoverask\fP). ("--saveover").
.SS SAVE AND EXPORT DIRECTORIES .SS SAVE AND EXPORT DIRECTORIES
.TP 8 .TP 8
.B \-\-savedir \fIDIR\fP .B \-\-savedir \fIDIR\fP
Specify where \fITux Paint\fP should save and load its drawings. Specify where Tux Paint should save and load its drawings.
.TP 8 .TP 8
.B \-\-exportdir \fIDIR\fP .B \-\-exportdir \fIDIR\fP
Specify where \fITux Paint\fP should export drawings and animations. Specify where Tux Paint should export drawings and animations.
.SS MORE SAVING OPTIONS .SS MORE SAVING OPTIONS
.TP 8 .TP 8
.B \-\-nosave \-\-save .B \-\-nosave \-\-save
The \fInosave\fP option disables \fITux Paint's\fP ability to save files. The --nosave option disables Tux Paint's ability to save files. This can be
This can be used in situations where the program is only being used for used in situations where the program is only being used for fun, or in a
fun, or in a test environment. test environment.
.TP 8 .TP 8
.B \-\-autosave \-\-noautosave .B \-\-autosave \-\-noautosave
The \fIautosave\fP option prevents \fITux Paint\fP from asking whether you The --autosave option prevents ITux Paint P from asking whether you want
want to save the current picture when quitting, and assumes you do. to save the current picture when quitting, and assumes you do.
.SH OPTIONS - DATA FILES .SH OPTIONS - DATA FILES
.l .l
\fItuxpaint\fP accepts the following options to alter where Tux Paint \fItuxpaint\fP accepts the following options to alter where Tux Paint loads
loads data (stamps, brushes, etc.) They can be used along with, instead data (stamps, brushes, etc.) They can be used along with, instead of, or
of, or to override options set in configuration files. (See below.) to override options set in configuration files. (See below.)
.TP 8 .TP 8
.B \-\-datadir \fIDIR\fP .B \-\-datadir \fIDIR\fP
Specify where \fITux Paint\fP should look for personal data files Specify where Tux Paint should look for personal data files (brushes,
(brushes, stamps, etc.). stamps, etc.).
.TP 8 .TP 8
.B \-\-colorfile \fIFICHEIRO\fP .B \-\-colorfile \fIFICHEIRO\fP
This option allows you to override the default color palette in \fITux Paint\fP This option allows you to override the default color palette in Tux Paint
and replace it with your own. The file should be a plain ASCII text file and replace it with your own. The file should be a plain ASCII text file
containing one color description per line. Colors may be in decimal or containing one color description per line. Colors may be in decimal or 6-
6- or 3-digit hexadecimal, and followed by a description. (For example, or 3-digit hexadecimal, and followed by a description. (For example,
"\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".) "\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".)
.SH OPTIONS - LANGUAGE .SH OPTIONS - LANGUAGE
.l .l
\fItuxpaint\fP accepts the following options to alter the language used \fItuxpaint\fP accepts the following options to alter the language used by
by Tux Paint's interface, and other related settings. They can be used Tux Paint's interface, and other related settings. They can be used along
along with, instead of, or to override options set in configuration with, instead of, or to override options set in configuration
files. (See below.) files. (See below.)
.l .l
Various parts of \fITux Paint\fP have been translated into numerous languages. Various parts of Tux Paint have been translated into numerous languages.
\fITux Paint\fP will try its best to honor your \fIlocale\fP setting Tux Paint will try its best to honor your locale setting (i.e., the "LANG"
(i.e., the \fILANG\fP environment variable), if possible. environment variable), if possible. You can also specifically set the
You can also specifically set the language using options on the command-line language using options on the command-line or in a configuration file.
or in a configuration file.
.TP 8 .TP 8
.B \-\-locale \fIIDIOMA\fP .B \-\-locale \fIIDIOMA\fP
Specify the language to use, based on locale name (which is typically of the Specify the language to use, based on locale name (which is typically of
form \fIlanguage\fP[_\fIterritory\fP][.\fIcodeset\fP][@\fImodifier\fP], the form "language[_territory][.codeset][@modifier], where "language" is an
where \fIlanguage\fP is an ISO 639 language code, ISO 639 language code, "territory" is an ISO 3166 country code, and
\fIterritory\fP is an ISO 3166 country code, and "codeset" is a character set or encoding identifier like "ISO-8859-1" or
\fIcodeset\fP is a character set or encoding identifier like ISO-8859-1 or "UTF-8".)
UTF-8.)
.PP .PP
.RS .RS
For example, \fIde_DE@euro\fP for German, or \fIpt_BR\fP For example, "de_DE@euro" for German, or "pt_BR" for Brazilian Portuguese.
for Brazilian Portuguese.
.RE .RE
.TP 8 .TP 8
.B \-\-lang \fILANGUAGE\fP .B \-\-lang \fIIDIOMA\fP
Specify the language to use, based on the language's name Specify the language to use, based on the language's name (as recognized by
(as recognized by \fITux Paint\fP). Choose one of the language names Tux Paint). Choose one of the language names listed below:
listed below:
.PP .PP
.RS .RS
.PD 0 .PD 0
@ -1130,107 +1134,130 @@ Display a lists of all supported languages.
.TP 8 .TP 8
.B \-\-mirrorstamps \-\-dontmirrorstamps .B \-\-mirrorstamps \-\-dontmirrorstamps
With \fImirrorstamps\fP set, stamps which can be mirrored will appear With "--mirrorstamps" set, stamps which can be mirrored will appear
mirrored by default. This can be useful when used by people who prefer mirrored by default. This can be useful when used by people who prefer
things right-to-left over left-to-right. things right-to-left over left-to-right.
.SS FONTS .SS FONTS
.TP 8 .TP 8
.B \-\-nosysfonts \-\-sysfonts .B \-\-nosysfonts \-\-sysfonts
\fITux Paint\fP normally attempts to search for additional TrueType Fonts Tux Paint normally attempts to search for additional TrueType Fonts
installed in common places on your system. If this causes trouble, or you'd installed in common places on your system. If this causes trouble, or
prefer to only make fonts installed in \fITux Paint\fP's directory available, you'd prefer to only make fonts installed in Tux Paint's directory
use the \fInosysfonts\fP option to disable this feature. available, use the "--nosysfonts" option to disable this feature.
.TP 8 .TP 8
.B \-\-alllocalefonts \-\-currentlocalefont .B \-\-alllocalefonts \-\-currentlocalefont
Tux Paint avoids loading any fonts in its 'locale' font subdirectory, Tux Paint avoids loading any fonts found in its "locale" font subdirectory,
except any that match the current locale \fITux Paint\fP is running under. except any that match the current locale Tux Paint is running under. Use
Use the \fIalllocalefonts\fP option to load all such fonts, for use in the the "--alllocalefonts" option to load all such fonts, for use in the Text
"Text" tool. (This is the old behavior, prior to version 0.9.21.) and Label tools. (This was the default behavior, prior to version 0.9.21.)
.SH OPTIONS - MISCELLANEOUS .SH OPTIONS - MISCELLANEOUS
.l .l
\fItuxpaint\fP accepts the following options to alter its behavior. \fItuxpaint\fP accepts the following options to alter its behavior. They
They can be used along with, instead of, or to override options set in can be used along with, instead of, or to override options set in
configuration files. (See below.) configuration files. (See below.)
.TP 8 .TP 8
.B \-\-nosysconfig .B \-\-nosysconfig
With this option, \fITux Paint\fP will not attempt to read the With this option, Tux Paint will not attempt to read the system-wide
system-wide configuration file (typically \fI/etc/tuxpaint/tuxpaint.conf\fP). configuration file (typically "/etc/tuxpaint/tuxpaint.conf" or
"/usr/local/etc/tuxpaint/tuxpaint.conf").
.TP 8 .TP 8
.B \-\-nolockfile .B \-\-nolockfile
By default, \fITux Paint\fP uses a lockfile (stored in the user's By default, Tux Paint uses a lockfile (stored in the user's local Tux Paint directory) which prevents it from being launched more than once in 30 seconds. (Sometimes children get too eager, or user interfaces only require one click, but users think they need to double-click.) This option makes Tux Paint ignore the current lockfile.
local Tux Paint directory) which prevents it from being launched more than
once in 30 seconds. (Sometimes children get too eager, or user interfaces
only require one click, but users think they need to double-click.)
This option makes \fITux Paint\fP ignore the current lockfile.
.SH ENVIRONMENT .SH ENVIRONMENT
.ad l .ad l
While \fITux Paint\fP may refer to a number of environment variables indirectly While Tux Paint may refer to a number of environment variables indirectly
(e.g., via \fISDL(3)\fP), it only directly accesses the following: (e.g., via SDL(3)), it directly accesses the following: (See "FILES" below,
as well.)
.PP .PP
.TP 8 .TP 8
.B HOME .B HOME
to determine where picture files go when using the \fISave\fP and \fIOpen\fP to determine where picture files go when using the Save and Open commands
commands within \fITux Paint\fP, to keep track of the current image, within Tux Paint, to keep track of the current image, when quitting and
when quitting and restarting \fITux Paint\fP, and to get the user's restarting Tux Paint, and to get the user's configuration file.
configuration file.
.TP 8 .TP 8
.B LANG .B LANG, LC_ALL, LANGUAGE, and LC_MESSAGES
to determine language to use, if \fIsetlocale(3)\fP refers to 'LC_MESSAGES'. to determine language to use, if setlocale(3) refers to "LC_MESSAGES".
.TP 8
.B SDL_VIDEO_ALLOW_SCREENSAVER
Set this environment variable to '1' to allow a screensaver to appear while
Tux Paint is running. This can also be done via the "--allowscreensaver"
option.
.TP 8
.B SDL_VIDEO_WINDOW_POS
If this is NOT set, Tux Paint will set it to "center", to attempt to place
the Tux Paint window in the center of a display. If it IS set (e.g., to
"nopref", meaning "no preference"), Tux Paint will not override it.
.SH FILES .SH FILES
.TP 8 .TP 8
.B /etc/tuxpaint/tuxpaint.conf .B [/usr/local/]/etc/tuxpaint/tuxpaint.conf
System-wide configuration file. It is read first System-wide configuration file. It is read first (unless the
(unless the \fI\-\-nosysconfig\fP option was given on the command-line). "--nosysconfig" option was given on the command-line).
.RS .RS
.PP .PP
(Created during installation.) (Created during installation.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaintrc .B $HOME/.tuxpaintrc
User's configuration file. It can be used to set default options User's configuration file. It can be used to set default options (rather
(rather than setting them on the command-line every time), and/or to than setting them on the command-line every time), and/or to override any
override any settings in the system-wide configuration file. settings in the system-wide configuration file.
.RS .RS
.PP .PP
(Not created or edited automatically; must be created manually. (Not created or edited automatically; must be created manually. You can do
You can do this by hand, or use '\fITux Paint Config.\fP.') this by hand, or use tuxpaint-config(1).)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/saved/ .B $HOME/.tuxpaint/saved/
A directory of previously-saved images (and thumbnails). Only files in this A directory of previously-saved images (and thumbnails). Only files in
directory will be made available using the \fIOpen\fP command within this directory will be made available using the Open command within Tux
\fITux Paint\fP. (See \fItuxpaint-import(1)\fP.) Paint. Overridden via the "--savedir" option.
.RS .RS
.PP .PP
(Created when \fISave\fP command is used.) (Created when Save command is used.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/current_id.txt .B $HOME/.tuxpaint/current_id.txt
A reference to the image which was being edited when \fITux Paint\fP was A reference to the image which was being edited when Tux Paint was last
last quit. (This image is automatically loaded the next time \fITux Paint\fP quit. (This image is automatically loaded the next time Tux Paint is
is re-run.) re-run, unless the "--startblank" option is set.)
.RS .RS
.PP .PP
(Created when \fITux Paint\fP is \fIQuit\fP.) (Created when Tux Paint is Quit.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/lockfile.dat .B $HOME/.tuxpaint/lockfile.dat
A lockfile that prevents \fITux Paint\fP from being launched more than once A lockfile that prevents Tux Paint from being launched more than once every
every 30 seconds. Disable checking the lockfile by using the 30 seconds. Disable checking the lockfile by using the "--nolockfile"
\'\-\-nolockfile\' command-line argument. option.
.RS .RS
.PP .PP
(There's no reason to delete the lockfile, as it contains a timestamp (There's no reason to delete the lockfile, as it contains a timestamp
inside which causes it to expire after 30 seconds.) inside which causes it to expire after 30 seconds.)
.RE .RE
.TP 8
.B $XDG_CONFIG_HOME[XDG_PICTURES_DIR]/TuxPaint/
A directory where images and animations should be exported (via options
found in Tux Paint's Open dialog), if the "--exportdir" option is not used
to override it. If "$XDG_CONFIG_HOME" is set, a configuration file
"user-dirs.dirs" will be scanned within the directory it points to; if not,
Tux Paint will attempt to do so within "$HOME/.config/". If a setting
named "XDG_PICTURES_DIR" is found, it will be used as the location to
export images. If all else fails, then "$HOME/Pictures/" will be used. A
"TuxPaint" subdirectory will be created.
.TP 8
.B $XDG_DATA_HOME/Trash/ or $HOME/.local/share/Trash/
A directory where images are placed when the Erase option is used from the
Open dialog.
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify it This program is free software; you can redistribute it and/or modify it
@ -1515,4 +1542,4 @@ Huang Zuzhen.
.BR krita (1), .BR krita (1),
.BR gcompris (1) .BR gcompris (1)
.PP .PP
And documentation within /usr/[local/]share/doc/tuxpaint/.

351
man/ja_JP.UTF-8/tuxpaint.1
View file

@ -377,22 +377,22 @@ blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
List solid (blank) colors at the end, or beginning (default) of the List solid (blank) colors at the end, or beginning (default) of the options
options displayed when using the \fINew\fP tool to start a new picture. displayed when using the New tool to start a new picture.
.SS CONTROL SIMPLIFICATION .SS CONTROL SIMPLIFICATION
.TP 8 .TP 8
.B \-\-noquit \-\-quit .B \-\-noquit \-\-quit
Disable or enable (default) the on-screen Quit button and [Escape] Disable or enable (default) the on-screen Quit button and [Escape] key for
key for quitting Tux Paint. Instead, use the window close quitting Tux Paint. Instead, use the window close button in the titlebar,
button in the titlebar, the [Al]+[F4] key sequence, or the the [Alt]+[F4] key sequence, or the [Shift]+[Control]+[Escape] key
[Shift]+[Control]+[Escape] key sequence. sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With "--nostamps" set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the Stamps
Stamps tool will not be available. This option can be used to reduce tool will not be available. This option can be used to reduce the time Tux
the time Tux Paint takes to load, and reduce the amount of RAM it requires. Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
.B \-\-nostampcontrols \-\-stampcontrols .B \-\-nostampcontrols \-\-stampcontrols
@ -402,9 +402,9 @@ in all ways.)
.TP 8 .TP 8
.B \-\-nomagiccontrols \-\-magiccontrols .B \-\-nomagiccontrols \-\-magiccontrols
Disable or enable (default) buttons to control Magic tools. Controls include Disable or enable (default) buttons to control Magic tools. Controls
controlling whether a Magic tool is used like a paint brush, or if it include controlling whether a Magic tool is used like a paint brush, or if
affects the entire image at once. (Note: Not all Magic tools will be it affects the entire image at once. (Note: Not all Magic tools will be
controllable.) controllable.)
.TP 8 .TP 8
@ -415,14 +415,14 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the Label tool, which lets you create Disable or enable (default) the Label tool, which lets you create text
text which can be altered or moved later. which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
.l .l
\fItuxpaint\fP accepts the following options to alter how you control \fItuxpaint\fP accepts the following options to alter how you control Tux
Tux Paint. They can be used along with, instead of, or to override options Paint. They can be used along with, instead of, or to override options set
set in configuration files. (See below.) in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
@ -433,14 +433,13 @@ trouble displaying the mouse pointer, and/or leave 'trails' on the screen.
.TP 8 .TP 8
.B \-\-hidecursor \-\-showcursor .B \-\-hidecursor \-\-showcursor
Completely hide, or enable (default) the mouse pointer in Tux Paint. Completely hide, or enable (default) the mouse pointer in Tux Paint. This
This can be useful on touchscreen devices, such as tablet PCs. can be useful on touchscreen devices, such as tablet PCs.
.SS KEYBOARD .SS KEYBOARD
.TP 8 .TP 8
.B \-\-noshortcuts \-\-shortcuts .B \-\-noshortcuts \-\-shortcuts
If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) <? /* --[no]shortcuts */ wordwrap(sprintf(gettext(If \"%s\" mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save) will be disabled. Default mode is for shortcuts to be enabled."), "--noshortcuts")) . "\n" ?>
will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
@ -451,36 +450,34 @@ confined to the Tux Paint window. Default is to not grab.
.TP 8 .TP 8
.B \-\-nowheelmouse \-\-wheelmouse .B \-\-nowheelmouse \-\-wheelmouse
By default, the wheel (jog dial) on a mouse will be used to scroll the By default, the wheel (jog dial) on a mouse will be used to scroll the
'selector' on the right of the screen. This can be disabled, and the 'selector' on the right of the screen. This can be disabled, and the wheel
wheel completely ignored, with the \fI\-\-nowheelmouse\fP option. completely ignored, with the "--nowheelmouse" option. This is useful for
This is useful for children who aren't yet comfortable with the mouse. children who aren't yet comfortable with the mouse. Default is to support
Default is to support the wheel. the wheel.
.TP 8 .TP 8
.B \-\-mouse-accessibility .B \-\-mouse-accessibility
In this mode, instead of clicking, dragging and releasing (e.g., to draw), 例えば「せん」ツールなどでは、マウスをクリックしてドラッグした後にマウスボタンを放すというのが標準の操作ですが、このモードを設定すると、マウスをクリックしてからマウスを動かした後に再度マウスをクリックするという操作になります。
you click, move, and click again to end the motion.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The "--keyboard" option lets the mouse pointer in Tux Paint be The "--keyboard" option lets the mouse pointer in Tux Paint be controlled
controlled with the keyboard. The [Up], [Down], [Left], and [Right] with the keyboard. The [Up], [Down], [Left], and [Right] arrow keys move
arrow keys move the pointer. [Spacebar] acts as the mouse button. the pointer. [Spacebar] acts as the mouse button.
.TP 8 .TP 8
.B \-\-nobuttondistinction \-\-buttondistinction .B \-\-nobuttondistinction \-\-buttondistinction
By default, only mouse button #1 (typically the leftmost mouse button By default, only mouse button #1 (typically the leftmost mouse button on
on mice with more than one button) can be used for interacting with mice with more than one button) can be used for interacting with Tux Paint.
Tux Paint. With the "--nobuttondistinction" option, With the "--nobuttondistinction" option, mouse buttons #2 (middle) and #3
mouse buttons #2 (middle) and #3 (right) can be used, as well. (right) can be used, as well. This is useful for children who aren't yet
This is useful for children who aren't yet comfortable with the mouse. comfortable with the mouse. Default is to only recognize button #1.
Default is to only recognize button #1.
.SS ONSCREEN KEYBOARD .SS ONSCREEN KEYBOARD
.TP 8 .TP 8
.B \-\-onscreen-keyboard .B \-\-onscreen-keyboard
Presents a clickable on-screen keyboard when using the Text and Presents a clickable on-screen keyboard when using the Text and Label
Label tools. tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -494,40 +491,52 @@ which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
.B \-\-joystick-dev=\fIDEVICE\fP .B \-\-joystick-dev=\fIDEVICE\fP
Specify which joystick device should be used by Tux Paint. Default value is 0 (the first joystick). 何番目のジョイスティックデバイスを使うかを設定します。標準では
0 （最初のジョイスティック）
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List the system's available joysticks and exit. (Does not launch Tux Paint.) List the system's available joysticks and exit. (Does not launch Tux
Paint.)
.TP 8 .TP 8
.B \-\-joystick-slowness=\fISPEED\fP .B \-\-joystick-slowness=\fISPEED\fP
Sets a delay at each axis motion, allowing to slow the joystick. Allowed values are from 0 to 500. Default value is 15. ジョイスティックの感度を SPEED の値で設定します。0
から 500 までの値が設定できます。標準の値は 15 です。
.TP 8 .TP 8
.B \-\-joystick-threshold=\fITHRESHOLD\fP .B \-\-joystick-threshold=\fITHRESHOLD\fP
Sets the minimum level of axis motion to start moving the pointer. Allowed values are from 0 to 32766. Default value is 3200. ジョイスティックでポインターを動かし始めるためのしきい値を
THRESHOLD の値で設定します。0 から 32766
までの値が設定できます。標準の値は 3200 です。
.TP 8 .TP 8
.B \-\-joystick-maxsteps=\fISTEPS\fP .B \-\-joystick-maxsteps=\fISTEPS\fP
Sets the maximum pixels the pointer will move at once. Allowed values are from 1 to 7. Default value is 7. ポインターの移動速度の上限を STEPS
にピクセル単位で設定します。1 から 7
までの値が設定可能で、標準の値は 7 です。
.TP 8 .TP 8
.B \-\-joystick-hat-timeout=\fIMILLISECONDS\fP .B \-\-joystick-hat-timeout=\fIMILLISECONDS\fP
Sets the delay after wich the pointer will start moving automatically if the hat is keeped pushed. Allowed values are from 0 to 3000. Default value is 1000. ジョイスティックのハットスイッチを押し続けたときに、ポインターが連続して動き始めるまでの時間を
MILLISECONDS にミリ秒単位で設定します。0 から 3000
までの値が設定可能で、標準の設定は 1000 です。
.TP 8 .TP 8
.B \-\-joystick-hat-slowness=\fISPEED\fP .B \-\-joystick-hat-slowness=\fISPEED\fP
Sets a delay at each automatic motion, allowing to slow the speed of the hat. Allowed values are from 0 to 500. Default value is 15. ハットスイッチの感度を設定します。設定可能な値は 0
から 500 で、標準の値は 15 です。
.TP 8 .TP 8
.B \-\-joystick-btn-escape=\fIBUTTON\fP .B \-\-joystick-btn-escape=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be used to generate a escape event. Useful to dismiss dialogs and quit. ジョイスティックの BUTTON NUMBER で設定したボタンに "ESC"
キーの機能を割り当てます。（ダイアログの "もどる"
や "やめる" で使います）
.TP 8 .TP 8
.B \-\-joystick-btn-\fICOMMAND\fP=\fIBUTTON\fP .B \-\-joystick-btn-\fICOMMAND\fP=\fIBUTTON\fP
Selects the joystick button number, as seen by SDL, that will be a shortcut to Selects the joystick button number, as seen by SDL, that will be a shortcut
various tools within Tux Paint. to various tools within Tux Paint.
.PP .PP
.RS .RS
@ -579,16 +588,15 @@ print | Print (immediate)
.TP 8 .TP 8
.B \-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\fP .B \-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\fP
A set of joystick button numbers, as seen by SDL, that should A set of joystick button numbers, as seen by SDL, that should be ignored.
be ignored. Otherwise, unless they are used by one of the Otherwise, unless they are used by one of the "--joystick-btn-..." options
"--joystick-btn-..." options above, buttons will be seen as a mouse above, buttons will be seen as a mouse left-click. Comma-separated.
left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
.l .l
\fItuxpaint\fP accepts the following options to alter how Tux Paint \fItuxpaint\fP accepts the following options to alter how Tux Paint handles
handles printing. They can be used along with, instead of, or to printing. They can be used along with, instead of, or to override options
override options set in configuration files. (See below.) set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
@ -597,50 +605,48 @@ Disable or enable (default) the Print command within Tux Paint.
.TP 8 .TP 8
.B \-\-printdelay=\fISECONDS\fP \-\-printdelay=0 .B \-\-printdelay=\fISECONDS\fP \-\-printdelay=0
Only allow printing (via the \fIPrint\fP command) once every \fISECONDS\fP Only allow printing (via the Print command) once every SECONDS seconds.
seconds. Default is 0 (no limitation). Default is 0 (no limitation).
.SS SHOW PRINTER DIALOG .SS SHOW PRINTER DIALOG
.TP 8 .TP 8
.B \-\-altprintmod \-\-altprintnever \-\-altprintalways .B \-\-altprintmod \-\-altprintnever \-\-altprintalways
These options control whether an system printer dialog appears when the These options control whether an system printer dialog appears when the
user clicks the \fIPrint\fP button. By default (\-\-altprintmod), pressing user clicks the Print button. By default ("--altprintmod"), pressing [Alt]
\fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're while clicking Print will bring up a dialog (unless you're in fullscreen
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, mode). With "--altprintalways", the dialog will always appear, even if
even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog [Alt] is not being held. With "--altprintnever", the dialog will never
will never appear, even if \fI[Alt]\fP is being held. appear, even if [Alt] is being held.
.SS SAVE PRINTER CONFIGURATION .SS SAVE PRINTER CONFIGURATION
.TP 8 .TP 8
.B \-\-printcfg \-\-noprintcfg .B \-\-printcfg \-\-noprintcfg
(Windows and Mac OS X only.) Enable or disable loading and saving of (Windows and Mac OS X only.) Enable or disable loading and saving of
printer settings. By default, \fITux Paint\fP will print to the default printer settings. By default, Tux Paint will print to the default printer
printer with default settings. Pressing \fI[Alt]\fP while pushing the with default settings. Pressing [Alt] while pushing the Print button will
\fIPrint\fP button will cause a printer dialog to appear (as long as you're cause a printer dialog to appear (as long as you're not in fullscreen mode;
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, see also "--altprintalways" and "--altprintnever", below.) Unless
below.) Unless \-\-noprintcfg is used, your previous settings will "--noprintcfg" is used, your previous settings will be loaded when Tux
be loaded when \fITux Paint\fP starts up, and setting changes will be saved Paint starts up, and setting changes will be saved for next time.
for next time.
.SS PRINT COMMANDS .SS PRINT COMMANDS
.TP 8 .TP 8
.B \-\-printcommand \fICOMMAND\fP .B \-\-printcommand \fICOMMAND\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.)
Have Tux Paint print via an alternate command, rather than lpr(1). Have Tux Paint print via an alternate command, rather than lpr(1).
.TP 8 .TP 8
.B \-\-altprintcommand \fICOMMAND\fP .B \-\-altprintcommand \fICOMMAND\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Have Tux Paint print via an
Have Tux Paint print via an alternate command, when a dialog is expect alternate command, when a dialog is expect (e.g., when holding [Alt] while
(e.g., when holding \fI[Alt]\fP while clicking "Print"; see above), clicking Print; see above), rather than kprinter.
rather than kprinter.
.SS PAPER SIZE .SS PAPER SIZE
.TP 8 .TP 8
.B \-\-papersize \fIPAPERSIZE\fP .B \-\-papersize \fIPAPERSIZE\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used.) Ask Tux Paint to generate
Ask \fITux Paint\fP to generate PostScript of a particular paper size. PostScript of a particular paper size. Valid sizes are those supported by
Valid sizes are those supported by libpaper. See papersize(5). libpaper. See papersize(5).
.SH OPTIONS - SAVING .SH OPTIONS - SAVING
.l .l
@ -651,86 +657,82 @@ instead of, or to override options set in configuration files. (See below.)
.SS SAVE OVER EARLIER WORK .SS SAVE OVER EARLIER WORK
.TP 8 .TP 8
.B \-\-saveover \-\-saveovernew \-\-saveoverask .B \-\-saveover \-\-saveovernew \-\-saveoverask
If, when saving a picture, an older version of the file will be overwritten, If, when saving a picture, an older version of the file will be
\fITux Paint\fP will, by default, ask for confirmation: either overwritten, Tux Paint will, by default, ask for confirmation: either save
\fIsave over\fP the old file, or \fIcreate\fP a new file. This prompt over the old file, or create a new file. This prompt can be disabled with
can be disabled with \fI\-\-saveover\fP (which always saves over older versions "--saveover" (which always saves over older versions of pictures) or
of pictures) or \fI\-\-saveovernew\fP (which always saves a new file). "--saveovernew" (which always saves a new file). The default is to prompt
The default is to prompt (\fI\-\-saveoverask\fP). ("--saveover").
.SS SAVE AND EXPORT DIRECTORIES .SS SAVE AND EXPORT DIRECTORIES
.TP 8 .TP 8
.B \-\-savedir \fIDIR\fP .B \-\-savedir \fIDIR\fP
Specify where \fITux Paint\fP should save and load its drawings. Specify where Tux Paint should save and load its drawings.
.TP 8 .TP 8
.B \-\-exportdir \fIDIR\fP .B \-\-exportdir \fIDIR\fP
Specify where \fITux Paint\fP should export drawings and animations. Specify where Tux Paint should export drawings and animations.
.SS MORE SAVING OPTIONS .SS MORE SAVING OPTIONS
.TP 8 .TP 8
.B \-\-nosave \-\-save .B \-\-nosave \-\-save
The \fInosave\fP option disables \fITux Paint's\fP ability to save files. The --nosave option disables Tux Paint's ability to save files. This can be
This can be used in situations where the program is only being used for used in situations where the program is only being used for fun, or in a
fun, or in a test environment. test environment.
.TP 8 .TP 8
.B \-\-autosave \-\-noautosave .B \-\-autosave \-\-noautosave
The \fIautosave\fP option prevents \fITux Paint\fP from asking whether you The --autosave option prevents ITux Paint P from asking whether you want
want to save the current picture when quitting, and assumes you do. to save the current picture when quitting, and assumes you do.
.SH OPTIONS - DATA FILES .SH OPTIONS - DATA FILES
.l .l
\fItuxpaint\fP accepts the following options to alter where Tux Paint \fItuxpaint\fP accepts the following options to alter where Tux Paint loads
loads data (stamps, brushes, etc.) They can be used along with, instead data (stamps, brushes, etc.) They can be used along with, instead of, or
of, or to override options set in configuration files. (See below.) to override options set in configuration files. (See below.)
.TP 8 .TP 8
.B \-\-datadir \fIDIR\fP .B \-\-datadir \fIDIR\fP
Specify where \fITux Paint\fP should look for personal data files Specify where Tux Paint should look for personal data files (brushes,
(brushes, stamps, etc.). stamps, etc.).
.TP 8 .TP 8
.B \-\-colorfile \fIFILE\fP .B \-\-colorfile \fIFILE\fP
This option allows you to override the default color palette in \fITux Paint\fP This option allows you to override the default color palette in Tux Paint
and replace it with your own. The file should be a plain ASCII text file and replace it with your own. The file should be a plain ASCII text file
containing one color description per line. Colors may be in decimal or containing one color description per line. Colors may be in decimal or 6-
6- or 3-digit hexadecimal, and followed by a description. (For example, or 3-digit hexadecimal, and followed by a description. (For example,
"\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".) "\fI#000 Black\fP" and "\fI255 192 64 Orange\fP".)
.SH OPTIONS - LANGUAGE .SH OPTIONS - LANGUAGE
.l .l
\fItuxpaint\fP accepts the following options to alter the language used \fItuxpaint\fP accepts the following options to alter the language used by
by Tux Paint's interface, and other related settings. They can be used Tux Paint's interface, and other related settings. They can be used along
along with, instead of, or to override options set in configuration with, instead of, or to override options set in configuration
files. (See below.) files. (See below.)
.l .l
Various parts of \fITux Paint\fP have been translated into numerous languages. Various parts of Tux Paint have been translated into numerous languages.
\fITux Paint\fP will try its best to honor your \fIlocale\fP setting Tux Paint will try its best to honor your locale setting (i.e., the "LANG"
(i.e., the \fILANG\fP environment variable), if possible. environment variable), if possible. You can also specifically set the
You can also specifically set the language using options on the command-line language using options on the command-line or in a configuration file.
or in a configuration file.
.TP 8 .TP 8
.B \-\-locale \fILOCALE\fP .B \-\-locale \fILOCALE\fP
Specify the language to use, based on locale name (which is typically of the Specify the language to use, based on locale name (which is typically of
form \fIlanguage\fP[_\fIterritory\fP][.\fIcodeset\fP][@\fImodifier\fP], the form "language[_territory][.codeset][@modifier], where "language" is an
where \fIlanguage\fP is an ISO 639 language code, ISO 639 language code, "territory" is an ISO 3166 country code, and
\fIterritory\fP is an ISO 3166 country code, and "codeset" is a character set or encoding identifier like "ISO-8859-1" or
\fIcodeset\fP is a character set or encoding identifier like ISO-8859-1 or "UTF-8".)
UTF-8.)
.PP .PP
.RS .RS
For example, \fIde_DE@euro\fP for German, or \fIpt_BR\fP For example, "de_DE@euro" for German, or "pt_BR" for Brazilian Portuguese.
for Brazilian Portuguese.
.RE .RE
.TP 8 .TP 8
.B \-\-lang \fILANGUAGE\fP .B \-\-lang \fILANGUAGE\fP
Specify the language to use, based on the language's name Specify the language to use, based on the language's name (as recognized by
(as recognized by \fITux Paint\fP). Choose one of the language names Tux Paint). Choose one of the language names listed below:
listed below:
.PP .PP
.RS .RS
.PD 0 .PD 0
@ -1130,107 +1132,130 @@ Display a lists of all supported languages.
.TP 8 .TP 8
.B \-\-mirrorstamps \-\-dontmirrorstamps .B \-\-mirrorstamps \-\-dontmirrorstamps
With \fImirrorstamps\fP set, stamps which can be mirrored will appear With "--mirrorstamps" set, stamps which can be mirrored will appear
mirrored by default. This can be useful when used by people who prefer mirrored by default. This can be useful when used by people who prefer
things right-to-left over left-to-right. things right-to-left over left-to-right.
.SS FONTS .SS FONTS
.TP 8 .TP 8
.B \-\-nosysfonts \-\-sysfonts .B \-\-nosysfonts \-\-sysfonts
\fITux Paint\fP normally attempts to search for additional TrueType Fonts Tux Paint normally attempts to search for additional TrueType Fonts
installed in common places on your system. If this causes trouble, or you'd installed in common places on your system. If this causes trouble, or
prefer to only make fonts installed in \fITux Paint\fP's directory available, you'd prefer to only make fonts installed in Tux Paint's directory
use the \fInosysfonts\fP option to disable this feature. available, use the "--nosysfonts" option to disable this feature.
.TP 8 .TP 8
.B \-\-alllocalefonts \-\-currentlocalefont .B \-\-alllocalefonts \-\-currentlocalefont
Tux Paint avoids loading any fonts in its 'locale' font subdirectory, Tux Paint avoids loading any fonts found in its "locale" font subdirectory,
except any that match the current locale \fITux Paint\fP is running under. except any that match the current locale Tux Paint is running under. Use
Use the \fIalllocalefonts\fP option to load all such fonts, for use in the the "--alllocalefonts" option to load all such fonts, for use in the Text
"Text" tool. (This is the old behavior, prior to version 0.9.21.) and Label tools. (This was the default behavior, prior to version 0.9.21.)
.SH OPTIONS - MISCELLANEOUS .SH OPTIONS - MISCELLANEOUS
.l .l
\fItuxpaint\fP accepts the following options to alter its behavior. \fItuxpaint\fP accepts the following options to alter its behavior. They
They can be used along with, instead of, or to override options set in can be used along with, instead of, or to override options set in
configuration files. (See below.) configuration files. (See below.)
.TP 8 .TP 8
.B \-\-nosysconfig .B \-\-nosysconfig
With this option, \fITux Paint\fP will not attempt to read the With this option, Tux Paint will not attempt to read the system-wide
system-wide configuration file (typically \fI/etc/tuxpaint/tuxpaint.conf\fP). configuration file (typically "/etc/tuxpaint/tuxpaint.conf" or
"/usr/local/etc/tuxpaint/tuxpaint.conf").
.TP 8 .TP 8
.B \-\-nolockfile .B \-\-nolockfile
By default, \fITux Paint\fP uses a lockfile (stored in the user's By default, Tux Paint uses a lockfile (stored in the user's local Tux Paint directory) which prevents it from being launched more than once in 30 seconds. (Sometimes children get too eager, or user interfaces only require one click, but users think they need to double-click.) This option makes Tux Paint ignore the current lockfile.
local Tux Paint directory) which prevents it from being launched more than
once in 30 seconds. (Sometimes children get too eager, or user interfaces
only require one click, but users think they need to double-click.)
This option makes \fITux Paint\fP ignore the current lockfile.
.SH ENVIRONMENT .SH ENVIRONMENT
.ad l .ad l
While \fITux Paint\fP may refer to a number of environment variables indirectly While Tux Paint may refer to a number of environment variables indirectly
(e.g., via \fISDL(3)\fP), it only directly accesses the following: (e.g., via SDL(3)), it directly accesses the following: (See "FILES" below,
as well.)
.PP .PP
.TP 8 .TP 8
.B HOME .B HOME
to determine where picture files go when using the \fISave\fP and \fIOpen\fP to determine where picture files go when using the Save and Open commands
commands within \fITux Paint\fP, to keep track of the current image, within Tux Paint, to keep track of the current image, when quitting and
when quitting and restarting \fITux Paint\fP, and to get the user's restarting Tux Paint, and to get the user's configuration file.
configuration file.
.TP 8 .TP 8
.B LANG .B LANG, LC_ALL, LANGUAGE, and LC_MESSAGES
to determine language to use, if \fIsetlocale(3)\fP refers to 'LC_MESSAGES'. to determine language to use, if setlocale(3) refers to "LC_MESSAGES".
.TP 8
.B SDL_VIDEO_ALLOW_SCREENSAVER
Set this environment variable to '1' to allow a screensaver to appear while
Tux Paint is running. This can also be done via the "--allowscreensaver"
option.
.TP 8
.B SDL_VIDEO_WINDOW_POS
If this is NOT set, Tux Paint will set it to "center", to attempt to place
the Tux Paint window in the center of a display. If it IS set (e.g., to
"nopref", meaning "no preference"), Tux Paint will not override it.
.SH FILES .SH FILES
.TP 8 .TP 8
.B /etc/tuxpaint/tuxpaint.conf .B [/usr/local/]/etc/tuxpaint/tuxpaint.conf
System-wide configuration file. It is read first System-wide configuration file. It is read first (unless the
(unless the \fI\-\-nosysconfig\fP option was given on the command-line). "--nosysconfig" option was given on the command-line).
.RS .RS
.PP .PP
(Created during installation.) (Created during installation.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaintrc .B $HOME/.tuxpaintrc
User's configuration file. It can be used to set default options User's configuration file. It can be used to set default options (rather
(rather than setting them on the command-line every time), and/or to than setting them on the command-line every time), and/or to override any
override any settings in the system-wide configuration file. settings in the system-wide configuration file.
.RS .RS
.PP .PP
(Not created or edited automatically; must be created manually. (Not created or edited automatically; must be created manually. You can do
You can do this by hand, or use '\fITux Paint Config.\fP.') this by hand, or use tuxpaint-config(1).)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/saved/ .B $HOME/.tuxpaint/saved/
A directory of previously-saved images (and thumbnails). Only files in this A directory of previously-saved images (and thumbnails). Only files in
directory will be made available using the \fIOpen\fP command within this directory will be made available using the Open command within Tux
\fITux Paint\fP. (See \fItuxpaint-import(1)\fP.) Paint. Overridden via the "--savedir" option.
.RS .RS
.PP .PP
(Created when \fISave\fP command is used.) (Created when Save command is used.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/current_id.txt .B $HOME/.tuxpaint/current_id.txt
A reference to the image which was being edited when \fITux Paint\fP was A reference to the image which was being edited when Tux Paint was last
last quit. (This image is automatically loaded the next time \fITux Paint\fP quit. (This image is automatically loaded the next time Tux Paint is
is re-run.) re-run, unless the "--startblank" option is set.)
.RS .RS
.PP .PP
(Created when \fITux Paint\fP is \fIQuit\fP.) (Created when Tux Paint is Quit.)
.RE .RE
.TP 8 .TP 8
.B $HOME/.tuxpaint/lockfile.dat .B $HOME/.tuxpaint/lockfile.dat
A lockfile that prevents \fITux Paint\fP from being launched more than once A lockfile that prevents Tux Paint from being launched more than once every
every 30 seconds. Disable checking the lockfile by using the 30 seconds. Disable checking the lockfile by using the "--nolockfile"
\'\-\-nolockfile\' command-line argument. option.
.RS .RS
.PP .PP
(There's no reason to delete the lockfile, as it contains a timestamp (There's no reason to delete the lockfile, as it contains a timestamp
inside which causes it to expire after 30 seconds.) inside which causes it to expire after 30 seconds.)
.RE .RE
.TP 8
.B $XDG_CONFIG_HOME[XDG_PICTURES_DIR]/TuxPaint/
A directory where images and animations should be exported (via options
found in Tux Paint's Open dialog), if the "--exportdir" option is not used
to override it. If "$XDG_CONFIG_HOME" is set, a configuration file
"user-dirs.dirs" will be scanned within the directory it points to; if not,
Tux Paint will attempt to do so within "$HOME/.config/". If a setting
named "XDG_PICTURES_DIR" is found, it will be used as the location to
export images. If all else fails, then "$HOME/Pictures/" will be used. A
"TuxPaint" subdirectory will be created.
.TP 8
.B $XDG_DATA_HOME/Trash/ or $HOME/.local/share/Trash/
A directory where images are placed when the Erase option is used from the
Open dialog.
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify it This program is free software; you can redistribute it and/or modify it
@ -1515,4 +1540,4 @@ Huang Zuzhen.
.BR krita (1), .BR krita (1),
.BR gcompris (1) .BR gcompris (1)
.PP .PP
And documentation within /usr/[local/]share/doc/tuxpaint/.