Ensure command-line options covered more places
Ensured Tux Paint's built-in help ("tuxpaint --help"),
Unix manual ("man page"), and command-line option
tab-completion list all cover the full set of Tux Paint
options. Some were missing in a few places.
This commit is contained in:
parent
cf99582672
commit
9c2fa458b8
4 changed files with 111 additions and 6 deletions
|
|
@ -9,7 +9,12 @@ http://www.tuxpaint.org/
|
|||
$Id$
|
||||
|
||||
2021.August.7 (0.9.27)
|
||||
* ...
|
||||
* Documentation updates
|
||||
---------------------
|
||||
* Ensured Tux Paint's built-in help ("tuxpaint --help"),
|
||||
Unix manual ("man page"), and command-line option
|
||||
tab-completion list all cover the full set of Tux Paint
|
||||
options.
|
||||
|
||||
2021.June.28 (0.9.26)
|
||||
* New Features
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
.\" tuxpaint.1 - 2021.08.07
|
||||
.TH TUXPAINT 1 "7 August 2021" "0.9.27" "Tux Paint"
|
||||
.\" tuxpaint.1 - 2021.08.08
|
||||
.TH TUXPAINT 1 "8 August 2021" "0.9.27" "Tux Paint"
|
||||
.SH NAME
|
||||
tuxpaint -- "Tux Paint", a drawing program for young children.
|
||||
|
||||
|
|
@ -39,6 +39,10 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
|
|||
.br
|
||||
[\-\-papersize \fIPAPERSIZE\fP | \-\-papersize help]
|
||||
.br
|
||||
[\-\-printcommand \fICOMMAND\fP]
|
||||
.br
|
||||
[\-\-altprintcommand \fICOMMAND\fP]
|
||||
.br
|
||||
[\-\-simpleshapes]
|
||||
.br
|
||||
[\-\-uppercase]
|
||||
|
|
@ -77,6 +81,10 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
|
|||
.br
|
||||
[\-\-onscreen-keyboard]
|
||||
.br
|
||||
[\-\-onscreen-keyboard-layout \fILAYOUT\fP]
|
||||
.br
|
||||
[\-\-onscreen-keyboard-disable-change]
|
||||
.br
|
||||
[\-\-joystick-dev=\fIDEVICE\fP]
|
||||
.br
|
||||
[\-\-joystick-dev=list]
|
||||
|
|
@ -358,6 +366,18 @@ will never appear, even if \fI[ALT]\fP is being held.
|
|||
Ask \fITux Paint\fP to generate PostScript of a particular paper size.
|
||||
Valid sizes are those supported by libpaper. See papersize(5).
|
||||
|
||||
.TP 8
|
||||
.B \-\-printcommand \fICOMMAND\fP
|
||||
(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).
|
||||
|
||||
.TP 8
|
||||
.B \-\-altprintcommand \fICOMMAND\fP
|
||||
(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
|
||||
(e.g., when holding \fI[ALT]\fP while clicking "Print"; see above),
|
||||
rather than kprinter.
|
||||
|
||||
.TP 8
|
||||
.B \-\-simpleshapes \-\-complexshapes
|
||||
Disable or enable (default) the \fIrotation\fP step when using the
|
||||
|
|
@ -373,7 +393,7 @@ yet comfortable with the lowercase characterset. Default mode is
|
|||
\fImixed case\fP.
|
||||
|
||||
.TP 8
|
||||
.B \-\-grab \-\-nograb
|
||||
.B \-\-grab \-\-dontgrab
|
||||
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.
|
||||
|
||||
|
|
@ -474,6 +494,80 @@ you click, move, and click again to end the motion.
|
|||
Presents a clickable on-screen keyboard when using the \fIText\fP and
|
||||
\fILabel\fP tools.
|
||||
|
||||
.TP 8
|
||||
.B \-\-onscreen-keyboard-layout \fILAYOUT\fP
|
||||
Specify the default layout for the on-screen keyboard (see above).
|
||||
|
||||
.TP 8
|
||||
-B \-\-onscreen-keyboard-disable-change
|
||||
Disallow switching between on-screen keyboard layouts.
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-dev=\fIDEVICE\fP
|
||||
Specify which joystick device should be used by Tux Paint. Default value is 0 (the first joystick).
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-dev=list
|
||||
List available joysticks and exit.
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-slowness=\fISPEED\fP
|
||||
Sets a delay at each axis motion, allowing to slow the joystick. Allowed values are from 0 to 500. Default value is 15.
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-threshold=\fITHRESHOLD\fP
|
||||
Sets the minimum level of axis motion to start moving the pointer. Allowed values are from 0 to 32766. Default value is 3200.
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-maxsteps=\fISTEPS\fP
|
||||
Sets the maximum pixels the pointer will move at once. Allowed values are from 1 to 7. Default value is 7.
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-hat-timeout=\fIMILLISECONDS\fP
|
||||
Sets the delay after wich the pointer will start moving automatically if the hat is keeped pushed. Allowed values are from 0 to 3000. Default value is 1000.
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-hat-slowness=\fISPEED\fP
|
||||
Sets a delay at each automatic motion, allowing to slow the speed of the hat. Allowed values are from 0 to 500. Default value is 15.
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-btn-escape=\fIBUTTON\fP
|
||||
Selects the joystick button number, as seen by SDL, that will be used to generate a escape event. Useful to dismiss dialogs and quit.
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-btn-\fICOMMAND\fP=\fIBUTTON\fP
|
||||
Selects the joystick button number, as seen by SDL, that will be a shortcut to
|
||||
various tools within Tux Paint.
|
||||
|
||||
.PP
|
||||
.RS
|
||||
.PD 0
|
||||
.TP 2
|
||||
-
|
||||
brush | Brush
|
||||
lines | Lines
|
||||
shapes | Shapes
|
||||
text | Text
|
||||
label | Label
|
||||
magic | Magic
|
||||
undo | Undo
|
||||
redo | Redo
|
||||
eraser | Eraser
|
||||
new | New
|
||||
open | Open
|
||||
save | Save
|
||||
pgsetup | Print (dialog)
|
||||
print | Print (immediate)
|
||||
.RE
|
||||
.PD
|
||||
|
||||
.TP 8
|
||||
\-\-joystick-buttons-ignore=\fIBUTTON1,BUTTON2,...\fP
|
||||
A set of joystick button numbers, as seen by SDL, that should
|
||||
be ignored. Otherwise, unless they are used by one of the
|
||||
\-\-joystick-btn-... options above, buttons will be seen as a mouse
|
||||
left-click. Comma-separated.
|
||||
|
||||
.TP 8
|
||||
.B \-\-stampsize=\fIsize\fP \-\-stampsize=default
|
||||
Sets the default size of all stamps, relative to their possible sizes
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
# Bill Kendrick <bill@newbreedsoftware.com>; http://www.tuxpaint.org/
|
||||
# Based on inkscape's completion file, by allali@univ-mlv.fr
|
||||
#
|
||||
# Last modified 2021-02-05
|
||||
# Last modified 2021-08-07
|
||||
#
|
||||
# $Id$
|
||||
|
||||
|
|
@ -34,10 +34,12 @@ _tuxpaint()
|
|||
-b --startblank --startlast \
|
||||
--sound -q --nosound \
|
||||
--stereo --nostereo \
|
||||
--alllocalefonts --currentlocalefont \
|
||||
-x --noquit --quit
|
||||
-p --print --noprint \
|
||||
--complexshapes -s --simpleshapes \
|
||||
-m --mixedcase -u --uppercase \
|
||||
--label --nolabel \
|
||||
--fancycursors --nofancycursors \
|
||||
--hidecursor --showcursor \
|
||||
--mouse --keyboard \
|
||||
|
|
@ -66,6 +68,8 @@ _tuxpaint()
|
|||
--savedir --datadir --exportdir \
|
||||
--printdelay= \
|
||||
--altprintmod --altprintalways --altprintnever \
|
||||
--printcommand --altprintcommand \
|
||||
--printcfg --noprintcfg \
|
||||
--papersize \
|
||||
-l --lang -L --locale \
|
||||
--nosysconfig \
|
||||
|
|
|
|||
|
|
@ -22,7 +22,7 @@
|
|||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
(See COPYING.txt)
|
||||
|
||||
June 14, 2002 - April 19, 2021
|
||||
June 14, 2002 - August 8, 2021
|
||||
*/
|
||||
|
||||
#include "platform.h"
|
||||
|
|
@ -6738,6 +6738,8 @@ void show_usage(int exitcode)
|
|||
" [--disablescreensaver | --allowscreensaver ]\n"
|
||||
" [--sound | --nosound]\n"
|
||||
" [--stereo | --nostereo]\n"
|
||||
" [--buttonsize=N] (24-192; default=48)\n"
|
||||
" [--colorsrows=N] (1-3; default=1)\n"
|
||||
" [--colorfile FILE]\n"
|
||||
"\n"
|
||||
" Mouse/Keyboard:\n"
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue