Refresh localized manpages

This commit is contained in:
Bill Kendrick 2021-08-14 23:28:13 -07:00
parent 43429aa017
commit 5f64ebd732
5 changed files with 545 additions and 415 deletions

View file

@ -284,7 +284,8 @@ Show the license (GNU GPL) under which Tux Paint is released.
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.)
.SS VIDEO.TP 8 .SS VIDEO
.TP 8
.B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed .B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed
Run \fITux Paint\fP in full-screen mode at its default -- or a specified -- Run \fITux Paint\fP in full-screen mode at its default -- or a specified --
screen resolution ("--fullscreen=yes"); or in full-screen mode at the screen resolution ("--fullscreen=yes"); or in full-screen mode at the
@ -298,22 +299,22 @@ When in fullscreen mode, use the system's default screen resolution.
.TP 8 .TP 8
.B \-\-WIDTHxHEIGHT .B \-\-WIDTHxHEIGHT
Run \fITux Paint\fP in a particularly-sized window, or at a particular Run \fITux Paint\fP in a particularly-sized window, or at a particular
fullscreen resolution (if \-\-native is not used). Default is 800x600. fullscreen resolution (if \-\-native is not used). Default is 800x600.
Minimum width is 640. Minimum height is 480. Portrait and landscape Minimum width is 640. Minimum height is 480. Portrait and landscape
orientations are both supported. (Also see \-\-orient, below.) orientations are both supported. (Also see \-\-orient, below.)
.TP 8 .TP 8
.B \-\-orient=landscape \-\-orient=portrait .B \-\-orient=landscape \-\-orient=portrait
If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and HEIGHT If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and
values it uses for windowed or fullscreen mode, without having to actually HEIGHT values it uses for windowed or fullscreen mode, without having to
change the WIDTH and HEIGHT values in the configuration file or on the actually change the WIDTH and HEIGHT values in the configuration file or on
command-line. (This is useful on devices where the screen can be rotated, the command-line. (This is useful on devices where the screen can be
e.g. tablet PCs.) rotated, e.g. tablet PCs.)
.TP 8 .TP 8
.B \-\-allowscreensaver \-\-disablescreensaver .B \-\-allowscreensaver \-\-disablescreensaver
Normally, \fItuxpaint\fP disables your screensaver. Use \-\-allowscreensaver Normally, \fItuxpaint\fP disables your screensaver. Use
to prevent this from happening. \-\-allowscreensaver to prevent this from happening.
.SS SOUND .SS SOUND
.TP 8 .TP 8
@ -326,54 +327,53 @@ Disable or enable (default) stereo panning support.
.SS INTERFACE SIZE .SS INTERFACE SIZE
.TP 8 .TP 8
.B \-\-buttonsize SIZE .B \-\-buttonsize SIZEAdjust the size of the buttons in \fITux Paint\fP's user interface, between
Adjust the size of the buttons in \fITux Paint's\fP user interface, 24 and 192 pixels (48 is the default, and suitable for displays with 96 to
between 24 and 192 pixels (48 is the default, and suitable for displays 120dpi pixel density).
with 96 to 120dpi pixel density).
.TP 8 .TP 8
.B \-\-colorsrows=\fIrows\fP .B \-\-colorsrows=\fIROWS\fP
How many rows of color palette buttons to show; useful when using How many rows of color palette buttons to show; useful when using a large
a large color palette, and/or for use with coarse input devices color palette, and/or for use with coarse input devices (like eyegaze
(like eyegaze trackers). It can be between 1 (default) and 3. trackers). It can be between 1 (default) and 3.
.SS INTERFACE SIMPLIFICATION .SS INTERFACE SIMPLIFICATION
.TP 8 .TP 8
.B \-\-simpleshapes \-\-complexshapes .B \-\-simpleshapes \-\-complexshapes
Disable or enable (default) the \fIrotation\fP step when using the Disable or enable (default) the rotation step when using the Shape tool
\fIShape\fP tool within \fITux Paint\fP. When disabled, shapes cannot be within Tux Paint. When disabled, shapes cannot be rotated; however, the
rotated; however, the interface is easier (click, drag, release), which can interface is easier (click, drag, release), which can be useful for younger
be useful for younger or disabled children. or disabled children.
.TP 8 .TP 8
.B \-\-nooutlines \-\-outlines .B \-\-nooutlines \-\-outlines
In \fInooutlines\fP mode, much simpler outlines and 'rubber-band' lines are With "--nooutlines" enabled, much simpler outlines and 'rubber-band' lines
displayed when using the \fILines\fP, \fIShapes\fP, \fIStamps\fP and are displayed when using the Lines, Shapes, Stamps and Eraser tools. (This
\fIEraser\fP tools. (This can help when \fITux Paint\fP is run on slower can help when Tux Paint is run on slower computers, or displayed on a
computers, or displayed on a remote X display.) remote terminal.)
.TP 8 .TP 8
.B \-\-uppercase \-\-mixedcase .B \-\-uppercase \-\-mixedcase
In \fIuppercase\fP mode, all text prompts and the \fIText\fP drawing tool With "--uppercase" enabled, all text prompts and the Text and Label drawing
will display only uppercase letters. This is useful for children who are not tools will display only uppercase letters. This is useful for children who
yet comfortable with the lowercase characterset. Default mode is are not yet comfortable with the lowercase characterset. Default mode is
\fImixed case\fP. mixed case.
.SS INITIAL STAMP SIZE .SS INITIAL STAMP SIZE
.TP 8 .TP 8
.B \-\-stampsize=\fIsize\fP \-\-stampsize=default .B \-\-stampsize=\fISIZE\fP \-\-stampsize=default
Sets the default size of all stamps, relative to their possible sizes Overrides the default size of all stamps, relative to their possible sizes
(determined by \fITux Paint\fP, based on the dimensions of both the stamps (determined by Tux Paint, based on the dimensions of both the stamps
themselves, and the drawing canvas). Valid values are from 0 (smallest) themselves, and the drawing canvas). Valid values are from 0 (smallest) to
to 10 (largest). Use \fIdefault\fP to let \fITux Paint\fP choose 10 (largest). Use "--stampsize=default" to let ITux Paint P choose on a
(this is the default setting). per-stamp basis (this is the default setting).
.SS STARTING OUT .SS STARTING OUT
.TP 8 .TP 8
.B \-\-startblank \-\-startlast .B \-\-startblank \-\-startlast
When you start \fITux Paint\fP, it loads the last image that was being worked When you start Tux Paint, it loads the last image that was being worked on.
on. The \fI\-\-startblank\fP option disables this, so it always starts with The "\-\-startblank" option disables this, so it always starts with a
a blank canvas. The default behavior is \fI\-\-startlast\fP. blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
@ -383,15 +383,15 @@ options displayed when using the \fINew\fP 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 \fIQuit\fP button and \fIEscape\fP Disable or enable (default) the on-screen Quit button and [Escape]
key sequence for quitting \fITux Paint\fP. Instead, use the window close key for quitting Tux Paint. Instead, use the window close
button in the titlebar, the \fIAlt+F4\fP key sequence, or the button in the titlebar, the [Al]+[F4] key sequence, or the
\fIShift+Control+Escape\fP key sequence. [Shift]+[Control]+[Escape] key sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With \fInostamps\fP set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the
\fIStamps\fP tool will not be available. This option can be used to reduce Stamps tool will not be available. This option can be used to reduce
the time Tux Paint takes to load, and reduce the amount of RAM it requires. the time Tux Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
@ -415,7 +415,7 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the \fILabel\fP tool, which lets you create Disable or enable (default) the Label tool, which lets you create
text which can be altered or moved later. text which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
@ -427,31 +427,31 @@ set in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
.B \-\-nofancycursors \-\-fancycursors .B \-\-nofancycursors \-\-fancycursors
Disable or enable (default) the 'fancy' mouse pointer shapes in \fITux Paint\fP. Disable or enable (default) the 'fancy' mouse pointer shapes in Tux Paint.
While the shapes are larger, and context sensitive, some environments have While the shapes are larger, and context sensitive, some environments have
trouble displaying the mouse pointer, and/or leave 'trails' on the screen. 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 \fITux Paint\fP. Completely hide, or enable (default) the mouse pointer in Tux Paint.
This can be useful on touchscreen devices, such as tablet PCs. This 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) If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save)
will be disabled. Default mode is \fIshortcuts enabled\fP. will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
.B \-\-grab \-\-dontgrab .B \-\-grab \-\-dontgrab
Grab the mouse and keyboard input (if possible), so that the mouse is Grab the mouse and keyboard input (if possible), so that the mouse is
confined to the \fITux Paint\fP window. Default is to not grab. 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
\fIselector\fP 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 completely ignored, with the \fI\-\-nowheelmouse\fP option. wheel completely ignored, with the \fI\-\-nowheelmouse\fP option.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to support the wheel. Default is to support the wheel.
@ -463,15 +463,15 @@ you click, move, and click again to end the motion.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The \fIkeyboard\fP option lets the mouse pointer in \fITux Paint\fP be The "--keyboard" option lets the mouse pointer in Tux Paint be
controlled with the keyboard. The \fIarrow keys\fP move the pointer. controlled with the keyboard. The [Up], [Down], [Left], and [Right]
\fISpacebar\fP acts as the mouse button. arrow keys move 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 mice with more than one button) can be used for interacting with on mice with more than one button) can be used for interacting with
\fITux Paint\fP. With the \fI\-\-nobuttondistinction\fP option, Tux Paint. With the "--nobuttondistinction" option,
mouse buttons #2 (middle) and #3 (right) can be used, as well. mouse buttons #2 (middle) and #3 (right) can be used, as well.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to only recognize button #1. Default is to only recognize button #1.
@ -479,8 +479,8 @@ 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 \fIText\fP and Presents a clickable on-screen keyboard when using the Text and
\fILabel\fP tools. Label tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -488,7 +488,8 @@ Specify the default layout for the on-screen keyboard (see above).
.TP 8 .TP 8
.B \-\-onscreen-keyboard-disable-change .B \-\-onscreen-keyboard-disable-change
Disallow switching between on-screen keyboard layouts. Disables the left/right arrow buttons visible on the on-screen keyboard,
which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
@ -497,7 +498,7 @@ Specify which joystick device should be used by Tux Paint. Default value is 0 (t
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List available joysticks and exit. 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
@ -534,18 +535,44 @@ various tools within Tux Paint.
.TP 2 .TP 2
- -
brush | Brush brush | Brush
.TP 2
-
lines | Lines lines | Lines
.TP 2
-
shapes | Shapes shapes | Shapes
.TP 2
-
text | Text text | Text
.TP 2
-
label | Label label | Label
.TP 2
-
magic | Magic magic | Magic
.TP 2
-
undo | Undo undo | Undo
.TP 2
-
redo | Redo redo | Redo
.TP 2
-
eraser | Eraser eraser | Eraser
.TP 2
-
new | New new | New
.TP 2
-
open | Open open | Open
.TP 2
-
save | Save save | Save
.TP 2
-
pgsetup | Print (dialog) pgsetup | Print (dialog)
.TP 2
-
print | Print (immediate) print | Print (immediate)
.RE .RE
.PD .PD
@ -554,7 +581,7 @@ print | Print (immediate)
.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. Otherwise, unless they are used by one of the be ignored. Otherwise, unless they are used by one of the
\-\-joystick-btn-... options above, buttons will be seen as a mouse "--joystick-btn-..." options above, buttons will be seen as a mouse
left-click. Comma-separated. left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
@ -566,7 +593,7 @@ override options set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
.B \-\-noprint \-\-print .B \-\-noprint \-\-print
Disable or enable (default) the \fIPrint\fP command within \fITux Paint\fP. 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
@ -578,17 +605,17 @@ seconds. Default is 0 (no limitation).
.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 \fIPrint\fP button. By default (\-\-altprintmod), pressing
\fI[ALT]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're \fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, in fullscreen mode). With \-\-altprintalways, the dialog will always appear,
even if \fI[ALT]\fP is not being held. With \-\-altprintnever, the dialog even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog
will never appear, even if \fI[ALT]\fP is being held. will never appear, even if \fI[Alt]\fP 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, \fITux Paint\fP will print to the default
printer with default settings. Pressing \fI[ALT]\fP while pushing the printer with default settings. Pressing \fI[Alt]\fP while pushing the
\fIPrint\fP button will cause a printer dialog to appear (as long as you're \fIPrint\fP button will cause a printer dialog to appear (as long as you're
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever,
below.) Unless \-\-noprintcfg is used, your previous settings will below.) Unless \-\-noprintcfg is used, your previous settings will
@ -605,7 +632,7 @@ Have Tux Paint print via an alternate command, rather than lpr(1).
.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 \- not Windows, Mac OS X or BeOS.)
Have Tux Paint print via an alternate command, when a dialog is expect Have Tux Paint print via an alternate command, when a dialog is expect
(e.g., when holding \fI[ALT]\fP while clicking "Print"; see above), (e.g., when holding \fI[Alt]\fP while clicking "Print"; see above),
rather than kprinter. rather than kprinter.
.SS PAPER SIZE .SS PAPER SIZE
@ -1206,28 +1233,27 @@ inside which causes it to expire after 30 seconds.)
.RE .RE
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify This program is free software; you can redistribute it and/or modify it
it under the terms of the GNU General Public License as published by under the terms of the GNU General Public License as published by the Free
the Free Software Foundation; either version 2 of the License, or Software Foundation; either version 2 of the License, or (at your option)
(at your option) any later version. any later version.
.SH OTHER INFO .SH OTHER INFO
See the documentation that comes with \fITux Paint\fP for further instructions on See the documentation that comes with Tux Paint for further instructions on using the program's features.
using the program's features.
The canonical place to find \fITux Paint\fP information is at The canonical place to find Tux Paint information is at
.nh .nh
http://www.tuxpaint.org/. http://www.tuxpaint.org/.
.hy .hy
.SH AUTHORS .SH AUTHORS
Lead developer & project manager: Bill Kendrick Lead developer and project manager: Bill Kendrick.nh
.nh
<bill@newbreedsoftware.com>. <bill@newbreedsoftware.com>.
.hy .hy
With patches, fixes, extensions, porting, translations, documentation, and more from With patches, fixes, extensions, porting, translations, documentation, and
lots of people, including, but probably not limited to (see AUTHORS.txt and CHANGES.txt): more from lots of people, including, but probably not limited to (see
AUTHORS.txt and CHANGES.txt):
Aki, Aki,
Ashish Arora, Ashish Arora,
@ -1478,7 +1504,7 @@ Martin Zhekov,
and and
Huang Zuzhen. Huang Zuzhen.
.SH "SEE ALSO" .SH SEE ALSO
.BR tuxpaint-import (1), .BR tuxpaint-import (1),
.BR tuxpaint-config (1), .BR tuxpaint-config (1),
.BR tp-magic-config (1), .BR tp-magic-config (1),
@ -1489,4 +1515,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/.

