Documentation is now maintained in a separate source repository, 'tuxpaint-docs', which allows for easier and more consisten translation of the documentation. Pulling in initial version of these docs, which contain a variety of minor updates (and also a few which had previously only been available as plain TXT are now available as HTML). Pulling in the English stuff.
55 lines
2.6 KiB
Text
55 lines
2.6 KiB
Text
Tux Paint
|
|
version 0.9.26
|
|
Signals Documentation
|
|
|
|
Copyright © 2019-2021 by various contributors; see AUTHORS.
|
|
http://www.tuxpaint.org/
|
|
|
|
30 January 2021
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
Tux Paint responds to the following signals (which can be sent to the
|
|
program's process via `kill` or `killall`, for example).
|
|
|
|
SIGTERM (also, [Ctrl] + [C] from a terminal running `tuxpaint`)
|
|
|
|
Tux Paint responds as if the "Quit" button were pressed, or the
|
|
desktop environment was told to close Tux Paint (e.g., by clicking
|
|
a window close button, or pressing [Alt] + [F4] on most systems).
|
|
|
|
From the main interface, Tux Paint will prompt whether or not you
|
|
wish to quit, and (unless overridden by the auto-save option, e.g.
|
|
"--autosave") if you'd like to save the current drawing (if
|
|
unsaved), and if so, and it's a modified version of an existing
|
|
drawing (unless overridden by the options to save over old images,
|
|
or always save new images; e.g. "--saveover" and "--saveovernew",
|
|
respectively), whether or not to overwrite the existing drawing,
|
|
or save to a new file.
|
|
|
|
Note: From other parts of the interface, the signal is currently
|
|
interpreted as a request to go back (e.g., from the "New" dialog
|
|
back to the main interface), as if a "Back" button in Tux Paint
|
|
were clicked, or the [Esc] was key pressed.
|
|
|
|
Example: killall tuxpaint
|
|
|
|
SIGUSR1 & SIGUSR2
|
|
|
|
Tux Paint responds by setting its auto-save option (as if it had
|
|
been launched with "--autosave"), as well as either the option to
|
|
always save new images (as if launched with "--saveovernew") in
|
|
the case of receiving a SIGUSR1 signal, or to always save over the
|
|
existing image (as if launched with "--saveover") in the case of
|
|
receiving SIGUSR2. Then Tux Paint sends itself a SIGTERM signal,
|
|
in an attempt to quit. (See above.)
|
|
|
|
So, from the main interface, Tux Paint should quit almost
|
|
immediately, with no questions asked.
|
|
|
|
Note: From other parts of the interface, unfortunately, Tux Paint
|
|
will go back one level in the interface. Therefore, at this time,
|
|
it may be necessary to send this signal to Tux Paint a few times,
|
|
for it to quit completely.
|
|
|
|
Example: killall -s SIGUSR1 tuxpaint
|