                                   Tux Paint
                                version 0.9.35
                             Signals Documentation

        Copyright © 2019-2022 by various contributors; see AUTHORS.txt.
                             https://tuxpaint.org/

                                 June 4, 2022

Tux Paint responds to the following signals (which can be sent to the program's
process via `kill` or `killall`, for example).

→ SIGTERM (also, [Control] + [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.

    Example: killall tuxpaint

    💡 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.


     
→ 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.

    Example: killall -s SIGUSR1 tuxpaint

    💡 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.


     