View file

@ -284,7 +284,8 @@ Show the license (GNU GPL) under which Tux Paint is released.
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.)
.SS VIDEO.TP 8 .SS VIDEO
.TP 8
.B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed .B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed
Run \fITux Paint\fP in full-screen mode at its default -- or a specified -- Run \fITux Paint\fP in full-screen mode at its default -- or a specified --
screen resolution ("--fullscreen=yes"); or in full-screen mode at the screen resolution ("--fullscreen=yes"); or in full-screen mode at the
@ -298,22 +299,22 @@ When in fullscreen mode, use the system's default screen resolution.
.TP 8 .TP 8
.B \-\-WIDTHxHEIGHT .B \-\-WIDTHxHEIGHT
Run \fITux Paint\fP in a particularly-sized window, or at a particular Run \fITux Paint\fP in a particularly-sized window, or at a particular
fullscreen resolution (if \-\-native is not used). Default is 800x600. fullscreen resolution (if \-\-native is not used). Default is 800x600.
Minimum width is 640. Minimum height is 480. Portrait and landscape Minimum width is 640. Minimum height is 480. Portrait and landscape
orientations are both supported. (Also see \-\-orient, below.) orientations are both supported. (Also see \-\-orient, below.)
.TP 8 .TP 8
.B \-\-orient=landscape \-\-orient=portrait .B \-\-orient=landscape \-\-orient=portrait
If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and HEIGHT If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and
values it uses for windowed or fullscreen mode, without having to actually HEIGHT values it uses for windowed or fullscreen mode, without having to
change the WIDTH and HEIGHT values in the configuration file or on the actually change the WIDTH and HEIGHT values in the configuration file or on
command-line. (This is useful on devices where the screen can be rotated, the command-line. (This is useful on devices where the screen can be
e.g. tablet PCs.) rotated, e.g. tablet PCs.)
.TP 8 .TP 8
.B \-\-allowscreensaver \-\-disablescreensaver .B \-\-allowscreensaver \-\-disablescreensaver
Normally, \fItuxpaint\fP disables your screensaver. Use \-\-allowscreensaver Normally, \fItuxpaint\fP disables your screensaver. Use
to prevent this from happening. \-\-allowscreensaver to prevent this from happening.
.SS SOUND .SS SOUND
.TP 8 .TP 8
@ -326,54 +327,53 @@ Disable or enable (default) stereo panning support.
.SS INTERFACE SIZE .SS INTERFACE SIZE
.TP 8 .TP 8
.B \-\-buttonsize SIZE .B \-\-buttonsize SIZEAdjust the size of the buttons in \fITux Paint\fP's user interface, between
Adjust the size of the buttons in \fITux Paint's\fP user interface, 24 and 192 pixels (48 is the default, and suitable for displays with 96 to
between 24 and 192 pixels (48 is the default, and suitable for displays 120dpi pixel density).
with 96 to 120dpi pixel density).
.TP 8 .TP 8
.B \-\-colorsrows=\fIrows\fP .B \-\-colorsrows=\fIROWS\fP
How many rows of color palette buttons to show; useful when using How many rows of color palette buttons to show; useful when using a large
a large color palette, and/or for use with coarse input devices color palette, and/or for use with coarse input devices (like eyegaze
(like eyegaze trackers). It can be between 1 (default) and 3. trackers). It can be between 1 (default) and 3.
.SS INTERFACE SIMPLIFICATION .SS INTERFACE SIMPLIFICATION
.TP 8 .TP 8
.B \-\-simpleshapes \-\-complexshapes .B \-\-simpleshapes \-\-complexshapes
Disable or enable (default) the \fIrotation\fP step when using the Disable or enable (default) the rotation step when using the Shape tool
\fIShape\fP tool within \fITux Paint\fP. When disabled, shapes cannot be within Tux Paint. When disabled, shapes cannot be rotated; however, the
rotated; however, the interface is easier (click, drag, release), which can interface is easier (click, drag, release), which can be useful for younger
be useful for younger or disabled children. or disabled children.
.TP 8 .TP 8
.B \-\-nooutlines \-\-outlines .B \-\-nooutlines \-\-outlines
In \fInooutlines\fP mode, much simpler outlines and 'rubber-band' lines are With "--nooutlines" enabled, much simpler outlines and 'rubber-band' lines
displayed when using the \fILines\fP, \fIShapes\fP, \fIStamps\fP and are displayed when using the Lines, Shapes, Stamps and Eraser tools. (This
\fIEraser\fP tools. (This can help when \fITux Paint\fP is run on slower can help when Tux Paint is run on slower computers, or displayed on a
computers, or displayed on a remote X display.) remote terminal.)
.TP 8 .TP 8
.B \-\-uppercase \-\-mixedcase .B \-\-uppercase \-\-mixedcase
In \fIuppercase\fP mode, all text prompts and the \fIText\fP drawing tool With "--uppercase" enabled, all text prompts and the Text and Label drawing
will display only uppercase letters. This is useful for children who are not tools will display only uppercase letters. This is useful for children who
yet comfortable with the lowercase characterset. Default mode is are not yet comfortable with the lowercase characterset. Default mode is
\fImixed case\fP. mixed case.
.SS INITIAL STAMP SIZE .SS INITIAL STAMP SIZE
.TP 8 .TP 8
.B \-\-stampsize=\fIsize\fP \-\-stampsize=default .B \-\-stampsize=\fISIZE\fP \-\-stampsize=default
Sets the default size of all stamps, relative to their possible sizes Overrides the default size of all stamps, relative to their possible sizes
(determined by \fITux Paint\fP, based on the dimensions of both the stamps (determined by Tux Paint, based on the dimensions of both the stamps
themselves, and the drawing canvas). Valid values are from 0 (smallest) themselves, and the drawing canvas). Valid values are from 0 (smallest) to
to 10 (largest). Use \fIdefault\fP to let \fITux Paint\fP choose 10 (largest). Use "--stampsize=default" to let ITux Paint P choose on a
(this is the default setting). per-stamp basis (this is the default setting).
.SS STARTING OUT .SS STARTING OUT
.TP 8 .TP 8
.B \-\-startblank \-\-startlast .B \-\-startblank \-\-startlast
When you start \fITux Paint\fP, it loads the last image that was being worked When you start Tux Paint, it loads the last image that was being worked on.
on. The \fI\-\-startblank\fP option disables this, so it always starts with The "\-\-startblank" option disables this, so it always starts with a
a blank canvas. The default behavior is \fI\-\-startlast\fP. blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
@ -383,15 +383,15 @@ options displayed when using the \fINew\fP 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 \fIQuit\fP button and \fIEscape\fP Disable or enable (default) the on-screen Quit button and [Escape]
key sequence for quitting \fITux Paint\fP. Instead, use the window close key for quitting Tux Paint. Instead, use the window close
button in the titlebar, the \fIAlt+F4\fP key sequence, or the button in the titlebar, the [Al]+[F4] key sequence, or the
\fIShift+Control+Escape\fP key sequence. [Shift]+[Control]+[Escape] key sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With \fInostamps\fP set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the
\fIStamps\fP tool will not be available. This option can be used to reduce Stamps tool will not be available. This option can be used to reduce
the time Tux Paint takes to load, and reduce the amount of RAM it requires. the time Tux Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
@ -415,7 +415,7 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the \fILabel\fP tool, which lets you create Disable or enable (default) the Label tool, which lets you create
text which can be altered or moved later. text which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
@ -427,31 +427,31 @@ set in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
.B \-\-nofancycursors \-\-fancycursors .B \-\-nofancycursors \-\-fancycursors
Disable or enable (default) the 'fancy' mouse pointer shapes in \fITux Paint\fP. Disable or enable (default) the 'fancy' mouse pointer shapes in Tux Paint.
While the shapes are larger, and context sensitive, some environments have While the shapes are larger, and context sensitive, some environments have
trouble displaying the mouse pointer, and/or leave 'trails' on the screen. 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 \fITux Paint\fP. Completely hide, or enable (default) the mouse pointer in Tux Paint.
This can be useful on touchscreen devices, such as tablet PCs. This 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) If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save)
will be disabled. Default mode is \fIshortcuts enabled\fP. will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
.B \-\-grab \-\-dontgrab .B \-\-grab \-\-dontgrab
Grab the mouse and keyboard input (if possible), so that the mouse is Grab the mouse and keyboard input (if possible), so that the mouse is
confined to the \fITux Paint\fP window. Default is to not grab. 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
\fIselector\fP 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 completely ignored, with the \fI\-\-nowheelmouse\fP option. wheel completely ignored, with the \fI\-\-nowheelmouse\fP option.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to support the wheel. Default is to support the wheel.
@ -463,15 +463,15 @@ you click, move, and click again to end the motion.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The \fIkeyboard\fP option lets the mouse pointer in \fITux Paint\fP be The "--keyboard" option lets the mouse pointer in Tux Paint be
controlled with the keyboard. The \fIarrow keys\fP move the pointer. controlled with the keyboard. The [Up], [Down], [Left], and [Right]
\fISpacebar\fP acts as the mouse button. arrow keys move 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 mice with more than one button) can be used for interacting with on mice with more than one button) can be used for interacting with
\fITux Paint\fP. With the \fI\-\-nobuttondistinction\fP option, Tux Paint. With the "--nobuttondistinction" option,
mouse buttons #2 (middle) and #3 (right) can be used, as well. mouse buttons #2 (middle) and #3 (right) can be used, as well.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to only recognize button #1. Default is to only recognize button #1.
@ -479,8 +479,8 @@ 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 \fIText\fP and Presents a clickable on-screen keyboard when using the Text and
\fILabel\fP tools. Label tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -488,7 +488,8 @@ Specify the default layout for the on-screen keyboard (see above).
.TP 8 .TP 8
.B \-\-onscreen-keyboard-disable-change .B \-\-onscreen-keyboard-disable-change
Disallow switching between on-screen keyboard layouts. Disables the left/right arrow buttons visible on the on-screen keyboard,
which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
@ -497,7 +498,7 @@ Specify which joystick device should be used by Tux Paint. Default value is 0 (t
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List available joysticks and exit. 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
@ -534,18 +535,44 @@ various tools within Tux Paint.
.TP 2 .TP 2
- -
brush | Brush brush | Brush
.TP 2
-
lines | Lines lines | Lines
.TP 2
-
shapes | Shapes shapes | Shapes
.TP 2
-
text | Text text | Text
.TP 2
-
label | Label label | Label
.TP 2
-
magic | Magic magic | Magic
.TP 2
-
undo | Undo undo | Undo
.TP 2
-
redo | Redo redo | Redo
.TP 2
-
eraser | Eraser eraser | Eraser
.TP 2
-
new | New new | New
.TP 2
-
open | Open open | Open
.TP 2
-
save | Save save | Save
.TP 2
-
pgsetup | Print (dialog) pgsetup | Print (dialog)
.TP 2
-
print | Print (immediate) print | Print (immediate)
.RE .RE
.PD .PD
@ -554,7 +581,7 @@ print | Print (immediate)
.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. Otherwise, unless they are used by one of the be ignored. Otherwise, unless they are used by one of the
\-\-joystick-btn-... options above, buttons will be seen as a mouse "--joystick-btn-..." options above, buttons will be seen as a mouse
left-click. Comma-separated. left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
@ -566,7 +593,7 @@ override options set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
.B \-\-noprint \-\-print .B \-\-noprint \-\-print
Disable or enable (default) the \fIPrint\fP command within \fITux Paint\fP. 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
@ -578,17 +605,17 @@ seconds. Default is 0 (no limitation).
.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 \fIPrint\fP button. By default (\-\-altprintmod), pressing
\fI[ALT]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're \fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, in fullscreen mode). With \-\-altprintalways, the dialog will always appear,
even if \fI[ALT]\fP is not being held. With \-\-altprintnever, the dialog even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog
will never appear, even if \fI[ALT]\fP is being held. will never appear, even if \fI[Alt]\fP 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, \fITux Paint\fP will print to the default
printer with default settings. Pressing \fI[ALT]\fP while pushing the printer with default settings. Pressing \fI[Alt]\fP while pushing the
\fIPrint\fP button will cause a printer dialog to appear (as long as you're \fIPrint\fP button will cause a printer dialog to appear (as long as you're
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever,
below.) Unless \-\-noprintcfg is used, your previous settings will below.) Unless \-\-noprintcfg is used, your previous settings will
@ -605,7 +632,7 @@ Have Tux Paint print via an alternate command, rather than lpr(1).
.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 \- not Windows, Mac OS X or BeOS.)
Have Tux Paint print via an alternate command, when a dialog is expect Have Tux Paint print via an alternate command, when a dialog is expect
(e.g., when holding \fI[ALT]\fP while clicking "Print"; see above), (e.g., when holding \fI[Alt]\fP while clicking "Print"; see above),
rather than kprinter. rather than kprinter.
.SS PAPER SIZE .SS PAPER SIZE
@ -1206,28 +1233,27 @@ inside which causes it to expire after 30 seconds.)
.RE .RE
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify This program is free software; you can redistribute it and/or modify it
it under the terms of the GNU General Public License as published by under the terms of the GNU General Public License as published by the Free
the Free Software Foundation; either version 2 of the License, or Software Foundation; either version 2 of the License, or (at your option)
(at your option) any later version. any later version.
.SH OTHER INFO .SH OTHER INFO
See the documentation that comes with \fITux Paint\fP for further instructions on See the documentation that comes with Tux Paint for further instructions on using the program's features.
using the program's features.
The canonical place to find \fITux Paint\fP information is at The canonical place to find Tux Paint information is at
.nh .nh
http://www.tuxpaint.org/. http://www.tuxpaint.org/.
.hy .hy
.SH AUTHORS .SH AUTHORS
Lead developer & project manager: Bill Kendrick Lead developer and project manager: Bill Kendrick.nh
.nh
<bill@newbreedsoftware.com>. <bill@newbreedsoftware.com>.
.hy .hy
With patches, fixes, extensions, porting, translations, documentation, and more from With patches, fixes, extensions, porting, translations, documentation, and
lots of people, including, but probably not limited to (see AUTHORS.txt and CHANGES.txt): more from lots of people, including, but probably not limited to (see
AUTHORS.txt and CHANGES.txt):
Aki, Aki,
Ashish Arora, Ashish Arora,
@ -1478,7 +1504,7 @@ Martin Zhekov,
and and
Huang Zuzhen. Huang Zuzhen.
.SH "SEE ALSO" .SH SEE ALSO
.BR tuxpaint-import (1), .BR tuxpaint-import (1),
.BR tuxpaint-config (1), .BR tuxpaint-config (1),
.BR tp-magic-config (1), .BR tp-magic-config (1),
@ -1489,4 +1515,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/.

