Sync SIGNALS doc after style updates
This commit is contained in:
parent
799670ac24
commit
084adab616
10 changed files with 689 additions and 351 deletions
|
|
@ -5,71 +5,141 @@
|
|||
Tux Paint Signals Documentation </title>
|
||||
<meta http-equiv="Content-Type"
|
||||
content="text/html; charset=utf-8">
|
||||
<style>
|
||||
body { font-size: large; }
|
||||
table { font-size: large; }
|
||||
div.screenshot-center {
|
||||
text-align: center;
|
||||
}
|
||||
div.screenshot-right {
|
||||
float: right;
|
||||
margin-left: 1em;
|
||||
margin-bottom: 1em;
|
||||
}
|
||||
div.screenshot-right-after {
|
||||
clear: both;
|
||||
}
|
||||
div.keeptogether { page-break-inside: avoid; }
|
||||
section h1 { font-size: 2em; }
|
||||
h1, h2, h3, h4 { font-family: sans; }
|
||||
h1 { color: #800; page-break-before: always; break-before: always; }
|
||||
h2 { color: #440; page-break-after: avoid; break-after: avoid; }
|
||||
h3 { color: #080; page-break-after: avoid; break-after: avoid; }
|
||||
h4 { color: #008; page-break-after: avoid; break-after: avoid; }
|
||||
h1 + p { page-break-inside: avoid; }
|
||||
h2 + p { page-break-inside: avoid; }
|
||||
h3 + p { page-break-inside: avoid; }
|
||||
h4 + p { page-break-inside: avoid; }
|
||||
dt {
|
||||
font-size: large;
|
||||
color: #404;
|
||||
font-family: sans;
|
||||
margin-top: 1em;
|
||||
margin-bottom: 0.25em;
|
||||
}
|
||||
dd, blockquote {
|
||||
border-left: 1px solid #888;
|
||||
padding-left: 1em;
|
||||
border-radius: 0 0 0 1em;
|
||||
}
|
||||
p.note {
|
||||
border: 1px solid #000;
|
||||
background-color: #eee;
|
||||
border-radius: 0.5em;
|
||||
padding: 0.5em;
|
||||
display: inline-block;
|
||||
margin-right: 3em;
|
||||
}
|
||||
section.outer {
|
||||
padding-bottom: 1em;
|
||||
border-bottom: 2px solid #000;
|
||||
}
|
||||
section.indent p,dl {
|
||||
margin-left: 2em;
|
||||
}
|
||||
section.indent dl p {
|
||||
margin-left: 0;
|
||||
}
|
||||
p + ul {
|
||||
margin-left: 2em;
|
||||
}
|
||||
|
||||
@media print {
|
||||
p {
|
||||
orphans: 3;
|
||||
widows: 3;
|
||||
}
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body bgcolor="#FFFFFF"
|
||||
text="#000000"
|
||||
link="#0000FF"
|
||||
vlink="#FF0000"
|
||||
alink="#FF00FF">
|
||||
<center>
|
||||
<h1>
|
||||
<img src="../../html/images/tuxpaint-title.png"
|
||||
width="205"
|
||||
height="210"
|
||||
alt="Tux Paint"><br>
|
||||
versión 0.9.28<br/>
|
||||
Signals Documentation </h1>
|
||||
<section class="outer">
|
||||
<center>
|
||||
<header>
|
||||
<h1>
|
||||
<img src="../../html/images/tuxpaint-title.png"
|
||||
width="205"
|
||||
height="210"
|
||||
alt="Tux Paint"><br>
|
||||
versión 0.9.28<br/>
|
||||
Signals Documentation </h1>
|
||||
|
||||
<p>
|
||||
Copyright © 2019-2022 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
marzo 31, 2022 </p>
|
||||
</header>
|
||||
</center>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<p>
|
||||
Copyright © 2019-2022 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
enero 20, 2022 </p>
|
||||
</center>
|
||||
|
||||
<hr>
|
||||
|
||||
<p>
|
||||
Tux Paint responds to the following signals (which can be sent to the program's process via `<code>kill</code>` or `<code>killall</code>`, for example). </p>
|
||||
|
||||
<dl>
|
||||
<dt>
|
||||
<code>SIGTERM</code>
|
||||
(also, <b><code>[Ctrl]</code></b> + <b><code>[C]</code></b> from a terminal running `<code>tuxpaint</code>`) </dt>
|
||||
|
||||
<dd>
|
||||
<p>
|
||||
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 <b><code>[Alt]</code></b> + <b><code>[F4]</code></b> on most systems). </p>
|
||||
|
||||
<p>
|
||||
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. "<code>--autosave</code>") 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. "<code>--saveover</code>" and "<code>--saveovernew</code>", respectively), whether or not to overwrite the existing drawing, or save to a new file. </p>
|
||||
|
||||
<p>
|
||||
<b>Note:</b> 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 <b><code>[Esc]</code></b> was key pressed. </p>
|
||||
|
||||
<p>
|
||||
Example: <code>killall tuxpaint</code> </p>
|
||||
</dd>
|
||||
|
||||
<dt>
|
||||
<code>SIGUSR1</code> & <code>SIGUSR2</code>
|
||||
</dt>
|
||||
|
||||
<dd>
|
||||
<p>
|
||||
Tux Paint responds by setting its auto-save option (as if it had been launched with "<code>--autosave</code>"), as well as either the option to always save new images (as if launched with "<code>--saveovernew</code>") in the case of receiving a <code>SIGUSR1</code> signal, or to always save over the existing image (as if launched with "<code>--saveover</code>") in the case of receiving <code>SIGUSR2</code>. Then Tux Paint sends itself a <code>SIGTERM</code> signal, in an attempt to quit. (See above.) </p>
|
||||
|
||||
<p>
|
||||
So, from the main interface, Tux Paint should quit almost immediately, with no questions asked. </p>
|
||||
|
||||
<p>
|
||||
<b>Note:</b> 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. </p>
|
||||
|
||||
<p>
|
||||
Example: <code>killall -s SIGUSR1 tuxpaint</code> </p>
|
||||
</dd>
|
||||
</dl>
|
||||
Tux Paint responds to the following signals (which can be sent to the program's process via `<code>kill</code>` or `<code>killall</code>`, for example). </p>
|
||||
|
||||
<dl>
|
||||
<dt>
|
||||
<code>SIGTERM</code>
|
||||
(also, <b><code>[Ctrl]</code></b> + <b><code>[C]</code></b> from a terminal running `<code>tuxpaint</code>`) </dt>
|
||||
|
||||
<dd>
|
||||
<p>
|
||||
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 <b><code>[Alt]</code></b> + <b><code>[F4]</code></b> on most systems). </p>
|
||||
|
||||
<p>
|
||||
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. "<code>--autosave</code>") 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. "<code>--saveover</code>" and "<code>--saveovernew</code>", respectively), whether or not to overwrite the existing drawing, or save to a new file. </p>
|
||||
|
||||
<p>
|
||||
Example: <code>killall tuxpaint</code> </p>
|
||||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 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 <b><code>[Esc]</code></b> was key pressed. </p>
|
||||
</dd>
|
||||
|
||||
<dt>
|
||||
<code>SIGUSR1</code> & <code>SIGUSR2</code>
|
||||
</dt>
|
||||
|
||||
<dd>
|
||||
<p>
|
||||
Tux Paint responds by setting its auto-save option (as if it had been launched with "<code>--autosave</code>"), as well as either the option to always save new images (as if launched with "<code>--saveovernew</code>") in the case of receiving a <code>SIGUSR1</code> signal, or to always save over the existing image (as if launched with "<code>--saveover</code>") in the case of receiving <code>SIGUSR2</code>. Then Tux Paint sends itself a <code>SIGTERM</code> signal, in an attempt to quit. (See above.) </p>
|
||||
|
||||
<p>
|
||||
So, from the main interface, Tux Paint should quit almost immediately, with no questions asked. </p>
|
||||
|
||||
<p>
|
||||
Example: <code>killall -s SIGUSR1 tuxpaint</code> </p>
|
||||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 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. </p>
|
||||
</dd>
|
||||
</dl>
|
||||
</section>
|
||||
</body>
|
||||
</html>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue