fyb/calcurse-edge
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Manuals updated with parts related to daemon mode.

Browse Source
This commit is contained in:
Frederic Culot 2009-08-18 13:07:59 +00:00
parent c8c81d6da2
commit 20cd296a80
6 changed files with 481 additions and 171 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

119
doc/manual_de.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- <!--
/* /*
* $calcurse: manual_de.html,v 1.26 2009/07/10 19:49:07 culot Exp $ * $calcurse: manual_de.html,v 1.27 2009/08/18 13:07:59 culot Exp $
* *
* Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org> * Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org>
* All rights reserved. * All rights reserved.
@ -91,13 +91,14 @@ well as the way one can contribute to <code>calcurse</code> development.
<li><a href="#basics_interface_noninteractive">4.2.1 Nicht-interaktiver Modus</a></li> <li><a href="#basics_interface_noninteractive">4.2.1 Nicht-interaktiver Modus</a></li>
<li><a href="#basics_interface_interactive">4.2.2 Interaktiver Modus</a></li> <li><a href="#basics_interface_interactive">4.2.2 Interaktiver Modus</a></li>
</ul></li> </ul></li>
<li><a href="#basics_files">4.3 <code>calcurse</code> Dateien</a></li> <li><a href="#basics_daemon"><span class="todo">4.3 Background mode</span></a></li>
<li><a href="#basics_import_export"><span class="todo">4.4 Import/Export capabilities</span></a> <li><a href="#basics_files">4.4 <code>calcurse</code> Dateien</a></li>
<li><a href="#basics_import_export"><span class="todo">4.5 Import/Export capabilities</span></a>
<ul> <ul>
<li><a href="#basics_import"><span class="todo">4.4.1 Import</span></a></li> <li><a href="#basics_import"><span class="todo">4.5.1 Import</span></a></li>
<li><a href="#basics_export"><span class="todo">4.4.2 Export</span></a></li> <li><a href="#basics_export"><span class="todo">4.5.2 Export</span></a></li>
</ul></li> </ul></li>
<li><a href="#basics_help">4.5 Onlinehilfe</a></li> <li><a href="#basics_help">4.6 Onlinehilfe</a></li>
</ul></li> </ul></li>
<li><a href="#options">5. Optionen</a> <li><a href="#options">5. Optionen</a>
<ul> <ul>
@ -199,6 +200,8 @@ w&auml;hlen.
<span class="todo">Key bindings are also configurable, to fit everyone's needs.</span> <span class="todo">Key bindings are also configurable, to fit everyone's needs.</span>
Ein konfigurierbares Notizsystem erinnert den Benutzer Ein konfigurierbares Notizsystem erinnert den Benutzer
an bevorstehende Termine. an bevorstehende Termine.
<span class="todo">The reminders are sent even if the user's interface
is not running, as calcurse is able to run in background.</span>
</p> </p>
<h1>3. Installation<a name="install"></a></h1> <h1>3. Installation<a name="install"></a></h1>
@ -255,7 +258,7 @@ laden:</p>
<h2>3.2 Installationsprozess<a name="install_process"></a></h2> <h2>3.2 Installationsprozess<a name="install_process"></a></h2>
<p> <p>
Als erstes m&uuml;ssen die Dateien entpackt werden:</p> Als erstes m&uuml;ssen die Dateien entpackt werden:</p>
<pre>tar zxvf calcurse-2.6.tar.gz</pre> <pre>tar zxvf calcurse-2.7.tar.gz</pre>
<p> <p>
Ist diese Voraussetzung erf&uuml;llt und das Archiv entpackt, Ist diese Voraussetzung erf&uuml;llt und das Archiv entpackt,
sind nur noch die drei &uuml;blichen Schritte erforderlich:</p> sind nur noch die drei &uuml;blichen Schritte erforderlich:</p>
@ -367,6 +370,15 @@ Es werden sowohl kurze als auch lange Optionsangaben unterst&uuml;tzt.</p>
regular expression. regular expression.
</div> </div>
</dd> </dd>
<dt><code>--status</code></dt>
<dd>
<div class="todo">
Display the status of running instances of calcurse. If
calcurse is running, this will tell if the interactive
mode was launched or if calcurse is running in background.
The process pid will also be indicated.
</div>
</dd>
<dt><code>-t[num], --todo[=num]</code></dt> <dt><code>-t[num], --todo[=num]</code></dt>
<dd>Gibt die 'todo' Liste aus. <dd>Gibt die 'todo' Liste aus.
Wird die optionale Angabe <code>num</code> &uuml;bergeben, werden nur diejenigen Wird die optionale Angabe <code>num</code> &uuml;bergeben, werden nur diejenigen
@ -578,7 +590,38 @@ Hierbei steht '^' f&uuml;r die Taste 'Strg' beziehungsweise 'Ctrl':
</dl> </dl>
</p> </p>
<h2>4.3 <code>calcurse</code> Dateien<a name="basics_files"></a></h2> <div class="todo">
<h2>4.3 Background mode<a name="basics_daemon"></a></h2>
<p>When the daemon mode is enabled in the notification configuration menu
(see <a href="#options_notify">Notify-bar settings</a>), <code>calcurse</code> will stay
in background when the user interface is not running. In background mode,
<code>calcurse</code> checks for upcoming appointments and runs the user-defined
notification command when necessary. When the user interface is started again,
the daemon automatically stops.</p>
<p><code>calcurse</code> background activity can be logged (set the
<code>notify-daemon_log</code> variable in the notification configuration
<a href="#options_notify">menu</a>), and in that case, information about the daemon
start and stop time, reminders' command launch time, signals received... will be written
in the <code>daemon.log</code> file (see section <a href="#basics_files">files</a>).</p>
<p>
Using the <code>--status</code> command line option (see section
<a href="#basics_invocation_commandline">Command line arguments</a>),
one can know if <code>calcurse</code> is currently running in background or not.
If the daemon is running, a message like the following one will be displayed (the pid of
the daemon process will be shown):
<pre>calcurse is running in background (pid 14536)</pre>
<p class="rq"><span class="valorise">Note:</span>
To stop the daemon, just send the <code>TERM</code> signal to it, using a command such as:
<code>'kill daemon_pid'</code>, where <span class="emp">daemon_pid</span> is the process id
of the daemon (14536 in the above example).
</p>
</div>
<h2>4.4 <code>calcurse</code> Dateien<a name="basics_files"></a></h2>
<p> <p>
Die folgende Verzeichnisstruktur wird im $HOME-Verzeichnis angelegt, Die folgende Verzeichnisstruktur wird im $HOME-Verzeichnis angelegt,
<div class="todo">(or in the directory you specified with the -D option)</div> <div class="todo">(or in the directory you specified with the -D option)</div>
@ -607,15 +650,24 @@ $HOME/.calcurse/
<dd>Datei enth&auml;lt die todo-Liste.</dd> <dd>Datei enth&auml;lt die todo-Liste.</dd>
</dl> </dl>
<div class="todo">
<p class="rq"><span class="valorise">Note:</span>
If the logging of calcurse daemon activity was set in the notification
configuration menu, the extra file <code>daemon.log</code> will appear
in calcurse data directory. This file contains logs about calcurse activity
when running in background.
</p>
</div>
<div class="todo"> <div class="todo">
<h2>4.4 Import/Export capabilities<a name="basics_import_export"></a></h2> <h2>4.5 Import/Export capabilities<a name="basics_import_export"></a></h2>
<p> <p>
The import and export capabilities offered by <code>calcurse</code> The import and export capabilities offered by <code>calcurse</code>
are described below. are described below.
</p> </p>
<h3>4.4.1 Import<a name="basics_import"></a></h3> <h3>4.5.1 Import<a name="basics_import"></a></h3>
<p> <p>
Data in icalendar format as described in the rfc2445 specification Data in icalendar format as described in the rfc2445 specification
(see <a href="#links_others">links</a> section below) can be imported (see <a href="#links_others">links</a> section below) can be imported
@ -654,7 +706,7 @@ $HOME/.calcurse/
</ul> </ul>
</p> </p>
<h3>4.4.2 Export<a name="basics_export"></a></h3> <h3>4.5.2 Export<a name="basics_export"></a></h3>
<p> <p>
Two possible export formats are available: <code>ical</code> and Two possible export formats are available: <code>ical</code> and
<code>pcal</code> (see section <a href="#links_others">Links</a> below <code>pcal</code> (see section <a href="#links_others">Links</a> below
@ -662,7 +714,7 @@ $HOME/.calcurse/
</p> </p>
</div> </div>
<h2>4.5 Online Hilfe<a name="basics_help"></a></h2> <h2>4.6 Online Hilfe<a name="basics_help"></a></h2>
<p> <p>
Das integrierte Hilfe-System kann jederzeit mit '?' aufgerufen Das integrierte Hilfe-System kann jederzeit mit '?' aufgerufen
werden. Informationen &uuml;ber bestimmte Befehle k&ouml;nnen mit der werden. Informationen &uuml;ber bestimmte Befehle k&ouml;nnen mit der
@ -700,16 +752,14 @@ allgemeines Verhalten.</p>
bet&auml;tigen.</p> bet&auml;tigen.</p>
</dd> </dd>
<div class="todo"> <dt><code><span class="todo">periodic_save</code>
<dt><code>periodic_save</code> (default: <span class="emp">0</span>)</span></dt>
(default: <span class="emp">0</span>)</dt> <dd><span class="todo">If different from '0', user's data will be automatically
<dd>If different from '0', user's data will be automatically
saved every <span class="emp">periodic_save</span> minutes. saved every <span class="emp">periodic_save</span> minutes.
When an automatic save is performed, two asterisks When an automatic save is performed, two asterisks
(i.e. '<code>**</code>') will appear on the top right-hand side (i.e. '<code>**</code>') will appear on the top right-hand side
of the screen).</p> of the screen).</span>
</dd> </dd>
</div>
<dt><code>Beenden_best&auml;tigen</code> <dt><code>Beenden_best&auml;tigen</code>
(Voreinstellung: <span class="emp">ja</span>)</dt> (Voreinstellung: <span class="emp">ja</span>)</dt>
@ -740,19 +790,18 @@ allgemeines Verhalten.</p>
als erster Tag der Woche festgelegt. Ist <span class="emp">nein</span> gew&auml;hlt, als erster Tag der Woche festgelegt. Ist <span class="emp">nein</span> gew&auml;hlt,
beginnt die Woche sonntags.</dd> beginnt die Woche sonntags.</dd>
<div class="todo"> <dt><code><span class="todo">output_datefmt</code>
<dt><code>output_datefmt</code> (default: <span class="emp">%D</span>)</span></dt>
(default: <span class="emp">%D</span>)</dt> <dd><span class="todo">This option indicates the format to be used when displaying dates
<dd>This option indicates the format to be used when displaying dates
in non-interactive mode. Using the default values, dates are displayed the in non-interactive mode. Using the default values, dates are displayed the
following way: <span class="emp">mm/dd/aa</span>. following way: <span class="emp">mm/dd/aa</span>.
You can see all of the possible formats by typing <code>man 3 strftime</code> You can see all of the possible formats by typing <code>man 3 strftime</code>
inside a terminal.</dd> inside a terminal.</span></dd>
<dt><code>input_datefmt</code> <dt><code><span class="todo">input_datefmt</code>
(default: <span class="emp">1</span>)</dt> (default: <span class="emp">1</span>)</span></dt>
<dd>This option indicates the format that will be used to enter dates in <dd><span class="todo">This option indicates the format that will be used to enter dates in
<span class="emp">calcurse</span>. Four choices are available: <span class="emp">calcurse</span>. Four choices are available:</span>
<ol> <ol>
<li>mm/dd/yyyy</li> <li>mm/dd/yyyy</li>
<li>dd/mm/yyyy</li> <li>dd/mm/yyyy</li>
@ -760,7 +809,6 @@ allgemeines Verhalten.</p>
<li>yyyy-mm-dd</li> <li>yyyy-mm-dd</li>
</ol> </ol>
</dd> </dd>
</div>
</dl> </dl>
<div class="todo"> <div class="todo">
@ -878,6 +926,19 @@ entsprechend anpassen.</p>
calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com
</code> </code>
</dd> </dd>
<dt><code><span class="todo">notify-daemon_enable</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, daemon mode will be enabled, meaning <code>calcurse</code>
will run into background when the user's interface is exited. This will allow the
notifications to be launched even when the interface is not running. More details
can be found in section <a href="#basics_daemon">'Background mode'</a>.</span>
</dd>
<dt><code><span class="todo">notify-daemon_log</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, <code>calcurse</code> daemon activity will be logged (see section
<a href="#basics_files">files</a></span>).
</dd>
</dl> </dl>
<h1>6. Bekannte Fehler<a name="known_bugs"></a></h1> <h1>6. Bekannte Fehler<a name="known_bugs"></a></h1>
@ -1187,7 +1248,7 @@ Benutzer, die mir Ihr Feedback mitgeteilt haben.</p>
Copyright &copy; 2004-2009 Frédéric Culot<br> Copyright &copy; 2004-2009 Frédéric Culot<br>
German translation by Michael Schulz German translation by Michael Schulz
<code>&lt;bloodshower .at. web .dot. de&gt;</code>, and Chris.<br> <code>&lt;bloodshower .at. web .dot. de&gt;</code>, and Chris.<br>
Calcurse version 2.6 - Last change: July 10, 2009<br> Calcurse version 2.7 - Last change: August 18, 2009<br>
</div> </div>
</div> </div>

5
doc/manual_en.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- <!--
/* /*
* $calcurse: manual_en.html,v 1.27 2009/08/18 09:55:03 culot Exp $ * $calcurse: manual_en.html,v 1.28 2009/08/18 13:08:00 culot Exp $
* *
* Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org> * Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org>
* All rights reserved. * All rights reserved.
@ -613,9 +613,6 @@ of the daemon (14536 in the above example).
</p> </p>
</p>
<h2>4.4 <code>calcurse</code> files<a name="basics_files"></a></h2> <h2>4.4 <code>calcurse</code> files<a name="basics_files"></a></h2>
<p> <p>
The following structure is created in your <code>$HOME</code> The following structure is created in your <code>$HOME</code>

151
doc/manual_es.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- <!--
/* /*
* $calcurse: manual_es.html,v 1.23 2009/07/10 19:49:07 culot Exp $ * $calcurse: manual_es.html,v 1.24 2009/08/18 13:08:00 culot Exp $
* *
* Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org> * Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org>
* All rights reserved. * All rights reserved.
@ -92,13 +92,14 @@ well as the way one can contribute to <code>calcurse</code> development.
<li><a href="#basics_interface_noninteractive">4.2.1 Modo no-interactivo</a></li> <li><a href="#basics_interface_noninteractive">4.2.1 Modo no-interactivo</a></li>
<li><a href="#basics_interface_interactive">4.2.2 Modo interactivo</a></li> <li><a href="#basics_interface_interactive">4.2.2 Modo interactivo</a></li>
</ul></li> </ul></li>
<li><a href="#basics_files">4.3 Archivos de <code>calcurse</code></a></li> <li><a href="#basics_daemon"><span class="todo">4.3 Background mode</span></a></li>
<li><a href="#basics_import_export"><span class="todo">4.4 Import/Export capabilities</span></a> <li><a href="#basics_files">4.4 Archivos de <code>calcurse</code></a></li>
<li><a href="#basics_import_export"><span class="todo">4.5 Import/Export capabilities</span></a>
<ul> <ul>
<li><a href="#basics_import"><span class="todo">4.4.1 Import</span></a></li> <li><a href="#basics_import"><span class="todo">4.5.1 Import</span></a></li>
<li><a href="#basics_export"><span class="todo">4.4.2 Export</span></a></li> <li><a href="#basics_export"><span class="todo">4.5.2 Export</span></a></li>
</ul></li> </ul></li>
<li><a href="#basics_help">4.5 Ayuda en linea</a></li> <li><a href="#basics_help">4.6 Ayuda en linea</a></li>
</ul></li> </ul></li>
<li><a href="#options">5. Opciones</a> <li><a href="#options">5. Opciones</a>
<ul> <ul>
@ -195,6 +196,8 @@ well as the way one can contribute to <code>calcurse</code> development.
elegir entre combinaciones de colores y disposiciones. elegir entre combinaciones de colores y disposiciones.
<span class="todo">Key bindings are also configurable, to fit everyone's needs.</span> <span class="todo">Key bindings are also configurable, to fit everyone's needs.</span>
Finalmente, un sistema de notificacion recuerda al usuario sus proximas citas. Finalmente, un sistema de notificacion recuerda al usuario sus proximas citas.
<span class="todo">The reminders are sent even if the user's interface
is not running, as calcurse is able to run in background.</span>
</p> </p>
<h1>3. Instalación<a name="install"></a></h1> <h1>3. Instalación<a name="install"></a></h1>
@ -253,7 +256,7 @@ well as the way one can contribute to <code>calcurse</code> development.
<h2>3.2 Proceso de instalación<a name="install_process"></a></h2> <h2>3.2 Proceso de instalación<a name="install_process"></a></h2>
<p> <p>
Primero necesitas descomprimir ( gunzip y untar) el archivo fuente:</p> Primero necesitas descomprimir ( gunzip y untar) el archivo fuente:</p>
<pre>tar zxvf calcurse-2.6.tar.gz</pre> <pre>tar zxvf calcurse-2.7.tar.gz</pre>
<p> <p>
Una vez has resuelto los requisitos y has extraído el archivo, Una vez has resuelto los requisitos y has extraído el archivo,
el proceso de instalación es muy simple y sigue los tres pasos habituales: el proceso de instalación es muy simple y sigue los tres pasos habituales:
@ -296,7 +299,7 @@ well as the way one can contribute to <code>calcurse</code> development.
próximos, dependiendo del formato del argumento. próximos, dependiendo del formato del argumento.
Soporta dos posible formatos : Soporta dos posible formatos :
<ul> <ul>
<li>una fecha <span class="todo">(possible formats described below).</li> <li>una fecha <span class="todo">(possible formats described below).</span></li>
<li>un numero 'n'.</li> <li>un numero 'n'.</li>
</ul> </ul>
En el primer caso, devolverá la lista de citas y eventos para la fecha especificada En el primer caso, devolverá la lista de citas y eventos para la fecha especificada
@ -371,6 +374,15 @@ well as the way one can contribute to <code>calcurse</code> development.
regular expression. regular expression.
</div> </div>
</dd> </dd>
<dt><code>--status</code></dt>
<dd>
<div class="todo">
Display the status of running instances of calcurse. If
calcurse is running, this will tell if the interactive
mode was launched or if calcurse is running in background.
The process pid will also be indicated.
</div>
</dd>
<dt><code>-t[num], --todo[=num]</code></dt> <dt><code>-t[num], --todo[=num]</code></dt>
<dd> <dd>
Imprime la lista de tareas pendientes ('ToDo') y sale. Imprime la lista de tareas pendientes ('ToDo') y sale.
@ -588,7 +600,38 @@ well as the way one can contribute to <code>calcurse</code> development.
</dl> </dl>
</p> </p>
<h2>4.3 Archivos de <code>calcurse</code><a name="basics_files"></a></h2> <div class="todo">
<h2>4.3 Background mode<a name="basics_daemon"></a></h2>
<p>When the daemon mode is enabled in the notification configuration menu
(see <a href="#options_notify">Notify-bar settings</a>), <code>calcurse</code> will stay
in background when the user interface is not running. In background mode,
<code>calcurse</code> checks for upcoming appointments and runs the user-defined
notification command when necessary. When the user interface is started again,
the daemon automatically stops.</p>
<p><code>calcurse</code> background activity can be logged (set the
<code>notify-daemon_log</code> variable in the notification configuration
<a href="#options_notify">menu</a>), and in that case, information about the daemon
start and stop time, reminders' command launch time, signals received... will be written
in the <code>daemon.log</code> file (see section <a href="#basics_files">files</a>).</p>
<p>
Using the <code>--status</code> command line option (see section
<a href="#basics_invocation_commandline">Command line arguments</a>),
one can know if <code>calcurse</code> is currently running in background or not.
If the daemon is running, a message like the following one will be displayed (the pid of
the daemon process will be shown):
<pre>calcurse is running in background (pid 14536)</pre>
<p class="rq"><span class="valorise">Note:</span>
To stop the daemon, just send the <code>TERM</code> signal to it, using a command such as:
<code>'kill daemon_pid'</code>, where <span class="emp">daemon_pid</span> is the process id
of the daemon (14536 in the above example).
</p>
</div>
<h2>4.4 Archivos de <code>calcurse</code><a name="basics_files"></a></h2>
<p> <p>
La siguiente estructura se crea en tu directorio <code>$HOME</code> La siguiente estructura se crea en tu directorio <code>$HOME</code>
<div class="todo">(or in the directory you specified with the -D option)</div> <div class="todo">(or in the directory you specified with the -D option)</div>
@ -618,13 +661,22 @@ $HOME/.calcurse/
</dl> </dl>
<div class="todo"> <div class="todo">
<h2>4.4 Import/Export capabilities<a name="basics_import_export"></a></h2> <p class="rq"><span class="valorise">Note:</span>
If the logging of calcurse daemon activity was set in the notification
configuration menu, the extra file <code>daemon.log</code> will appear
in calcurse data directory. This file contains logs about calcurse activity
when running in background.
</p>
</div>
<div class="todo">
<h2>4.5 Import/Export capabilities<a name="basics_import_export"></a></h2>
<p> <p>
The import and export capabilities offered by <code>calcurse</code> The import and export capabilities offered by <code>calcurse</code>
are described below. are described below.
</p> </p>
<h3>4.4.1 Import<a name="basics_import"></a></h3> <h3>4.5.1 Import<a name="basics_import"></a></h3>
<p> <p>
Data in icalendar format as described in the rfc2445 specification Data in icalendar format as described in the rfc2445 specification
(see <a href="#links_others">links</a> section below) can be imported (see <a href="#links_others">links</a> section below) can be imported
@ -663,7 +715,7 @@ $HOME/.calcurse/
</ul> </ul>
</p> </p>
<h3>4.4.2 Export<a name="basics_export"></a></h3> <h3>4.5.2 Export<a name="basics_export"></a></h3>
<p> <p>
Two possible export formats are available: <code>ical</code> and Two possible export formats are available: <code>ical</code> and
<code>pcal</code> (see section <a href="#links_others">Links</a> below <code>pcal</code> (see section <a href="#links_others">Links</a> below
@ -671,7 +723,7 @@ $HOME/.calcurse/
</p> </p>
</div> </div>
<h2>4.5 Ayuda en linea<a name="basics_help"></a></h2> <h2>4.6 Ayuda en linea<a name="basics_help"></a></h2>
<p> <p>
En cualquier momento, puedes consultar el sistema de ayuda integrado En cualquier momento, puedes consultar el sistema de ayuda integrado
presionando la tecla '?'. Una vez en la pantalla de ayuda, presionando la tecla '?'. Una vez en la pantalla de ayuda,
@ -711,16 +763,14 @@ $HOME/.calcurse/
sus modificaciones antes de salir.</p> sus modificaciones antes de salir.</p>
</dd> </dd>
<div class="todo"> <dt><code><span class="todo">periodic_save</code>
<dt><code>periodic_save</code> (default: <span class="emp">0</span>)</span></dt>
(default: <span class="emp">0</span>)</dt> <dd><span class="todo">If different from '0', user's data will be automatically
<dd>If different from '0', user's data will be automatically saved every <span class="emp">periodic_save</span> minutes.
saved every <span class="emp">periodic_save</span> minutes. When an automatic save is performed, two asterisks
When an automatic save is performed, two asterisks (i.e. '<code>**</code>') will appear on the top right-hand side
(i.e. '<code>**</code>') will appear on the top right-hand side of the screen).</span>
of the screen).</p> </dd>
</dd>
</div>
<dt><code>confirmar_salir</code> <dt><code>confirmar_salir</code>
(por defecto: <span class="emp">si</span>)</dt> (por defecto: <span class="emp">si</span>)</dt>
@ -760,26 +810,25 @@ $HOME/.calcurse/
será el primer día de la semana. será el primer día de la semana.
</dd> </dd>
<div class="todo"> <dt><code><span class="todo">output_datefmt</code>
<dt><code>output_datefmt</code> (default: <span class="emp">%D</span>)</span></dt>
(default: <span class="emp">%D</span>)</dt> <dd><span class="todo">This option indicates the format to be used when displaying dates
<dd>This option indicates the format to be used when displaying dates in non-interactive mode. Using the default values, dates are displayed the
in non-interactive mode. Using the default values, dates are displayed the following way: <span class="emp">mm/dd/aa</span>.
following way: <span class="emp">mm/dd/aa</span>. You can see all of the possible formats by typing <code>man 3 strftime</code>
You can see all of the possible formats by typing <code>man 3 strftime</code> inside a terminal.</span></dd>
inside a terminal.</dd>
<dt><code>input_datefmt</code> <dt><code><span class="todo">input_datefmt</code>
(default: <span class="emp">1</span>)</dt> (default: <span class="emp">1</span>)</span></dt>
<dd>This option indicates the format that will be used to enter dates in <dd><span class="todo">This option indicates the format that will be used to enter dates in
<span class="emp">calcurse</span>. Four choices are available: <span class="emp">calcurse</span>. Four choices are available:</span>
<ol> <ol>
<li>mm/dd/yyyy</li> <li>mm/dd/yyyy</li>
<li>dd/mm/yyyy</li> <li>dd/mm/yyyy</li>
<li>yyyy/mm/dd</li> <li>yyyy/mm/dd</li>
<li>yyyy-mm-dd</li> <li>yyyy-mm-dd</li>
</ol> </ol>
</dd> </dd>
</div>
</dl> </dl>
@ -901,6 +950,20 @@ $HOME/.calcurse/
calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com
</code> </code>
</dd> </dd>
<dt><code><span class="todo">notify-daemon_enable</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, daemon mode will be enabled, meaning <code>calcurse</code>
will run into background when the user's interface is exited. This will allow the
notifications to be launched even when the interface is not running. More details
can be found in section <a href="#basics_daemon">'Background mode'</a>.</span>
</dd>
<dt><code><span class="todo">notify-daemon_log</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, <code>calcurse</code> daemon activity will be logged (see section
<a href="#basics_files">files</a></span>).
</dd>
</dl> </dl>
<h1>6. Bugs conocidos<a name="known_bugs"></a></h1> <h1>6. Bugs conocidos<a name="known_bugs"></a></h1>
@ -1204,7 +1267,7 @@ msgid ""
Copyright &copy; 2004-2009 Frédéric Culot<br> Copyright &copy; 2004-2009 Frédéric Culot<br>
Traducido al Español por José López Traducido al Español por José López
<code>&lt;testinground .at. gmail .dot. com&gt;</code><br> <code>&lt;testinground .at. gmail .dot. com&gt;</code><br>
Calcurse version 2.6 - Last change: July 10, 2009<br> Calcurse version 2.7 - Last change: August 18, 2009<br>
</div> </div>
</div> </div>

112
doc/manual_fr.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- <!--
/* /*
* $calcurse: manual_fr.html,v 1.27 2009/07/10 19:49:08 culot Exp $ * $calcurse: manual_fr.html,v 1.28 2009/08/18 13:08:00 culot Exp $
* *
* Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org> * Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org>
* All rights reserved. * All rights reserved.
@ -92,13 +92,14 @@ pour faire remonter les bogues et pour contribuer au d
<li><a href="#basics_interface_noninteractive">4.2.1 Mode non-interactif</a></li> <li><a href="#basics_interface_noninteractive">4.2.1 Mode non-interactif</a></li>
<li><a href="#basics_interface_interactive">4.2.2 Mode Interactif</a></li> <li><a href="#basics_interface_interactive">4.2.2 Mode Interactif</a></li>
</ul></li> </ul></li>
<li><a href="#basics_files">4.3 Fichiers</a></li> <li><a href="#basics_daemon"><span class="todo">4.3 Background mode</span></a></li>
<li><a href="#basics_import_export">4.4 Fonctions d'import/export</a> <li><a href="#basics_files">4.4 Fichiers</a></li>
<li><a href="#basics_import_export">4.5 Fonctions d'import/export</a>
<ul> <ul>
<li><a href="#basics_import">4.4.1 Import</a></li> <li><a href="#basics_import">4.5.1 Import</a></li>
<li><a href="#basics_export">4.4.2 Export</a></li> <li><a href="#basics_export">4.5.2 Export</a></li>
</ul></li> </ul></li>
<li><a href="#basics_help">4.5 Aide en ligne</a></li> <li><a href="#basics_help">4.6 Aide en ligne</a></li>
</ul></li> </ul></li>
<li><a href="#options">5. Options</a> <li><a href="#options">5. Options</a>
<ul> <ul>
@ -211,7 +212,9 @@ disponibles.
Enfin, le système de notification est Enfin, le système de notification est
entièrement configurable, l'utilisateur peut donc choisir la entièrement configurable, l'utilisateur peut donc choisir la
manière dont il veut être prévenu de l'approche d'un manière dont il veut être prévenu de l'approche d'un
rendez-vous. rendez-vous. Les notifications peuvent également être envoyées
même si l'interface utilisateur n'est pas lancée, car
<code>calcurse</code> peut tourner en tâche de fond (mode démon).
</p> </p>
<h1>3. Installation<a name="install"></a></h1> <h1>3. Installation<a name="install"></a></h1>
@ -280,7 +283,7 @@ disponibles.
<p> <p>
Vous devez tout d'abord décompresser l'archive source de la Vous devez tout d'abord décompresser l'archive source de la
manière suivante :</p> manière suivante :</p>
<pre>tar zxvf calcurse-2.6.tar.gz</pre> <pre>tar zxvf calcurse-2.7.tar.gz</pre>
<p> <p>
Une fois que vous remplissez tous les pré-requis nécessaires à Une fois que vous remplissez tous les pré-requis nécessaires à
l'installation, le processus de compilation est simple et suit l'installation, le processus de compilation est simple et suit
@ -397,6 +400,15 @@ disponibles.
'-s' ou '-t', seuls les éléments dont la description correspond à '-s' ou '-t', seuls les éléments dont la description correspond à
l'expression régulière passée en argument seront affichés. l'expression régulière passée en argument seront affichés.
</dd> </dd>
<dt><code>--status</code></dt>
<dd>
<div class="todo">
Display the status of running instances of calcurse. If
calcurse is running, this will tell if the interactive
mode was launched or if calcurse is running in background.
The process pid will also be indicated.
</div>
</dd>
<dt><code>-t[num], --todo[=num]</code></dt> <dt><code>-t[num], --todo[=num]</code></dt>
<dd> <dd>
Affiche la liste des 'todo', puis quitte. Si le nombre optionnel Affiche la liste des 'todo', puis quitte. Si le nombre optionnel
@ -628,7 +640,38 @@ disponibles.
</dl> </dl>
</p> </p>
<h2>4.3 Fichiers<a name="basics_files"></a></h2> <div class="todo">
<h2>4.3 Background mode<a name="basics_daemon"></a></h2>
<p>When the daemon mode is enabled in the notification configuration menu
(see <a href="#options_notify">Notify-bar settings</a>), <code>calcurse</code> will stay
in background when the user interface is not running. In background mode,
<code>calcurse</code> checks for upcoming appointments and runs the user-defined
notification command when necessary. When the user interface is started again,
the daemon automatically stops.</p>
<p><code>calcurse</code> background activity can be logged (set the
<code>notify-daemon_log</code> variable in the notification configuration
<a href="#options_notify">menu</a>), and in that case, information about the daemon
start and stop time, reminders' command launch time, signals received... will be written
in the <code>daemon.log</code> file (see section <a href="#basics_files">files</a>).</p>
<p>
Using the <code>--status</code> command line option (see section
<a href="#basics_invocation_commandline">Command line arguments</a>),
one can know if <code>calcurse</code> is currently running in background or not.
If the daemon is running, a message like the following one will be displayed (the pid of
the daemon process will be shown):
<pre>calcurse is running in background (pid 14536)</pre>
<p class="rq"><span class="valorise">Note:</span>
To stop the daemon, just send the <code>TERM</code> signal to it, using a command such as:
<code>'kill daemon_pid'</code>, where <span class="emp">daemon_pid</span> is the process id
of the daemon (14536 in the above example).
</p>
</div>
<h2>4.4 Fichiers<a name="basics_files"></a></h2>
<p> <p>
La structure de fichiers suivante est créée dans le répertoire La structure de fichiers suivante est créée dans le répertoire
<code>$HOME</code> de l'utilisateur (ou bien dans le répertoire <code>$HOME</code> de l'utilisateur (ou bien dans le répertoire
@ -661,13 +704,22 @@ $HOME/.calcurse/
<dd>ce fichier contient la liste des tâches à effectuer</dd> <dd>ce fichier contient la liste des tâches à effectuer</dd>
</dl> </dl>
<h2>4.4 Fonctions d'import/export<a name="basics_import_export"></a></h2> <div class="todo">
<p class="rq"><span class="valorise">Note:</span>
If the logging of calcurse daemon activity was set in the notification
configuration menu, the extra file <code>daemon.log</code> will appear
in calcurse data directory. This file contains logs about calcurse activity
when running in background.
</p>
</div>
<h2>4.5 Fonctions d'import/export<a name="basics_import_export"></a></h2>
<p> <p>
Les possibilités offertes par <code>calcurse</code> pour importer et exporter Les possibilités offertes par <code>calcurse</code> pour importer et exporter
des données sont décrites ci-dessous. des données sont décrites ci-dessous.
</p> </p>
<h3>4.4.1 Import<a name="basics_import"></a></h3> <h3>4.5.1 Import<a name="basics_import"></a></h3>
<p> <p>
Les données au format icalendar tel que décrit dans la spécification Les données au format icalendar tel que décrit dans la spécification
rfc2445 (voir la section <a href="#links_others">liens</a> ci-dessous) rfc2445 (voir la section <a href="#links_others">liens</a> ci-dessous)
@ -708,7 +760,7 @@ $HOME/.calcurse/
</ul> </ul>
</p> </p>
<h3>4.4.2 Export<a name="basics_export"></a></h3> <h3>4.5.2 Export<a name="basics_export"></a></h3>
<p> <p>
Deux formats peuvent êtres utilisés pour l'export des données: Deux formats peuvent êtres utilisés pour l'export des données:
<code>ical</code> et <code>pcal</code> (voir la section <code>ical</code> et <code>pcal</code> (voir la section
@ -716,7 +768,7 @@ $HOME/.calcurse/
concernant ces formats). concernant ces formats).
</p> </p>
<h2>4.5 Aide en ligne<a name="basics_help"></a></h2> <h2>4.6 Aide en ligne<a name="basics_help"></a></h2>
<p> <p>
A n'importe quel moment, le système d'aide en ligne peut être A n'importe quel moment, le système d'aide en ligne peut être
appelé en pressant la touche '?'. Une fois rentré dans l'aide, appelé en pressant la touche '?'. Une fois rentré dans l'aide,
@ -759,16 +811,14 @@ $HOME/.calcurse/
lancement de <code>calcurse</code>.</p> lancement de <code>calcurse</code>.</p>
</dd> </dd>
<div class="todo"> <dt><code><span class="todo">periodic_save</code>
<dt><code>periodic_save</code> (default: <span class="emp">0</span>)</span></dt>
(default: <span class="emp">0</span>)</dt> <dd><span class="todo">If different from '0', user's data will be automatically
<dd>If different from '0', user's data will be automatically saved every <span class="emp">periodic_save</span> minutes.
saved every <span class="emp">periodic_save</span> minutes. When an automatic save is performed, two asterisks
When an automatic save is performed, two asterisks (i.e. '<code>**</code>') will appear on the top right-hand side
(i.e. '<code>**</code>') will appear on the top right-hand side of the screen).</span>
of the screen).</p> </dd>
</dd>
</div>
<dt><code>confirmer_pour_quitter</code> <dt><code>confirmer_pour_quitter</code>
(valeur par défaut: <span class="emp">oui</span>)</dt> (valeur par défaut: <span class="emp">oui</span>)</dt>
@ -965,6 +1015,20 @@ $HOME/.calcurse/
calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com calcurse --next | mail -s "[calcurse] nouveau rendez-vous!" user@host.com
</code> </code>
</dd> </dd>
<dt><code><span class="todo">notify-daemon_enable</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, daemon mode will be enabled, meaning <code>calcurse</code>
will run into background when the user's interface is exited. This will allow the
notifications to be launched even when the interface is not running. More details
can be found in section <a href="#basics_daemon">'Background mode'</a>.</span>
</dd>
<dt><code><span class="todo">notify-daemon_log</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, <code>calcurse</code> daemon activity will be logged (see section
<a href="#basics_files">files</a></span>).
</dd>
</dl> </dl>
<h1>6. Bogues connus<a name="known_bugs"></a></h1> <h1>6. Bogues connus<a name="known_bugs"></a></h1>
@ -1363,7 +1427,7 @@ msgid ""
<div class="footer"> <div class="footer">
Copyright &copy; 2004-2009 Frédéric Culot<br> Copyright &copy; 2004-2009 Frédéric Culot<br>
Calcurse version 2.6 - Dernière modification: 10 Juillet 2009<br> Calcurse version 2.7 - Dernière modification: 18 Aout 2009<br>
</div> </div>
</div> </div>

150
doc/manual_it.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- <!--
/* /*
* $calcurse: manual_it.html,v 1.12 2009/07/10 19:49:08 culot Exp $ * $calcurse: manual_it.html,v 1.13 2009/08/18 13:08:01 culot Exp $
* *
* Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org> * Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org>
* All rights reserved. * All rights reserved.
@ -91,13 +91,14 @@ partecipare allo sviluppo di calcurse.
<li><a href="#basics_interface_noninteractive">4.2.1 Modo non interattivo</a></li> <li><a href="#basics_interface_noninteractive">4.2.1 Modo non interattivo</a></li>
<li><a href="#basics_interface_interactive">4.2.2 Modo interattivo</a></li> <li><a href="#basics_interface_interactive">4.2.2 Modo interattivo</a></li>
</ul></li> </ul></li>
<li><a href="#basics_files">4.3 Files di <code>calcurse</code></a></li> <li><a href="#basics_daemon"><span class="todo">4.3 Background mode</span></a></li>
<li><a href="#basics_import_export"><span class="todo">4.4 Import/Export capabilities</span></a> <li><a href="#basics_files">4.4 Files di <code>calcurse</code></a></li>
<li><a href="#basics_import_export"><span class="todo">4.5 Import/Export capabilities</span></a>
<ul> <ul>
<li><a href="#basics_import"><span class="todo">4.4.1 Import</span></a></li> <li><a href="#basics_import"><span class="todo">4.5.1 Import</span></a></li>
<li><a href="#basics_export"><span class="todo">4.4.2 Export</span></a></li> <li><a href="#basics_export"><span class="todo">4.5.2 Export</span></a></li>
</ul></li> </ul></li>
<li><a href="#basics_help">4.5 Aiuto in linea</a></li> <li><a href="#basics_help">4.6 Aiuto in linea</a></li>
</ul></li> </ul></li>
<li><a href="#options">5. Opzioni</a> <li><a href="#options">5. Opzioni</a>
<ul> <ul>
@ -201,6 +202,8 @@ caratteristiche<a name="overview_features"></a></h2>
<span class="todo">Key bindings are also configurable, to fit everyone's needs.</span> <span class="todo">Key bindings are also configurable, to fit everyone's needs.</span>
Infine un sistema configurabile di allarmi ricorda all'utente Infine un sistema configurabile di allarmi ricorda all'utente
l'avvicinarsi degli appuntamenti. l'avvicinarsi degli appuntamenti.
<span class="todo">The reminders are sent even if the user's interface
is not running, as calcurse is able to run in background.</span>
</p> </p>
<h1>3. Installazione<a name="install"></a></h1> <h1>3. Installazione<a name="install"></a></h1>
@ -268,7 +271,7 @@ caratteristiche<a name="overview_features"></a></h2>
Innanzitutto è necessario scompattare l'archivio contenente i Innanzitutto è necessario scompattare l'archivio contenente i
sorgenti: sorgenti:
</p> </p>
<pre>tar zxvf calcurse-2.6.tar.gz</pre> <pre>tar zxvf calcurse-2.7.tar.gz</pre>
<p> <p>
Una volta verificati i requisiti e scompattato l'archivio la Una volta verificati i requisiti e scompattato l'archivio la
procedura d'installazione è piuttosto semplice visto che segue i tre procedura d'installazione è piuttosto semplice visto che segue i tre
@ -319,7 +322,7 @@ caratteristiche<a name="overview_features"></a></h2>
dell'argomento. Sono possibili due formati: dell'argomento. Sono possibili due formati:
<ul> <ul>
<li>una data <span class="todo">(possible formats described below).</li> <li>una data <span class="todo">(possible formats described below).</span></li>
<li>un numero 'n'.</li> <li>un numero 'n'.</li>
</ul> </ul>
Nel primo caso viene mostrata la lista degli appuntamenti per la Nel primo caso viene mostrata la lista degli appuntamenti per la
@ -403,6 +406,15 @@ caratteristiche<a name="overview_features"></a></h2>
regular expression. regular expression.
</div> </div>
</dd> </dd>
<dt><code>--status</code></dt>
<dd>
<div class="todo">
Display the status of running instances of calcurse. If
calcurse is running, this will tell if the interactive
mode was launched or if calcurse is running in background.
The process pid will also be indicated.
</div>
</dd>
<dt><code>-t[num], --todo[=num]</code></dt> <dt><code>-t[num], --todo[=num]</code></dt>
<dd> <dd>
@ -633,7 +645,38 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
</dl> </dl>
</p> </p>
<h2>4.3 File di <code>calcurse</code><a name="basics_files"></a></h2> <div class="todo">
<h2>4.3 Background mode<a name="basics_daemon"></a></h2>
<p>When the daemon mode is enabled in the notification configuration menu
(see <a href="#options_notify">Notify-bar settings</a>), <code>calcurse</code> will stay
in background when the user interface is not running. In background mode,
<code>calcurse</code> checks for upcoming appointments and runs the user-defined
notification command when necessary. When the user interface is started again,
the daemon automatically stops.</p>
<p><code>calcurse</code> background activity can be logged (set the
<code>notify-daemon_log</code> variable in the notification configuration
<a href="#options_notify">menu</a>), and in that case, information about the daemon
start and stop time, reminders' command launch time, signals received... will be written
in the <code>daemon.log</code> file (see section <a href="#basics_files">files</a>).</p>
<p>
Using the <code>--status</code> command line option (see section
<a href="#basics_invocation_commandline">Command line arguments</a>),
one can know if <code>calcurse</code> is currently running in background or not.
If the daemon is running, a message like the following one will be displayed (the pid of
the daemon process will be shown):
<pre>calcurse is running in background (pid 14536)</pre>
<p class="rq"><span class="valorise">Note:</span>
To stop the daemon, just send the <code>TERM</code> signal to it, using a command such as:
<code>'kill daemon_pid'</code>, where <span class="emp">daemon_pid</span> is the process id
of the daemon (14536 in the above example).
</p>
</div>
<h2>4.4 File di <code>calcurse</code><a name="basics_files"></a></h2>
<p> <p>
Al primo avvio di <code>calcurse</code> viene creata nella vostra Al primo avvio di <code>calcurse</code> viene creata nella vostra
directory <code>$HOME</code> directory <code>$HOME</code>
@ -673,13 +716,22 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
</dl> </dl>
<div class="todo"> <div class="todo">
<h2>4.4 Import/Export capabilities<a name="basics_import_export"></a></h2> <p class="rq"><span class="valorise">Note:</span>
If the logging of calcurse daemon activity was set in the notification
configuration menu, the extra file <code>daemon.log</code> will appear
in calcurse data directory. This file contains logs about calcurse activity
when running in background.
</p>
</div>
<div class="todo">
<h2>4.5 Import/Export capabilities<a name="basics_import_export"></a></h2>
<p> <p>
The import and export capabilities offered by <code>calcurse</code> The import and export capabilities offered by <code>calcurse</code>
are described below. are described below.
</p> </p>
<h3>4.4.1 Import<a name="basics_import"></a></h3> <h3>4.5.1 Import<a name="basics_import"></a></h3>
<p> <p>
Data in icalendar format as described in the rfc2445 specification Data in icalendar format as described in the rfc2445 specification
(see <a href="#links_others">links</a> section below) can be imported (see <a href="#links_others">links</a> section below) can be imported
@ -718,7 +770,7 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
</ul> </ul>
</p> </p>
<h3>4.4.2 Export<a name="basics_export"></a></h3> <h3>4.5.2 Export<a name="basics_export"></a></h3>
<p> <p>
Two possible export formats are available: <code>ical</code> and Two possible export formats are available: <code>ical</code> and
<code>pcal</code> (see section <a href="#links_others">Links</a> below <code>pcal</code> (see section <a href="#links_others">Links</a> below
@ -726,7 +778,7 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
</p> </p>
</div> </div>
<h2>4.5 Aiuto in linea<a name="basics_help"></a></h2> <h2>4.6 Aiuto in linea<a name="basics_help"></a></h2>
<p> <p>
In ogni momento è possibile richiedere il sistema dell'aiuto in In ogni momento è possibile richiedere il sistema dell'aiuto in
linea premendo il tasto '?': una volta avviato si possono richiedere linea premendo il tasto '?': una volta avviato si possono richiedere
@ -766,16 +818,14 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
modificati. modificati.
</dd> </dd>
<div class="todo"> <dt><code><span class="todo">periodic_save</code>
<dt><code>periodic_save</code> (default: <span class="emp">0</span>)</span></dt>
(default: <span class="emp">0</span>)</dt> <dd><span class="todo">If different from '0', user's data will be automatically
<dd>If different from '0', user's data will be automatically saved every <span class="emp">periodic_save</span> minutes.
saved every <span class="emp">periodic_save</span> minutes. When an automatic save is performed, two asterisks
When an automatic save is performed, two asterisks (i.e. '<code>**</code>') will appear on the top right-hand side
(i.e. '<code>**</code>') will appear on the top right-hand side of the screen).</span>
of the screen).</p> </dd>
</dd>
</div>
<dt><code>confirm_quit</code> <dt><code>confirm_quit</code>
(default: <span class="emp">yes</span>)</dt> (default: <span class="emp">yes</span>)</dt>
@ -823,26 +873,25 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
finestra del calendario. finestra del calendario.
</dd> </dd>
<div class="todo"> <dt><code><span class="todo">output_datefmt</code>
<dt><code>output_datefmt</code> (default: <span class="emp">%D</span>)</span></dt>
(default: <span class="emp">%D</span>)</dt> <dd><span class="todo">This option indicates the format to be used when displaying dates
<dd>This option indicates the format to be used when displaying dates in non-interactive mode. Using the default values, dates are displayed the
in non-interactive mode. Using the default values, dates are displayed the following way: <span class="emp">mm/dd/aa</span>.
following way: <span class="emp">mm/dd/aa</span>. You can see all of the possible formats by typing <code>man 3 strftime</code>
You can see all of the possible formats by typing <code>man 3 strftime</code> inside a terminal.</span></dd>
inside a terminal.</dd>
<dt><code>input_datefmt</code> <dt><code><span class="todo">input_datefmt</code>
(default: <span class="emp">1</span>)</dt> (default: <span class="emp">1</span>)</span></dt>
<dd>This option indicates the format that will be used to enter dates in <dd><span class="todo">This option indicates the format that will be used to enter dates in
<span class="emp">calcurse</span>. Four choices are available: <span class="emp">calcurse</span>. Four choices are available:</span>
<ol> <ol>
<li>mm/dd/yyyy</li> <li>mm/dd/yyyy</li>
<li>dd/mm/yyyy</li> <li>dd/mm/yyyy</li>
<li>yyyy/mm/dd</li> <li>yyyy/mm/dd</li>
<li>yyyy-mm-dd</li> <li>yyyy-mm-dd</li>
</ol> </ol>
</dd> </dd>
</div>
</dl> </dl>
@ -989,6 +1038,19 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com
</code> </code>
</dd> </dd>
<dt><code><span class="todo">notify-daemon_enable</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, daemon mode will be enabled, meaning <code>calcurse</code>
will run into background when the user's interface is exited. This will allow the
notifications to be launched even when the interface is not running. More details
can be found in section <a href="#basics_daemon">'Background mode'</a>.</span>
</dd>
<dt><code><span class="todo">notify-daemon_log</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, <code>calcurse</code> daemon activity will be logged (see section
<a href="#basics_files">files</a></span>).
</dd>
</dl> </dl>
<h1>6. Bachi conosciuti<a name="known_bugs"></a></h1> <h1>6. Bachi conosciuti<a name="known_bugs"></a></h1>
@ -1445,7 +1507,7 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
<div class="footer"> <div class="footer">
Copyright &copy; 2004-2009 Fr&eacute;d&eacute;ric Culot<br> Copyright &copy; 2004-2009 Fr&eacute;d&eacute;ric Culot<br>
Calcurse version 2.6 - Last change: July 10, 2009<br> Calcurse version 2.7 - Last change: August 18, 2009<br>
</div> </div>
</div> </div>

115
doc/manual_nl.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//NL"> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//NL">
<!-- <!--
/* /*
* $calcurse: manual_nl.html,v 1.19 2009/07/10 19:49:09 culot Exp $ * $calcurse: manual_nl.html,v 1.20 2009/08/18 13:08:01 culot Exp $
* *
* Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org> * Copyright (c) 2004-2009 Frederic Culot <frederic@culot.org>
* All rights reserved. * All rights reserved.
@ -90,13 +90,14 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
<li><a href="#basics_interface_noninteractive">4.2.1 Niet-interactieve modus</a></li> <li><a href="#basics_interface_noninteractive">4.2.1 Niet-interactieve modus</a></li>
<li><a href="#basics_interface_interactive">4.2.2 Interactieve modus</a></li> <li><a href="#basics_interface_interactive">4.2.2 Interactieve modus</a></li>
</ul></li> </ul></li>
<li><a href="#basics_files">4.3 <code>calcurse</code> bestanden</a></li> <li><a href="#basics_daemon"><span class="todo">4.3 Background mode</span></a></li>
<li><a href="#basics_import_export">4.4 Import/Export mogelijkheden</a> <li><a href="#basics_files">4.4 <code>calcurse</code> bestanden</a></li>
<li><a href="#basics_import_export">4.5 Import/Export mogelijkheden</a>
<ul> <ul>
<li><a href="#basics_import">4.4.1 Importeren</a></li> <li><a href="#basics_import">4.5.1 Importeren</a></li>
<li><a href="#basics_export">4.4.2 Exporteren</a></li> <li><a href="#basics_export">4.5.2 Exporteren</a></li>
</ul></li> </ul></li>
<li><a href="#basics_help">4.5 Online hulp</a></li> <li><a href="#basics_help">4.6 Online hulp</a></li>
</ul></li> </ul></li>
<li><a href="#options">5. Opties</a> <li><a href="#options">5. Opties</a>
<ul> <ul>
@ -168,7 +169,7 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
die gebruikt wordt om de gebruikers-interface aan te sturen. die gebruikt wordt om de gebruikers-interface aan te sturen.
</p> </p>
<h2>2?2 Belangrijke kenmerken<a name="overview_features"></a></h2> <h2>2.2 Belangrijke kenmerken<a name="overview_features"></a></h2>
<p> <p>
<code>Calcurse</code> is multi-platform, neemt weinig systeembronnen <code>Calcurse</code> is multi-platform, neemt weinig systeembronnen
in beslag, en is snel en betrouwbaar. Het moet gebruikt worden binnen in beslag, en is snel en betrouwbaar. Het moet gebruikt worden binnen
@ -194,6 +195,8 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
<span class="todo">Key bindings are also configurable, to fit everyone's needs.</span> <span class="todo">Key bindings are also configurable, to fit everyone's needs.</span>
En als laatste, is er het configurabele meldingssysteem, dat gebruikers En als laatste, is er het configurabele meldingssysteem, dat gebruikers
verwittigt van op handen zijnde afspraken. verwittigt van op handen zijnde afspraken.
<span class="todo">The reminders are sent even if the user's interface
is not running, as calcurse is able to run in background.</span>
</p> </p>
<h1>3. Installatie<a name="install"></a></h1> <h1>3. Installatie<a name="install"></a></h1>
@ -251,7 +254,7 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
<p> <p>
Als eerste moet het volgende archief uitgepakt worden met gunzip en Als eerste moet het volgende archief uitgepakt worden met gunzip en
untar:</p> untar:</p>
<pre>tar zxvf calcurse-2.6.tar.gz</pre> <pre>tar zxvf calcurse-2.7.tar.gz</pre>
<p> <p>
Zodra de benodigde pakketten ge&iuml;nstalleerd zijn en het archief Zodra de benodigde pakketten ge&iuml;nstalleerd zijn en het archief
uitgepakt is, is de installatieprocedure vrij simpel, via de uitgepakt is, is de installatieprocedure vrij simpel, via de
@ -294,7 +297,7 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
Geef de afspraken weer van de gegeven datum of van het gegeven aantal Geef de afspraken weer van de gegeven datum of van het gegeven aantal
komende dagen, afhankelijk van de opties. Er zijn twee mogelijkheden: komende dagen, afhankelijk van de opties. Er zijn twee mogelijkheden:
<ul> <ul>
<li>een datum <span class="todo">(possible formats described below).</li> <li>een datum <span class="todo">(possible formats described below).</span></li>
<li>een nummer 'n'.</li> <li>een nummer 'n'.</li>
</ul> </ul>
In het eerste geval, wordt een lijst met afspraken voor de gegeven In het eerste geval, wordt een lijst met afspraken voor de gegeven
@ -359,6 +362,15 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
regular expression. regular expression.
</div> </div>
</dd> </dd>
<dt><code>--status</code></dt>
<dd>
<div class="todo">
Display the status of running instances of calcurse. If
calcurse is running, this will tell if the interactive
mode was launched or if calcurse is running in background.
The process pid will also be indicated.
</div>
</dd>
<dt><code>-t[num], --todo[=num]</code></dt> <dt><code>-t[num], --todo[=num]</code></dt>
<dd> <dd>
Geef de 'todo' lijst weer en verlaat het programma. Als het optionele Geef de 'todo' lijst weer en verlaat het programma. Als het optionele
@ -576,7 +588,38 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
</dl> </dl>
</p> </p>
<h2>4.3 <code>calcurse</code> bestanden<a name="basics_files"></a></h2> <div class="todo">
<h2>4.3 Background mode<a name="basics_daemon"></a></h2>
<p>When the daemon mode is enabled in the notification configuration menu
(see <a href="#options_notify">Notify-bar settings</a>), <code>calcurse</code> will stay
in background when the user interface is not running. In background mode,
<code>calcurse</code> checks for upcoming appointments and runs the user-defined
notification command when necessary. When the user interface is started again,
the daemon automatically stops.</p>
<p><code>calcurse</code> background activity can be logged (set the
<code>notify-daemon_log</code> variable in the notification configuration
<a href="#options_notify">menu</a>), and in that case, information about the daemon
start and stop time, reminders' command launch time, signals received... will be written
in the <code>daemon.log</code> file (see section <a href="#basics_files">files</a>).</p>
<p>
Using the <code>--status</code> command line option (see section
<a href="#basics_invocation_commandline">Command line arguments</a>),
one can know if <code>calcurse</code> is currently running in background or not.
If the daemon is running, a message like the following one will be displayed (the pid of
the daemon process will be shown):
<pre>calcurse is running in background (pid 14536)</pre>
<p class="rq"><span class="valorise">Note:</span>
To stop the daemon, just send the <code>TERM</code> signal to it, using a command such as:
<code>'kill daemon_pid'</code>, where <span class="emp">daemon_pid</span> is the process id
of the daemon (14536 in the above example).
</p>
</div>
<h2>4.4 <code>calcurse</code> bestanden<a name="basics_files"></a></h2>
<p> <p>
De volgende structuur wordt in je <code>$HOME</code> directory De volgende structuur wordt in je <code>$HOME</code> directory
aangemaakt, of in de door -D aangeduide directory) aangemaakt, of in de door -D aangeduide directory)
@ -607,13 +650,22 @@ $HOME/.calcurse/
<dd>bevat de takenlijst.</dd> <dd>bevat de takenlijst.</dd>
</dl> </dl>
<h2>4.4 Import/Export mogelijkheden<a name="basics_import_export"></a></h2> <div class="todo">
<p class="rq"><span class="valorise">Note:</span>
If the logging of calcurse daemon activity was set in the notification
configuration menu, the extra file <code>daemon.log</code> will appear
in calcurse data directory. This file contains logs about calcurse activity
when running in background.
</p>
</div>
<h2>4.5 Import/Export mogelijkheden<a name="basics_import_export"></a></h2>
<p> <p>
De import en export mogelijkheden van <code>calcurse</code> zijn als De import en export mogelijkheden van <code>calcurse</code> zijn als
volgt: volgt:
</p> </p>
<h3>4.4.1 Import<a name="basics_import"></a></h3> <h3>4.5.1 Import<a name="basics_import"></a></h3>
<p> <p>
Data in icalender formaat, zoals beschrevein in de rfc2445 specificatie Data in icalender formaat, zoals beschrevein in de rfc2445 specificatie
(zie <a href="#links_others">links</a> sectie beneden), kan (zie <a href="#links_others">links</a> sectie beneden), kan
@ -656,14 +708,14 @@ $HOME/.calcurse/
</ul> </ul>
</p> </p>
<h3>4.4.2 Export<a name="basics_export"></a></h3> <h3>4.5.2 Export<a name="basics_export"></a></h3>
<p> <p>
Twee export formaten zijn voorradig: <code>ical</code> en Twee export formaten zijn voorradig: <code>ical</code> en
<code>pcal</code> (zie sectie <a href="#links_others">Links</a> beneden <code>pcal</code> (zie sectie <a href="#links_others">Links</a> beneden
voor meer informatie over deze formaten). voor meer informatie over deze formaten).
</p> </p>
<h2>4.5 Online hulp<a name="basics_help"></a></h2> <h2>4.6 Online hulp<a name="basics_help"></a></h2>
<p> <p>
De ingebouwde hulp kan waar nodig aangeroepen worden door middel van De ingebouwde hulp kan waar nodig aangeroepen worden door middel van
de '?' toets. Tijdens het gebruik van de hulpschermen kan een de '?' toets. Tijdens het gebruik van de hulpschermen kan een
@ -703,17 +755,14 @@ $HOME/.calcurse/
bewaren.</p> bewaren.</p>
</dd> </dd>
<div class="todo"> <dt><code><span class="todo">periodic_save</code>
<dt><code>periodic_save</code> (default: <span class="emp">0</span>)</span></dt>
(default: <span class="emp">0</span>)</dt> <dd><span class="todo">If different from '0', user's data will be automatically
<dd>If different from '0', user's data will be automatically saved every <span class="emp">periodic_save</span> minutes.
saved every <span class="emp">periodic_save</span> minutes. When an automatic save is performed, two asterisks
When an automatic save is performed, two asterisks (i.e. '<code>**</code>') will appear on the top right-hand side
(i.e. '<code>**</code>') will appear on the top right-hand side of the screen).</span>
of the screen).</p> </dd>
</dd>
</div>
<dt><code>einde_bevestigen</code> <dt><code>einde_bevestigen</code>
(standaard: <span class="emp">ja</span>)</dt> (standaard: <span class="emp">ja</span>)</dt>
@ -890,6 +939,20 @@ $HOME/.calcurse/
calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com
</code> </code>
</dd> </dd>
<dt><code><span class="todo">notify-daemon_enable</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, daemon mode will be enabled, meaning <code>calcurse</code>
will run into background when the user's interface is exited. This will allow the
notifications to be launched even when the interface is not running. More details
can be found in section <a href="#basics_daemon">'Background mode'</a>.</span>
</dd>
<dt><code><span class="todo">notify-daemon_log</code>
(default: <span class="emp">no</span>)</span></dt>
<dd><span class="todo">If set to yes, <code>calcurse</code> daemon activity will be logged (see section
<a href="#basics_files">files</a></span>).
</dd>
</dl> </dl>
<h1>6. bekende bugs<a name="bekende_bugs"></a></h1> <h1>6. bekende bugs<a name="bekende_bugs"></a></h1>
@ -1210,7 +1273,7 @@ msgid ""
<div class="footer"> <div class="footer">
Copyright &copy; 2004-2009 Frédéric Culot<br> Copyright &copy; 2004-2009 Frédéric Culot<br>
Calcurse version 2.6 - Last change: July 10, 2009<br> Calcurse version 2.7 - Last change: August 18, 2009<br>
</div> </div>
</div> </div>