View file

@ -284,7 +284,8 @@ Show the license (GNU GPL) under which Tux Paint is released.
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.)
.SS VIDEO.TP 8 .SS VIDEO
.TP 8
.B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed .B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed
Run \fITux Paint\fP in full-screen mode at its default -- or a specified -- Run \fITux Paint\fP in full-screen mode at its default -- or a specified --
screen resolution ("--fullscreen=yes"); or in full-screen mode at the screen resolution ("--fullscreen=yes"); or in full-screen mode at the
@ -298,22 +299,22 @@ When in fullscreen mode, use the system's default screen resolution.
.TP 8 .TP 8
.B \-\-WIDTHxHEIGHT .B \-\-WIDTHxHEIGHT
Run \fITux Paint\fP in a particularly-sized window, or at a particular Run \fITux Paint\fP in a particularly-sized window, or at a particular
fullscreen resolution (if \-\-native is not used). Default is 800x600. fullscreen resolution (if \-\-native is not used). Default is 800x600.
Minimum width is 640. Minimum height is 480. Portrait and landscape Minimum width is 640. Minimum height is 480. Portrait and landscape
orientations are both supported. (Also see \-\-orient, below.) orientations are both supported. (Also see \-\-orient, below.)
.TP 8 .TP 8
.B \-\-orient=landscape \-\-orient=portrait .B \-\-orient=landscape \-\-orient=portrait
If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and HEIGHT If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and
values it uses for windowed or fullscreen mode, without having to actually HEIGHT values it uses for windowed or fullscreen mode, without having to
change the WIDTH and HEIGHT values in the configuration file or on the actually change the WIDTH and HEIGHT values in the configuration file or on
command-line. (This is useful on devices where the screen can be rotated, the command-line. (This is useful on devices where the screen can be
e.g. tablet PCs.) rotated, e.g. tablet PCs.)
.TP 8 .TP 8
.B \-\-allowscreensaver \-\-disablescreensaver .B \-\-allowscreensaver \-\-disablescreensaver
Normally, \fItuxpaint\fP disables your screensaver. Use \-\-allowscreensaver Normally, \fItuxpaint\fP disables your screensaver. Use
to prevent this from happening. \-\-allowscreensaver to prevent this from happening.
.SS SOUND .SS SOUND
.TP 8 .TP 8
@ -326,54 +327,53 @@ Disable or enable (default) stereo panning support.
.SS INTERFACE SIZE .SS INTERFACE SIZE
.TP 8 .TP 8
.B \-\-buttonsize SIZE .B \-\-buttonsize SIZEAdjust the size of the buttons in \fITux Paint\fP's user interface, between
Adjust the size of the buttons in \fITux Paint's\fP user interface, 24 and 192 pixels (48 is the default, and suitable for displays with 96 to
between 24 and 192 pixels (48 is the default, and suitable for displays 120dpi pixel density).
with 96 to 120dpi pixel density).
.TP 8 .TP 8
.B \-\-colorsrows=\fIrows\fP .B \-\-colorsrows=\fIROWS\fP
How many rows of color palette buttons to show; useful when using How many rows of color palette buttons to show; useful when using a large
a large color palette, and/or for use with coarse input devices color palette, and/or for use with coarse input devices (like eyegaze
(like eyegaze trackers). It can be between 1 (default) and 3. trackers). It can be between 1 (default) and 3.
.SS INTERFACE SIMPLIFICATION .SS INTERFACE SIMPLIFICATION
.TP 8 .TP 8
.B \-\-simpleshapes \-\-complexshapes .B \-\-simpleshapes \-\-complexshapes
Disable or enable (default) the \fIrotation\fP step when using the Disable or enable (default) the rotation step when using the Shape tool
\fIShape\fP tool within \fITux Paint\fP. When disabled, shapes cannot be within Tux Paint. When disabled, shapes cannot be rotated; however, the
rotated; however, the interface is easier (click, drag, release), which can interface is easier (click, drag, release), which can be useful for younger
be useful for younger or disabled children. or disabled children.
.TP 8 .TP 8
.B \-\-nooutlines \-\-outlines .B \-\-nooutlines \-\-outlines
In \fInooutlines\fP mode, much simpler outlines and 'rubber-band' lines are With "--nooutlines" enabled, much simpler outlines and 'rubber-band' lines
displayed when using the \fILines\fP, \fIShapes\fP, \fIStamps\fP and are displayed when using the Lines, Shapes, Stamps and Eraser tools. (This
\fIEraser\fP tools. (This can help when \fITux Paint\fP is run on slower can help when Tux Paint is run on slower computers, or displayed on a
computers, or displayed on a remote X display.) remote terminal.)
.TP 8 .TP 8
.B \-\-uppercase \-\-mixedcase .B \-\-uppercase \-\-mixedcase
In \fIuppercase\fP mode, all text prompts and the \fIText\fP drawing tool With "--uppercase" enabled, all text prompts and the Text and Label drawing
will display only uppercase letters. This is useful for children who are not tools will display only uppercase letters. This is useful for children who
yet comfortable with the lowercase characterset. Default mode is are not yet comfortable with the lowercase characterset. Default mode is
\fImixed case\fP. mixed case.
.SS INITIAL STAMP SIZE .SS INITIAL STAMP SIZE
.TP 8 .TP 8
.B \-\-stampsize=\fIsize\fP \-\-stampsize=default .B \-\-stampsize=\fISIZE\fP \-\-stampsize=default
Sets the default size of all stamps, relative to their possible sizes Overrides the default size of all stamps, relative to their possible sizes
(determined by \fITux Paint\fP, based on the dimensions of both the stamps (determined by Tux Paint, based on the dimensions of both the stamps
themselves, and the drawing canvas). Valid values are from 0 (smallest) themselves, and the drawing canvas). Valid values are from 0 (smallest) to
to 10 (largest). Use \fIdefault\fP to let \fITux Paint\fP choose 10 (largest). Use "--stampsize=default" to let ITux Paint P choose on a
(this is the default setting). per-stamp basis (this is the default setting).
.SS STARTING OUT .SS STARTING OUT
.TP 8 .TP 8
.B \-\-startblank \-\-startlast .B \-\-startblank \-\-startlast
When you start \fITux Paint\fP, it loads the last image that was being worked When you start Tux Paint, it loads the last image that was being worked on.
on. The \fI\-\-startblank\fP option disables this, so it always starts with The "\-\-startblank" option disables this, so it always starts with a
a blank canvas. The default behavior is \fI\-\-startlast\fP. blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
@ -383,15 +383,15 @@ options displayed when using the \fINew\fP 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 \fIQuit\fP button and \fIEscape\fP Disable or enable (default) the on-screen Quit button and [Escape]
key sequence for quitting \fITux Paint\fP. Instead, use the window close key for quitting Tux Paint. Instead, use the window close
button in the titlebar, the \fIAlt+F4\fP key sequence, or the button in the titlebar, the [Al]+[F4] key sequence, or the
\fIShift+Control+Escape\fP key sequence. [Shift]+[Control]+[Escape] key sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With \fInostamps\fP set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the
\fIStamps\fP tool will not be available. This option can be used to reduce Stamps tool will not be available. This option can be used to reduce
the time Tux Paint takes to load, and reduce the amount of RAM it requires. the time Tux Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
@ -415,7 +415,7 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the \fILabel\fP tool, which lets you create Disable or enable (default) the Label tool, which lets you create
text which can be altered or moved later. text which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
@ -427,31 +427,31 @@ set in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
.B \-\-nofancycursors \-\-fancycursors .B \-\-nofancycursors \-\-fancycursors
Disable or enable (default) the 'fancy' mouse pointer shapes in \fITux Paint\fP. Disable or enable (default) the 'fancy' mouse pointer shapes in Tux Paint.
While the shapes are larger, and context sensitive, some environments have While the shapes are larger, and context sensitive, some environments have
trouble displaying the mouse pointer, and/or leave 'trails' on the screen. 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 \fITux Paint\fP. Completely hide, or enable (default) the mouse pointer in Tux Paint.
This can be useful on touchscreen devices, such as tablet PCs. This 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) If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save)
will be disabled. Default mode is \fIshortcuts enabled\fP. will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
.B \-\-grab \-\-dontgrab .B \-\-grab \-\-dontgrab
Grab the mouse and keyboard input (if possible), so that the mouse is Grab the mouse and keyboard input (if possible), so that the mouse is
confined to the \fITux Paint\fP window. Default is to not grab. 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
\fIselector\fP 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 completely ignored, with the \fI\-\-nowheelmouse\fP option. wheel completely ignored, with the \fI\-\-nowheelmouse\fP option.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to support the wheel. Default is to support the wheel.
@ -463,15 +463,15 @@ you click, move, and click again to end the motion.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The \fIkeyboard\fP option lets the mouse pointer in \fITux Paint\fP be The "--keyboard" option lets the mouse pointer in Tux Paint be
controlled with the keyboard. The \fIarrow keys\fP move the pointer. controlled with the keyboard. The [Up], [Down], [Left], and [Right]
\fISpacebar\fP acts as the mouse button. arrow keys move 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 mice with more than one button) can be used for interacting with on mice with more than one button) can be used for interacting with
\fITux Paint\fP. With the \fI\-\-nobuttondistinction\fP option, Tux Paint. With the "--nobuttondistinction" option,
mouse buttons #2 (middle) and #3 (right) can be used, as well. mouse buttons #2 (middle) and #3 (right) can be used, as well.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to only recognize button #1. Default is to only recognize button #1.
@ -479,8 +479,8 @@ 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 \fIText\fP and Presents a clickable on-screen keyboard when using the Text and
\fILabel\fP tools. Label tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -488,7 +488,8 @@ Specify the default layout for the on-screen keyboard (see above).
.TP 8 .TP 8
.B \-\-onscreen-keyboard-disable-change .B \-\-onscreen-keyboard-disable-change
Disallow switching between on-screen keyboard layouts. Disables the left/right arrow buttons visible on the on-screen keyboard,
which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
@ -497,7 +498,7 @@ Specify which joystick device should be used by Tux Paint. Default value is 0 (t
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List available joysticks and exit. 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
@ -534,18 +535,44 @@ various tools within Tux Paint.
.TP 2 .TP 2
- -
brush | Brush brush | Brush
.TP 2
-
lines | Lines lines | Lines
.TP 2
-
shapes | Shapes shapes | Shapes
.TP 2
-
text | Text text | Text
.TP 2
-
label | Label label | Label
.TP 2
-
magic | Magic magic | Magic
undo | Undo .TP 2
redo | Redo -
undo | Défaire
.TP 2
-
redo | Refaire
.TP 2
-
eraser | Eraser eraser | Eraser
.TP 2
-
new | New new | New
.TP 2
-
open | Open open | Open
.TP 2
-
save | Save save | Save
.TP 2
-
pgsetup | Print (dialog) pgsetup | Print (dialog)
.TP 2
-
print | Print (immediate) print | Print (immediate)
.RE .RE
.PD .PD
@ -554,7 +581,7 @@ print | Print (immediate)
.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. Otherwise, unless they are used by one of the be ignored. Otherwise, unless they are used by one of the
\-\-joystick-btn-... options above, buttons will be seen as a mouse "--joystick-btn-..." options above, buttons will be seen as a mouse
left-click. Comma-separated. left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
@ -566,10 +593,10 @@ override options set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
.B \-\-noprint \-\-print .B \-\-noprint \-\-print
Disable or enable (default) the \fIPrint\fP command within \fITux Paint\fP. Disable or enable (default) the Print command within Tux Paint.
.TP 8 .TP 8
.B \-\-printdelay=\fISECONDS\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 \fIPrint\fP command) once every \fISECONDS\fP
seconds. Default is 0 (no limitation). seconds. Default is 0 (no limitation).
@ -578,17 +605,17 @@ seconds. Default is 0 (no limitation).
.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 \fIPrint\fP button. By default (\-\-altprintmod), pressing
\fI[ALT]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're \fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, in fullscreen mode). With \-\-altprintalways, the dialog will always appear,
even if \fI[ALT]\fP is not being held. With \-\-altprintnever, the dialog even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog
will never appear, even if \fI[ALT]\fP is being held. will never appear, even if \fI[Alt]\fP 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, \fITux Paint\fP will print to the default
printer with default settings. Pressing \fI[ALT]\fP while pushing the printer with default settings. Pressing \fI[Alt]\fP while pushing the
\fIPrint\fP button will cause a printer dialog to appear (as long as you're \fIPrint\fP button will cause a printer dialog to appear (as long as you're
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever,
below.) Unless \-\-noprintcfg is used, your previous settings will below.) Unless \-\-noprintcfg is used, your previous settings will
@ -605,7 +632,7 @@ Have Tux Paint print via an alternate command, rather than lpr(1).
.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 \- not Windows, Mac OS X or BeOS.)
Have Tux Paint print via an alternate command, when a dialog is expect Have Tux Paint print via an alternate command, when a dialog is expect
(e.g., when holding \fI[ALT]\fP while clicking "Print"; see above), (e.g., when holding \fI[Alt]\fP while clicking "Print"; see above),
rather than kprinter. rather than kprinter.
.SS PAPER SIZE .SS PAPER SIZE
@ -1206,28 +1233,27 @@ inside which causes it to expire after 30 seconds.)
.RE .RE
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify This program is free software; you can redistribute it and/or modify it
it under the terms of the GNU General Public License as published by under the terms of the GNU General Public License as published by the Free
the Free Software Foundation; either version 2 of the License, or Software Foundation; either version 2 of the License, or (at your option)
(at your option) any later version. any later version.
.SH OTHER INFO .SH OTHER INFO
See the documentation that comes with \fITux Paint\fP for further instructions on See the documentation that comes with Tux Paint for further instructions on using the program's features.
using the program's features.
The canonical place to find \fITux Paint\fP information is at The canonical place to find Tux Paint information is at
.nh .nh
http://www.tuxpaint.org/. http://www.tuxpaint.org/.
.hy .hy
.SH AUTHORS .SH AUTHORS
Lead developer & project manager: Bill Kendrick Lead developer and project manager: Bill Kendrick.nh
.nh
<bill@newbreedsoftware.com>. <bill@newbreedsoftware.com>.
.hy .hy
With patches, fixes, extensions, porting, translations, documentation, and more from With patches, fixes, extensions, porting, translations, documentation, and
lots of people, including, but probably not limited to (see AUTHORS.txt and CHANGES.txt): more from lots of people, including, but probably not limited to (see
AUTHORS.txt and CHANGES.txt):
Aki, Aki,
Ashish Arora, Ashish Arora,
@ -1478,7 +1504,7 @@ Martin Zhekov,
and and
Huang Zuzhen. Huang Zuzhen.
.SH "SEE ALSO" .SH SEE ALSO
.BR tuxpaint-import (1), .BR tuxpaint-import (1),
.BR tuxpaint-config (1), .BR tuxpaint-config (1),
.BR tp-magic-config (1), .BR tp-magic-config (1),
@ -1489,4 +1515,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/.

View file

@ -284,7 +284,8 @@ Show the license (GNU GPL) under which Tux Paint is released.
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.)
.SS VIDEO.TP 8 .SS VIDEO
.TP 8
.B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed .B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed
Run \fITux Paint\fP in full-screen mode at its default -- or a specified -- Run \fITux Paint\fP in full-screen mode at its default -- or a specified --
screen resolution ("--fullscreen=yes"); or in full-screen mode at the screen resolution ("--fullscreen=yes"); or in full-screen mode at the
@ -298,22 +299,22 @@ When in fullscreen mode, use the system's default screen resolution.
.TP 8 .TP 8
.B \-\-WIDTHxHEIGHT .B \-\-WIDTHxHEIGHT
Run \fITux Paint\fP in a particularly-sized window, or at a particular Run \fITux Paint\fP in a particularly-sized window, or at a particular
fullscreen resolution (if \-\-native is not used). Default is 800x600. fullscreen resolution (if \-\-native is not used). Default is 800x600.
Minimum width is 640. Minimum height is 480. Portrait and landscape Minimum width is 640. Minimum height is 480. Portrait and landscape
orientations are both supported. (Also see \-\-orient, below.) orientations are both supported. (Also see \-\-orient, below.)
.TP 8 .TP 8
.B \-\-orient=landscape \-\-orient=portrait .B \-\-orient=landscape \-\-orient=portrait
If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and HEIGHT If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and
values it uses for windowed or fullscreen mode, without having to actually HEIGHT values it uses for windowed or fullscreen mode, without having to
change the WIDTH and HEIGHT values in the configuration file or on the actually change the WIDTH and HEIGHT values in the configuration file or on
command-line. (This is useful on devices where the screen can be rotated, the command-line. (This is useful on devices where the screen can be
e.g. tablet PCs.) rotated, e.g. tablet PCs.)
.TP 8 .TP 8
.B \-\-allowscreensaver \-\-disablescreensaver .B \-\-allowscreensaver \-\-disablescreensaver
Normally, \fItuxpaint\fP disables your screensaver. Use \-\-allowscreensaver Normally, \fItuxpaint\fP disables your screensaver. Use
to prevent this from happening. \-\-allowscreensaver to prevent this from happening.
.SS SOUND .SS SOUND
.TP 8 .TP 8
@ -326,54 +327,53 @@ Disable or enable (default) stereo panning support.
.SS INTERFACE SIZE .SS INTERFACE SIZE
.TP 8 .TP 8
.B \-\-buttonsize SIZE .B \-\-buttonsize TAMAÑOAdjust the size of the buttons in \fITux Paint\fP's user interface, between
Adjust the size of the buttons in \fITux Paint's\fP user interface, 24 and 192 pixels (48 is the default, and suitable for displays with 96 to
between 24 and 192 pixels (48 is the default, and suitable for displays 120dpi pixel density).
with 96 to 120dpi pixel density).
.TP 8 .TP 8
.B \-\-colorsrows=\fIrows\fP .B \-\-colorsrows=\fIFILAS\fP
How many rows of color palette buttons to show; useful when using How many rows of color palette buttons to show; useful when using a large
a large color palette, and/or for use with coarse input devices color palette, and/or for use with coarse input devices (like eyegaze
(like eyegaze trackers). It can be between 1 (default) and 3. trackers). It can be between 1 (default) and 3.
.SS INTERFACE SIMPLIFICATION .SS INTERFACE SIMPLIFICATION
.TP 8 .TP 8
.B \-\-simpleshapes \-\-complexshapes .B \-\-simpleshapes \-\-complexshapes
Disable or enable (default) the \fIrotation\fP step when using the Disable or enable (default) the rotation step when using the Shape tool
\fIShape\fP tool within \fITux Paint\fP. When disabled, shapes cannot be within Tux Paint. When disabled, shapes cannot be rotated; however, the
rotated; however, the interface is easier (click, drag, release), which can interface is easier (click, drag, release), which can be useful for younger
be useful for younger or disabled children. or disabled children.
.TP 8 .TP 8
.B \-\-nooutlines \-\-outlines .B \-\-nooutlines \-\-outlines
In \fInooutlines\fP mode, much simpler outlines and 'rubber-band' lines are With "--nooutlines" enabled, much simpler outlines and 'rubber-band' lines
displayed when using the \fILines\fP, \fIShapes\fP, \fIStamps\fP and are displayed when using the Lines, Shapes, Stamps and Eraser tools. (This
\fIEraser\fP tools. (This can help when \fITux Paint\fP is run on slower can help when Tux Paint is run on slower computers, or displayed on a
computers, or displayed on a remote X display.) remote terminal.)
.TP 8 .TP 8
.B \-\-uppercase \-\-mixedcase .B \-\-uppercase \-\-mixedcase
In \fIuppercase\fP mode, all text prompts and the \fIText\fP drawing tool With "--uppercase" enabled, all text prompts and the Text and Label drawing
will display only uppercase letters. This is useful for children who are not tools will display only uppercase letters. This is useful for children who
yet comfortable with the lowercase characterset. Default mode is are not yet comfortable with the lowercase characterset. Default mode is
\fImixed case\fP. mixed case.
.SS INITIAL STAMP SIZE .SS INITIAL STAMP SIZE
.TP 8 .TP 8
.B \-\-stampsize=\fIsize\fP \-\-stampsize=default .B \-\-stampsize=\fITAMAÑO\fP \-\-stampsize=default
Sets the default size of all stamps, relative to their possible sizes Overrides the default size of all stamps, relative to their possible sizes
(determined by \fITux Paint\fP, based on the dimensions of both the stamps (determined by Tux Paint, based on the dimensions of both the stamps
themselves, and the drawing canvas). Valid values are from 0 (smallest) themselves, and the drawing canvas). Valid values are from 0 (smallest) to
to 10 (largest). Use \fIdefault\fP to let \fITux Paint\fP choose 10 (largest). Use "--stampsize=default" to let ITux Paint P choose on a
(this is the default setting). per-stamp basis (this is the default setting).
.SS STARTING OUT .SS STARTING OUT
.TP 8 .TP 8
.B \-\-startblank \-\-startlast .B \-\-startblank \-\-startlast
When you start \fITux Paint\fP, it loads the last image that was being worked When you start Tux Paint, it loads the last image that was being worked on.
on. The \fI\-\-startblank\fP option disables this, so it always starts with The "\-\-startblank" option disables this, so it always starts with a
a blank canvas. The default behavior is \fI\-\-startlast\fP. blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
@ -383,15 +383,15 @@ options displayed when using the \fINew\fP 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 \fIQuit\fP button and \fIEscape\fP Disable or enable (default) the on-screen Quit button and [Escape]
key sequence for quitting \fITux Paint\fP. Instead, use the window close key for quitting Tux Paint. Instead, use the window close
button in the titlebar, the \fIAlt+F4\fP key sequence, or the button in the titlebar, the [Al]+[F4] key sequence, or the
\fIShift+Control+Escape\fP key sequence. [Shift]+[Control]+[Escape] key sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With \fInostamps\fP set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the
\fIStamps\fP tool will not be available. This option can be used to reduce Stamps tool will not be available. This option can be used to reduce
the time Tux Paint takes to load, and reduce the amount of RAM it requires. the time Tux Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
@ -415,7 +415,7 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the \fILabel\fP tool, which lets you create Disable or enable (default) the Label tool, which lets you create
text which can be altered or moved later. text which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
@ -427,31 +427,31 @@ set in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
.B \-\-nofancycursors \-\-fancycursors .B \-\-nofancycursors \-\-fancycursors
Disable or enable (default) the 'fancy' mouse pointer shapes in \fITux Paint\fP. Disable or enable (default) the 'fancy' mouse pointer shapes in Tux Paint.
While the shapes are larger, and context sensitive, some environments have While the shapes are larger, and context sensitive, some environments have
trouble displaying the mouse pointer, and/or leave 'trails' on the screen. 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 \fITux Paint\fP. Completely hide, or enable (default) the mouse pointer in Tux Paint.
This can be useful on touchscreen devices, such as tablet PCs. This 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) If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save)
will be disabled. Default mode is \fIshortcuts enabled\fP. will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
.B \-\-grab \-\-dontgrab .B \-\-grab \-\-dontgrab
Grab the mouse and keyboard input (if possible), so that the mouse is Grab the mouse and keyboard input (if possible), so that the mouse is
confined to the \fITux Paint\fP window. Default is to not grab. 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
\fIselector\fP 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 completely ignored, with the \fI\-\-nowheelmouse\fP option. wheel completely ignored, with the \fI\-\-nowheelmouse\fP option.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to support the wheel. Default is to support the wheel.
@ -463,15 +463,15 @@ you click, move, and click again to end the motion.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The \fIkeyboard\fP option lets the mouse pointer in \fITux Paint\fP be The "--keyboard" option lets the mouse pointer in Tux Paint be
controlled with the keyboard. The \fIarrow keys\fP move the pointer. controlled with the keyboard. The [Up], [Down], [Left], and [Right]
\fISpacebar\fP acts as the mouse button. arrow keys move 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 mice with more than one button) can be used for interacting with on mice with more than one button) can be used for interacting with
\fITux Paint\fP. With the \fI\-\-nobuttondistinction\fP option, Tux Paint. With the "--nobuttondistinction" option,
mouse buttons #2 (middle) and #3 (right) can be used, as well. mouse buttons #2 (middle) and #3 (right) can be used, as well.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to only recognize button #1. Default is to only recognize button #1.
@ -479,8 +479,8 @@ 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 \fIText\fP and Presents a clickable on-screen keyboard when using the Text and
\fILabel\fP tools. Label tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -488,7 +488,8 @@ Specify the default layout for the on-screen keyboard (see above).
.TP 8 .TP 8
.B \-\-onscreen-keyboard-disable-change .B \-\-onscreen-keyboard-disable-change
Disallow switching between on-screen keyboard layouts. Disables the left/right arrow buttons visible on the on-screen keyboard,
which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
@ -497,26 +498,26 @@ Specify which joystick device should be used by Tux Paint. Default value is 0 (t
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List available joysticks and exit. 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=\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. 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=\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. 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=\fIPASOS\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=\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. 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=\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. 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
@ -524,7 +525,7 @@ Sets a delay at each automatic motion, allowing to slow the speed of the hat. Al
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-\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 to
various tools within Tux Paint. various tools within Tux Paint.
@ -534,27 +535,53 @@ various tools within Tux Paint.
.TP 2 .TP 2
- -
brush | Brush brush | Brush
.TP 2
-
lines | Lines lines | Lines
.TP 2
-
shapes | Shapes shapes | Shapes
.TP 2
-
text | Text text | Text
.TP 2
-
label | Label label | Label
.TP 2
-
magic | Magic magic | Magic
undo | Undo .TP 2
redo | Redo -
undo | Desfacer
.TP 2
-
redo | Refacer
.TP 2
-
eraser | Eraser eraser | Eraser
.TP 2
-
new | New new | New
.TP 2
-
open | Open open | Open
.TP 2
-
save | Save save | Save
.TP 2
-
pgsetup | Print (dialog) pgsetup | Print (dialog)
.TP 2
-
print | Print (immediate) print | Print (immediate)
.RE .RE
.PD .PD
.TP 8 .TP 8
.B \-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\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. Otherwise, unless they are used by one of the be ignored. Otherwise, unless they are used by one of the
\-\-joystick-btn-... options above, buttons will be seen as a mouse "--joystick-btn-..." options above, buttons will be seen as a mouse
left-click. Comma-separated. left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
@ -566,10 +593,10 @@ override options set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
.B \-\-noprint \-\-print .B \-\-noprint \-\-print
Disable or enable (default) the \fIPrint\fP command within \fITux Paint\fP. Disable or enable (default) the Print command within Tux Paint.
.TP 8 .TP 8
.B \-\-printdelay=\fISECONDS\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 \fIPrint\fP command) once every \fISECONDS\fP
seconds. Default is 0 (no limitation). seconds. Default is 0 (no limitation).
@ -578,17 +605,17 @@ seconds. Default is 0 (no limitation).
.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 \fIPrint\fP button. By default (\-\-altprintmod), pressing
\fI[ALT]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're \fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, in fullscreen mode). With \-\-altprintalways, the dialog will always appear,
even if \fI[ALT]\fP is not being held. With \-\-altprintnever, the dialog even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog
will never appear, even if \fI[ALT]\fP is being held. will never appear, even if \fI[Alt]\fP 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, \fITux Paint\fP will print to the default
printer with default settings. Pressing \fI[ALT]\fP while pushing the printer with default settings. Pressing \fI[Alt]\fP while pushing the
\fIPrint\fP button will cause a printer dialog to appear (as long as you're \fIPrint\fP button will cause a printer dialog to appear (as long as you're
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever,
below.) Unless \-\-noprintcfg is used, your previous settings will below.) Unless \-\-noprintcfg is used, your previous settings will
@ -597,20 +624,20 @@ for next time.
.SS PRINT COMMANDS .SS PRINT COMMANDS
.TP 8 .TP 8
.B \-\-printcommand \fICOMMAND\fP .B \-\-printcommand \fIORDE\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.)
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 \fIORDE\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.)
Have Tux Paint print via an alternate command, when a dialog is expect Have Tux Paint print via an alternate command, when a dialog is expect
(e.g., when holding \fI[ALT]\fP while clicking "Print"; see above), (e.g., when holding \fI[Alt]\fP while 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 \fITAMAÑO_DO_PAPEL\fP
(Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.) (Only when PostScript printing is used \- not Windows, Mac OS X or BeOS.)
Ask \fITux Paint\fP to generate PostScript of a particular paper size. Ask \fITux Paint\fP to generate PostScript of a particular paper size.
Valid sizes are those supported by libpaper. See papersize(5). Valid sizes are those supported by libpaper. See papersize(5).
@ -664,7 +691,7 @@ Specify where \fITux Paint\fP should look for personal data files
(brushes, stamps, etc.). (brushes, stamps, etc.).
.TP 8 .TP 8
.B \-\-colorfile \fIFILE\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 \fITux Paint\fP
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
@ -686,7 +713,7 @@ You can also specifically set the 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 \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 the
form \fIlanguage\fP[_\fIterritory\fP][.\fIcodeset\fP][@\fImodifier\fP], form \fIlanguage\fP[_\fIterritory\fP][.\fIcodeset\fP][@\fImodifier\fP],
where \fIlanguage\fP is an ISO 639 language code, where \fIlanguage\fP is an ISO 639 language code,
@ -1206,28 +1233,27 @@ inside which causes it to expire after 30 seconds.)
.RE .RE
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify This program is free software; you can redistribute it and/or modify it
it under the terms of the GNU General Public License as published by under the terms of the GNU General Public License as published by the Free
the Free Software Foundation; either version 2 of the License, or Software Foundation; either version 2 of the License, or (at your option)
(at your option) any later version. any later version.
.SH OTHER INFO .SH OTHER INFO
See the documentation that comes with \fITux Paint\fP for further instructions on See the documentation that comes with Tux Paint for further instructions on using the program's features.
using the program's features.
The canonical place to find \fITux Paint\fP information is at The canonical place to find Tux Paint information is at
.nh .nh
http://www.tuxpaint.org/. http://www.tuxpaint.org/.
.hy .hy
.SH AUTHORS .SH AUTHORS
Lead developer & project manager: Bill Kendrick Lead developer and project manager: Bill Kendrick.nh
.nh
<bill@newbreedsoftware.com>. <bill@newbreedsoftware.com>.
.hy .hy
With patches, fixes, extensions, porting, translations, documentation, and more from With patches, fixes, extensions, porting, translations, documentation, and
lots of people, including, but probably not limited to (see AUTHORS.txt and CHANGES.txt): more from lots of people, including, but probably not limited to (see
AUTHORS.txt and CHANGES.txt):
Aki, Aki,
Ashish Arora, Ashish Arora,
@ -1478,7 +1504,7 @@ Martin Zhekov,
and and
Huang Zuzhen. Huang Zuzhen.
.SH "SEE ALSO" .SH SEE ALSO
.BR tuxpaint-import (1), .BR tuxpaint-import (1),
.BR tuxpaint-config (1), .BR tuxpaint-config (1),
.BR tp-magic-config (1), .BR tp-magic-config (1),
@ -1489,4 +1515,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/.

View file

@ -284,7 +284,8 @@ Show the license (GNU GPL) under which Tux Paint is released.
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.)
.SS VIDEO.TP 8 .SS VIDEO
.TP 8
.B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed .B \-\-fullscreen=yes \-\-fullscreen=native \-\-fullscreen=no \-\-windowed
Run \fITux Paint\fP in full-screen mode at its default -- or a specified -- Run \fITux Paint\fP in full-screen mode at its default -- or a specified --
screen resolution ("--fullscreen=yes"); or in full-screen mode at the screen resolution ("--fullscreen=yes"); or in full-screen mode at the
@ -298,22 +299,22 @@ When in fullscreen mode, use the system's default screen resolution.
.TP 8 .TP 8
.B \-\-WIDTHxHEIGHT .B \-\-WIDTHxHEIGHT
Run \fITux Paint\fP in a particularly-sized window, or at a particular Run \fITux Paint\fP in a particularly-sized window, or at a particular
fullscreen resolution (if \-\-native is not used). Default is 800x600. fullscreen resolution (if \-\-native is not used). Default is 800x600.
Minimum width is 640. Minimum height is 480. Portrait and landscape Minimum width is 640. Minimum height is 480. Portrait and landscape
orientations are both supported. (Also see \-\-orient, below.) orientations are both supported. (Also see \-\-orient, below.)
.TP 8 .TP 8
.B \-\-orient=landscape \-\-orient=portrait .B \-\-orient=landscape \-\-orient=portrait
If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and HEIGHT If \-\-orient=portrait is set, asks \fITux Paint\fP to swap the WIDTH and
values it uses for windowed or fullscreen mode, without having to actually HEIGHT values it uses for windowed or fullscreen mode, without having to
change the WIDTH and HEIGHT values in the configuration file or on the actually change the WIDTH and HEIGHT values in the configuration file or on
command-line. (This is useful on devices where the screen can be rotated, the command-line. (This is useful on devices where the screen can be
e.g. tablet PCs.) rotated, e.g. tablet PCs.)
.TP 8 .TP 8
.B \-\-allowscreensaver \-\-disablescreensaver .B \-\-allowscreensaver \-\-disablescreensaver
Normally, \fItuxpaint\fP disables your screensaver. Use \-\-allowscreensaver Normally, \fItuxpaint\fP disables your screensaver. Use
to prevent this from happening. \-\-allowscreensaver to prevent this from happening.
.SS SOUND .SS SOUND
.TP 8 .TP 8
@ -326,54 +327,53 @@ Disable or enable (default) stereo panning support.
.SS INTERFACE SIZE .SS INTERFACE SIZE
.TP 8 .TP 8
.B \-\-buttonsize SIZE .B \-\-buttonsize SIZEAdjust the size of the buttons in \fITux Paint\fP's user interface, between
Adjust the size of the buttons in \fITux Paint's\fP user interface, 24 and 192 pixels (48 is the default, and suitable for displays with 96 to
between 24 and 192 pixels (48 is the default, and suitable for displays 120dpi pixel density).
with 96 to 120dpi pixel density).
.TP 8 .TP 8
.B \-\-colorsrows=\fIrows\fP .B \-\-colorsrows=\fIROWS\fP
How many rows of color palette buttons to show; useful when using How many rows of color palette buttons to show; useful when using a large
a large color palette, and/or for use with coarse input devices color palette, and/or for use with coarse input devices (like eyegaze
(like eyegaze trackers). It can be between 1 (default) and 3. trackers). It can be between 1 (default) and 3.
.SS INTERFACE SIMPLIFICATION .SS INTERFACE SIMPLIFICATION
.TP 8 .TP 8
.B \-\-simpleshapes \-\-complexshapes .B \-\-simpleshapes \-\-complexshapes
Disable or enable (default) the \fIrotation\fP step when using the Disable or enable (default) the rotation step when using the Shape tool
\fIShape\fP tool within \fITux Paint\fP. When disabled, shapes cannot be within Tux Paint. When disabled, shapes cannot be rotated; however, the
rotated; however, the interface is easier (click, drag, release), which can interface is easier (click, drag, release), which can be useful for younger
be useful for younger or disabled children. or disabled children.
.TP 8 .TP 8
.B \-\-nooutlines \-\-outlines .B \-\-nooutlines \-\-outlines
In \fInooutlines\fP mode, much simpler outlines and 'rubber-band' lines are With "--nooutlines" enabled, much simpler outlines and 'rubber-band' lines
displayed when using the \fILines\fP, \fIShapes\fP, \fIStamps\fP and are displayed when using the Lines, Shapes, Stamps and Eraser tools. (This
\fIEraser\fP tools. (This can help when \fITux Paint\fP is run on slower can help when Tux Paint is run on slower computers, or displayed on a
computers, or displayed on a remote X display.) remote terminal.)
.TP 8 .TP 8
.B \-\-uppercase \-\-mixedcase .B \-\-uppercase \-\-mixedcase
In \fIuppercase\fP mode, all text prompts and the \fIText\fP drawing tool With "--uppercase" enabled, all text prompts and the Text and Label drawing
will display only uppercase letters. This is useful for children who are not tools will display only uppercase letters. This is useful for children who
yet comfortable with the lowercase characterset. Default mode is are not yet comfortable with the lowercase characterset. Default mode is
\fImixed case\fP. mixed case.
.SS INITIAL STAMP SIZE .SS INITIAL STAMP SIZE
.TP 8 .TP 8
.B \-\-stampsize=\fIsize\fP \-\-stampsize=default .B \-\-stampsize=\fISIZE\fP \-\-stampsize=default
Sets the default size of all stamps, relative to their possible sizes Overrides the default size of all stamps, relative to their possible sizes
(determined by \fITux Paint\fP, based on the dimensions of both the stamps (determined by Tux Paint, based on the dimensions of both the stamps
themselves, and the drawing canvas). Valid values are from 0 (smallest) themselves, and the drawing canvas). Valid values are from 0 (smallest) to
to 10 (largest). Use \fIdefault\fP to let \fITux Paint\fP choose 10 (largest). Use "--stampsize=default" to let ITux Paint P choose on a
(this is the default setting). per-stamp basis (this is the default setting).
.SS STARTING OUT .SS STARTING OUT
.TP 8 .TP 8
.B \-\-startblank \-\-startlast .B \-\-startblank \-\-startlast
When you start \fITux Paint\fP, it loads the last image that was being worked When you start Tux Paint, it loads the last image that was being worked on.
on. The \fI\-\-startblank\fP option disables this, so it always starts with The "\-\-startblank" option disables this, so it always starts with a
a blank canvas. The default behavior is \fI\-\-startlast\fP. blank canvas. The default behavior is "\-\-startlast".
.TP 8 .TP 8
.B \-\-newcolorslast \-\-newcolorsfirst .B \-\-newcolorslast \-\-newcolorsfirst
@ -383,15 +383,15 @@ options displayed when using the \fINew\fP 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 \fIQuit\fP button and \fIEscape\fP Disable or enable (default) the on-screen Quit button and [Escape]
key sequence for quitting \fITux Paint\fP. Instead, use the window close key for quitting Tux Paint. Instead, use the window close
button in the titlebar, the \fIAlt+F4\fP key sequence, or the button in the titlebar, the [Al]+[F4] key sequence, or the
\fIShift+Control+Escape\fP key sequence. [Shift]+[Control]+[Escape] key sequence.
.TP 8 .TP 8
.B \-\-nostamps \-\-stamps .B \-\-nostamps \-\-stamps
With \fInostamps\fP set, Rubber Stamp images are not loaded, so the With "--nostamps" set, Rubber Stamp images are not loaded, so the
\fIStamps\fP tool will not be available. This option can be used to reduce Stamps tool will not be available. This option can be used to reduce
the time Tux Paint takes to load, and reduce the amount of RAM it requires. the time Tux Paint takes to load, and reduce the amount of RAM it requires.
.TP 8 .TP 8
@ -415,7 +415,7 @@ initially clicked.
.TP 8 .TP 8
.B \-\-nolabel \-\-label .B \-\-nolabel \-\-label
Disable or enable (default) the \fILabel\fP tool, which lets you create Disable or enable (default) the Label tool, which lets you create
text which can be altered or moved later. text which can be altered or moved later.
.SH OPTIONS - CONTROLLING TUX PAINT .SH OPTIONS - CONTROLLING TUX PAINT
@ -427,31 +427,31 @@ set in configuration files. (See below.)
.SS CURSOR .SS CURSOR
.TP 8 .TP 8
.B \-\-nofancycursors \-\-fancycursors .B \-\-nofancycursors \-\-fancycursors
Disable or enable (default) the 'fancy' mouse pointer shapes in \fITux Paint\fP. Disable or enable (default) the 'fancy' mouse pointer shapes in Tux Paint.
While the shapes are larger, and context sensitive, some environments have While the shapes are larger, and context sensitive, some environments have
trouble displaying the mouse pointer, and/or leave 'trails' on the screen. 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 \fITux Paint\fP. Completely hide, or enable (default) the mouse pointer in Tux Paint.
This can be useful on touchscreen devices, such as tablet PCs. This 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) If \fInoshortcuts\fP mode, keyboard shortcuts (e.g., [Ctrl]+[S] for Save)
will be disabled. Default mode is \fIshortcuts enabled\fP. will be disabled. Default mode is for shortcuts to be enabled.
.SS MOUSE AND ACCESSIBILITY .SS MOUSE AND ACCESSIBILITY
.TP 8 .TP 8
.B \-\-grab \-\-dontgrab .B \-\-grab \-\-dontgrab
Grab the mouse and keyboard input (if possible), so that the mouse is Grab the mouse and keyboard input (if possible), so that the mouse is
confined to the \fITux Paint\fP window. Default is to not grab. 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
\fIselector\fP 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 completely ignored, with the \fI\-\-nowheelmouse\fP option. wheel completely ignored, with the \fI\-\-nowheelmouse\fP option.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to support the wheel. Default is to support the wheel.
@ -463,15 +463,15 @@ you click, move, and click again to end the motion.
.TP 8 .TP 8
.B \-\-keyboard \-\-mouse .B \-\-keyboard \-\-mouse
The \fIkeyboard\fP option lets the mouse pointer in \fITux Paint\fP be The "--keyboard" option lets the mouse pointer in Tux Paint be
controlled with the keyboard. The \fIarrow keys\fP move the pointer. controlled with the keyboard. The [Up], [Down], [Left], and [Right]
\fISpacebar\fP acts as the mouse button. arrow keys move 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 mice with more than one button) can be used for interacting with on mice with more than one button) can be used for interacting with
\fITux Paint\fP. With the \fI\-\-nobuttondistinction\fP option, Tux Paint. With the "--nobuttondistinction" option,
mouse buttons #2 (middle) and #3 (right) can be used, as well. mouse buttons #2 (middle) and #3 (right) can be used, as well.
This is useful for children who aren't yet comfortable with the mouse. This is useful for children who aren't yet comfortable with the mouse.
Default is to only recognize button #1. Default is to only recognize button #1.
@ -479,8 +479,8 @@ 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 \fIText\fP and Presents a clickable on-screen keyboard when using the Text and
\fILabel\fP tools. Label tools.
.TP 8 .TP 8
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP .B \-\-onscreen-keyboard-layout \fILAYOUT\fP
@ -488,7 +488,8 @@ Specify the default layout for the on-screen keyboard (see above).
.TP 8 .TP 8
.B \-\-onscreen-keyboard-disable-change .B \-\-onscreen-keyboard-disable-change
Disallow switching between on-screen keyboard layouts. Disables the left/right arrow buttons visible on the on-screen keyboard,
which are used to switch between the available on-screen keyboard layouts.
.SS JOYSTICK .SS JOYSTICK
.TP 8 .TP 8
@ -497,7 +498,7 @@ Specify which joystick device should be used by Tux Paint. Default value is 0 (t
.TP 8 .TP 8
.B \-\-joystick-dev=list .B \-\-joystick-dev=list
List available joysticks and exit. 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
@ -534,18 +535,44 @@ various tools within Tux Paint.
.TP 2 .TP 2
- -
brush | Brush brush | Brush
.TP 2
-
lines | Lines lines | Lines
.TP 2
-
shapes | Shapes shapes | Shapes
.TP 2
-
text | Text text | Text
.TP 2
-
label | Label label | Label
.TP 2
-
magic | Magic magic | Magic
undo | Undo .TP 2
redo | Redo -
undo | 取り消し
.TP 2
-
redo | やりなおし
.TP 2
-
eraser | Eraser eraser | Eraser
.TP 2
-
new | New new | New
.TP 2
-
open | Open open | Open
.TP 2
-
save | Save save | Save
.TP 2
-
pgsetup | Print (dialog) pgsetup | Print (dialog)
.TP 2
-
print | Print (immediate) print | Print (immediate)
.RE .RE
.PD .PD
@ -554,7 +581,7 @@ print | Print (immediate)
.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. Otherwise, unless they are used by one of the be ignored. Otherwise, unless they are used by one of the
\-\-joystick-btn-... options above, buttons will be seen as a mouse "--joystick-btn-..." options above, buttons will be seen as a mouse
left-click. Comma-separated. left-click. Comma-separated.
.SH OPTIONS - PRINTING .SH OPTIONS - PRINTING
@ -566,7 +593,7 @@ override options set in configuration files. (See below.)
.SS PRINT PERMISSIONS .SS PRINT PERMISSIONS
.TP 8 .TP 8
.B \-\-noprint \-\-print .B \-\-noprint \-\-print
Disable or enable (default) the \fIPrint\fP command within \fITux Paint\fP. 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
@ -578,17 +605,17 @@ seconds. Default is 0 (no limitation).
.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 \fIPrint\fP button. By default (\-\-altprintmod), pressing
\fI[ALT]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're \fI[Alt]\fP while clicking \fIPrint\fP will bring up a dialog (unless you're
in fullscreen mode). With \-\-altprintalways, the dialog will always appear, in fullscreen mode). With \-\-altprintalways, the dialog will always appear,
even if \fI[ALT]\fP is not being held. With \-\-altprintnever, the dialog even if \fI[Alt]\fP is not being held. With \-\-altprintnever, the dialog
will never appear, even if \fI[ALT]\fP is being held. will never appear, even if \fI[Alt]\fP 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, \fITux Paint\fP will print to the default
printer with default settings. Pressing \fI[ALT]\fP while pushing the printer with default settings. Pressing \fI[Alt]\fP while pushing the
\fIPrint\fP button will cause a printer dialog to appear (as long as you're \fIPrint\fP button will cause a printer dialog to appear (as long as you're
not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever, not in fullscreen mode; see also \-\-altprintalways and \-\-altprintnever,
below.) Unless \-\-noprintcfg is used, your previous settings will below.) Unless \-\-noprintcfg is used, your previous settings will
@ -605,7 +632,7 @@ Have Tux Paint print via an alternate command, rather than lpr(1).
.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 \- not Windows, Mac OS X or BeOS.)
Have Tux Paint print via an alternate command, when a dialog is expect Have Tux Paint print via an alternate command, when a dialog is expect
(e.g., when holding \fI[ALT]\fP while clicking "Print"; see above), (e.g., when holding \fI[Alt]\fP while clicking "Print"; see above),
rather than kprinter. rather than kprinter.
.SS PAPER SIZE .SS PAPER SIZE
@ -1206,28 +1233,27 @@ inside which causes it to expire after 30 seconds.)
.RE .RE
.SH COPYRIGHT .SH COPYRIGHT
This program is free software; you can redistribute it and/or modify This program is free software; you can redistribute it and/or modify it
it under the terms of the GNU General Public License as published by under the terms of the GNU General Public License as published by the Free
the Free Software Foundation; either version 2 of the License, or Software Foundation; either version 2 of the License, or (at your option)
(at your option) any later version. any later version.
.SH OTHER INFO .SH OTHER INFO
See the documentation that comes with \fITux Paint\fP for further instructions on See the documentation that comes with Tux Paint for further instructions on using the program's features.
using the program's features.
The canonical place to find \fITux Paint\fP information is at The canonical place to find Tux Paint information is at
.nh .nh
http://www.tuxpaint.org/. http://www.tuxpaint.org/.
.hy .hy
.SH AUTHORS .SH AUTHORS
Lead developer & project manager: Bill Kendrick Lead developer and project manager: Bill Kendrick.nh
.nh
<bill@newbreedsoftware.com>. <bill@newbreedsoftware.com>.
.hy .hy
With patches, fixes, extensions, porting, translations, documentation, and more from With patches, fixes, extensions, porting, translations, documentation, and
lots of people, including, but probably not limited to (see AUTHORS.txt and CHANGES.txt): more from lots of people, including, but probably not limited to (see
AUTHORS.txt and CHANGES.txt):
Aki, Aki,
Ashish Arora, Ashish Arora,
@ -1478,7 +1504,7 @@ Martin Zhekov,
and and
Huang Zuzhen. Huang Zuzhen.
.SH "SEE ALSO" .SH SEE ALSO
.BR tuxpaint-import (1), .BR tuxpaint-import (1),
.BR tuxpaint-config (1), .BR tuxpaint-config (1),
.BR tp-magic-config (1), .BR tp-magic-config (1),
@ -1489,4 +1515,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/.