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

manual and manpage updated for 2.4

Browse Source
This commit is contained in:
Frederic Culot 2008-12-09 21:09:17 +00:00
parent dd9f739d8a
commit bd286546f4
8 changed files with 372 additions and 101 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
ChangeLog
View File

@ -1,3 +1,9 @@
2008-12-09 Frederic Culot <frederic@culot.org>
* src/calcurse.1: manpage update for 2.4
* doc/manual_*.html: update for 2.4
2008-12-08 Frederic Culot <frederic@culot.org>
* src/custom.c (custom_color_config_bar): new function

97
doc/manual_de.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!--
/*
* $calcurse: manual_de.html,v 1.20 2008/09/21 14:08:59 culot Exp $
* $calcurse: manual_de.html,v 1.21 2008/12/09 21:09:17 culot Exp $
*
* Calcurse - text-based organizer
* Copyright (c) 2004-2008 Frederic Culot
@ -96,9 +96,10 @@ well as the way one can contribute to <code>calcurse</code> development.
<li><a href="#options">5. Optionen</a>
<ul>
<li><a href="#options_general">5.1 Allgemeine Optionen</a></li>
<li><a href="#options_colors">5.2 Einstellen der Terminalfarben</a></li>
<li><a href="#options_layout">5.3 Einstellen des Layouts</a></li>
<li><a href="#options_notify">5.4 Einstellen der Benachrichtigungszeile</a></li>
<li><a href="#options_keys"><span class="todo">5.2 Key bindings</span></a>
<li><a href="#options_colors">5.3 Einstellen der Terminalfarben</a></li>
<li><a href="#options_layout">5.4 Einstellen des Layouts</a></li>
<li><a href="#options_notify">5.5 Einstellen der Benachrichtigungszeile</a></li>
</ul></li>
<li><a href="#known_bugs">6. Bekannte Fehler</a></li>
<li><a href="#bugs">7. Mitteilung von Fehlern und Anregungen</a></li>
@ -188,7 +189,9 @@ bedeutet, dass eine komplette Onlinehilfe im Programm zu Verf&uuml;gung
steht, sowie alle m&ouml;gliche Aktionen jederzeit in einer Statuszeile
ersichtlich sind. Das Benutzer-Interface ist ebenfalls
einstellbar. Ebenso kann man verschiedene Textfarben und Layouts
w&auml;hlen. Ein konfigurierbares Notizsystem erinnert den Benutzer
w&auml;hlen.
<span class="todo">Key bindings are also configurable, to fit everyone's needs.</span>
Ein konfigurierbares Notizsystem erinnert den Benutzer
an bevorstehende Termine.
</p>
@ -238,7 +241,7 @@ laden:</p>
<h2>3.2 Installationsprozess<a name="install_process"></a></h2>
<p>
Als erstes m&uuml;ssen die Dateien entpackt werden:</p>
<pre>tar zxvf calcurse-2.3.tar.gz</pre>
<pre>tar zxvf calcurse-2.4.tar.gz</pre>
<p>
Ist diese Voraussetzung erf&uuml;llt und das Archiv entpackt,
sind nur noch die drei &uuml;blichen Schritte erforderlich:</p>
@ -427,6 +430,14 @@ und alle Termine des heutigen Tages beim Logon anzeigen zu lassen.</p>
<h3>4.2.2 Interaktiver Modus<a name="basics_interface_interactive"></a></h3>
<div class="todo">
<p class="rq"><span class="valorise">Note:</span>
Key bindings that are indicated in this manual correspond to
the default ones, defined when <code>calcurse</code> is launched
for the first time. If those key bindings do not suit user's needs,
it is possible to change them within the keys configuration menu
(see <a href="#options_keys">key bindings</a>).</p>
</div>
<p>
Wird keine, oder nur Option -c angegeben, startet
<code>calcurse</code> im interaktiven Modus. In diesem Modus erh&auml;lt
@ -544,6 +555,7 @@ wenn <code>calcurse</code> das erste Mal gestartet wird:</p>
$HOME/.calcurse/
|___notes/
|___conf
|___keys
|___apts
|___todo
</pre>
@ -555,37 +567,14 @@ $HOME/.calcurse/
unique, but with no relation with the corresponding item's description.</span></dd>
<dt><code>conf</code>:</dt>
<dd>Datei enth&auml;lt die Informationen zur Benutzerkonfiguration.</dd>
<dt><code>keys</code>:</dt>
<dd><span class="todo">this file contains the user-defined key bindings</span></dd>
<dt><code>apts</code>:</dt>
<dd>Datei enth&auml;lt alle Termine.</dd>
<dt><code>todo</code>:</dt>
<dd>Datei enth&auml;lt die todo-Liste.</dd>
</dl>
<h2>4.3 <code>calcurse</code> files<a name="basics_files"></a></h2>
<p>
The following structure is created in your <code>$HOME</code>
directory (or in the directory you specified with the -D option)
the first time <code>calcurse</code> is run :</p>
<pre>
$HOME/.calcurse/
|___notes/
|___conf
|___apts
|___todo
</pre>
<dl class="compact">
<dt><code>notes/</code>:</dt>
<dd>this subdirectory contains descriptions of the notes
which are attached to appointments, events or todos. One text file is
created per note, whose name is built using mkstemp(3) and should be
unique, but with no relation with the corresponding item's description.</dd>
<dt><code>conf</code>:</dt>
<dd>this file contains the user configuration</dd>
<dt><code>apts</code>:</dt>
<dd>this file contains all of the events and user's appointments</dd>
<dt><code>todo</code>:</dt>
<dd>this file contains the todo list</dd>
</dl>
<div class="todo">
<h2>4.4 Import/Export capabilities<a name="basics_import_export"></a></h2>
@ -656,7 +645,10 @@ Daraufhin erscheint ein Untermen&uuml; mit vier weiteren Wahlm&ouml;glichkeiten:
Das erneute Bet&auml;tigen von 'C' f&uuml;hrt Sie zu den Farbeinstellungen und
&uuml;ber 'L' gelangen Sie in ein Untermen&uuml;, in dem Sie die Anordnung der
drei Panel &auml;ndern k&ouml;nnen. Dr&uuml;cken Sie 'G' um ins Auswahlmen&uuml;
der allgemeinen Optionen zu gelangen. Zu guter Letzt k&ouml;nnen Sie die
der allgemeinen Optionen zu gelangen.
<span class="todo">pressing 'K' opens the key bindings configuration
menu.</span>
Zu guter Letzt k&ouml;nnen Sie die
Einstellungen der Benachrichtigungszeile &auml;ndern, indem Sie die Taste 'N'
bet&auml;tigen.</p>
@ -724,11 +716,42 @@ allgemeines Verhalten.</p>
</ol>
</dd>
</div>
</dl>
<div class="todo">
<h2>5.2 Key bindings<a name="options_keys"></a></h2>
<p>
One can define it's own keybindings within the 'Keys' configuration
menu. The default keys look like the one used by the <code>vim</code>
editor, especially the displacement keys. Anyway, within this
configuration menu, users can redefine all of the keys available from
within calcurse's user interface.</p>
<p>
To define new keybindings, first highlight the action to which it will
apply. Then, delete the actual key binding if necessary, and add a new
one. You will then be asked to press the key corresponding to the new
binding. It is possible to define more than one key binding for a single
action.</p>
<p>
An automatic check is performed to see if the new key binding
is not already set for another action. In that case, you will be asked
to choose a different one. Another check is done when exiting from this
menu, to make sure all possible actions have a key associated with it.</p>
<p>
The following keys can be used to define bindings:
<ul>
<li>lower-case, upper-case letters and numbers, such as 'a', 'Z', '0'</li>
<li>CONTROL-key followed by one of the above letters</li>
<li>escape, horizontal tab, and space keys</li>
<li>arrow keys (up, down, left, and right)</li>
</ul> </p>
<p>
While inside the key configuration menu, an online help is available for
each one of the available actions. This help briefly describes what the
highlighted action is used for.</p>
</div>
<h2>5.2 Textfarben einstellen<a name="options_colors"></a></h2>
<h2>5.3 Textfarben einstellen<a name="options_colors"></a></h2>
<p>
<code>calcurse</code> Textfarben k&ouml;nnen nach eigenen
Vorlieben eingestellt werden. Um die Standartfarben zu wechseln,
@ -755,7 +778,7 @@ auch den Eintrag f&uuml;r die Standartfarben des Terminals.</p>
(etwa <span class="emp">xterm-xfree86</span>).
</p>
<h2>5.3 Layout einstellen<a name="options_layout"></a></h2>
<h2>5.4 Layout einstellen<a name="options_layout"></a></h2>
<p>
Das Layout bezieht sich auf die Positionen der einzelnen Panel. Das
Standard-Layout zeigt das Kalender-Panel in der oberen linken Ecke des
@ -768,7 +791,7 @@ Erscheinungsbild von <code>calcurse</code> seinen eigenen W&uuml;nschen
entsprechend anpassen.</p>
<h2>5.4 Benachrichtigungszeile einstellen<a name="options_notify"></a></h2>
<h2>5.5 Benachrichtigungszeile einstellen<a name="options_notify"></a></h2>
<p>
Folgende Optionen &auml;ndern das Verhalten der Benachrichtigungszeile:</p>
<dl>
@ -1118,7 +1141,7 @@ Benutzer, die mir Ihr Feedback mitgeteilt haben.</p>
Copyright (c) 2004-2008 Frédéric Culot<br>
German translation by Michael Schulz
<code>&lt;bloodshower .at. web .dot. de&gt;</code>, and Chris.<br>
Calcurse version 2.3 - Last change: September 21, 2008<br>
Calcurse version 2.4 - Last change: December 09, 2008<br>
</div>
</div>

72
doc/manual_en.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!--
/*
* $calcurse: manual_en.html,v 1.20 2008/09/21 14:08:59 culot Exp $
* $calcurse: manual_en.html,v 1.21 2008/12/09 21:09:17 culot Exp $
*
* Calcurse - text-based organizer
* Copyright (c) 2004-2008 Frederic Culot
@ -93,9 +93,10 @@ well as the way one can contribute to <code>calcurse</code> development.
<li><a href="#options">5. Options</a>
<ul>
<li><a href="#options_general">5.1 General options</a></li>
<li><a href="#options_colors">5.2 Color themes</a></li>
<li><a href="#options_layout">5.3 Layout configuration</a></li>
<li><a href="#options_notify">5.4 Notify-bar settings</a></li>
<li><a href="#options_keys">5.2 Key bindings</a></li>
<li><a href="#options_colors">5.3 Color themes</a></li>
<li><a href="#options_layout">5.4 Layout configuration</a></li>
<li><a href="#options_notify">5.5 Notify-bar settings</a></li>
</ul></li>
<li><a href="#known_bugs">6. Known bugs</a></li>
<li><a href="#bugs">7. Reporting bugs and feedback</a></li>
@ -180,8 +181,9 @@ All of the commands are documented within an online help system.
in mind, and tends to be as friendly as possible. This means
a complete on-line help system, together with having all of
the possible actions displayed at any time inside a status bar.
The user interface is also configurable, and one can choose
The user interface is configurable, and one can choose
between several color and layout combinations.
Key bindings are also configurable, to fit everyone's needs.
Last, a configurable notification system reminds user of upcoming
appointments.
</p>
@ -236,7 +238,7 @@ All of the commands are documented within an online help system.
<h2>3.2 Install process<a name="install_process"></a></h2>
<p>
First you need to gunzip and untar the source archive:</p>
<pre>tar zxvf calcurse-2.3.tar.gz</pre>
<pre>tar zxvf calcurse-2.4.tar.gz</pre>
<p>
Once you meet the requirements and have extracted the archive,
the install process is quite simple, and follows the standard
@ -433,7 +435,14 @@ All of the commands are documented within an online help system.
<h3>4.2.2 Interactive mode<a name="basics_interface_interactive"></a></h3>
<p>
When called without any argument or only with the
<p class="rq"><span class="valorise">Note:</span>
Key bindings that are indicated in this manual correspond to
the default ones, defined when <code>calcurse</code> is launched
for the first time. If those key bindings do not suit user's needs,
it is possible to change them within the keys configuration menu
(see <a href="#options_keys">key bindings</a>).</p>
<p>When called without any argument or only with the
<code>-c</code> option, <code>calcurse</code> is started in
interactive mode. In this mode, you are shown an interface
containing three different panels which you can browse using
@ -551,6 +560,7 @@ All of the commands are documented within an online help system.
$HOME/.calcurse/
|___notes/
|___conf
|___keys
|___apts
|___todo
</pre>
@ -562,6 +572,8 @@ $HOME/.calcurse/
unique, but with no relation with the corresponding item's description.</dd>
<dt><code>conf</code>:</dt>
<dd>this file contains the user configuration</dd>
<dt><code>keys</code>:</dt>
<dd>this file contains the user-defined key bindings</dd>
<dt><code>apts</code>:</dt>
<dd>this file contains all of the events and user's appointments</dd>
<dt><code>todo</code>:</dt>
@ -632,13 +644,13 @@ $HOME/.calcurse/
<p>
All of the <code>calcurse</code> parameters are configurable from the
Configuration menu available when pressing 'C'. You are then
driven to a submenu with four possible choices : pressing 'C'
driven to a submenu with five possible choices : pressing 'C'
again will lead you to the Color scheme configuration,
pressing 'L' allows you to choose the layout of the main
<code>calcurse</code> screen (in other words, where to put the three
different panels on screen), pressing 'G' permits you to choose between
different general options, and last you can modify the notify-bar
settings by pressing 'N'.</p>
different general options, pressing 'K' opens the key bindings configuration
menu, and last you can modify the notify-bar settings by pressing 'N'.</p>
<h2>5.1 General options<a name="options_general"></a></h2>
<p>
@ -711,7 +723,39 @@ $HOME/.calcurse/
</dl>
<h2>5.2 Color themes<a name="options_colors"></a></h2>
<h2>5.2 Key bindings<a name="options_keys"></a></h2>
<p>
One can define it's own keybindings within the 'Keys' configuration
menu. The default keys look like the one used by the <code>vim</code>
editor, especially the displacement keys. Anyway, within this
configuration menu, users can redefine all of the keys available from
within calcurse's user interface.</p>
<p>
To define new keybindings, first highlight the action to which it will
apply. Then, delete the actual key binding if necessary, and add a new
one. You will then be asked to press the key corresponding to the new
binding. It is possible to define more than one key binding for a single
action.</p>
<p>
An automatic check is performed to see if the new key binding
is not already set for another action. In that case, you will be asked
to choose a different one. Another check is done when exiting from this
menu, to make sure all possible actions have a key associated with it.</p>
<p>
The following keys can be used to define bindings:
<ul>
<li>lower-case, upper-case letters and numbers, such as 'a', 'Z', '0'</li>
<li>CONTROL-key followed by one of the above letters</li>
<li>escape, horizontal tab, and space keys</li>
<li>arrow keys (up, down, left, and right)</li>
</ul> </p>
<p>
While inside the key configuration menu, an online help is available for
each one of the available actions. This help briefly describes what the
highlighted action is used for.</p>
<h2>5.3 Color themes<a name="options_colors"></a></h2>
<p>
<code>calcurse</code> color theme can be customized to suit user's
needs. To change the default theme, the configuration page
@ -738,7 +782,7 @@ $HOME/.calcurse/
</p>
<h2>5.3 Layout configuration<a name="options_layout"></a></h2>
<h2>5.4 Layout configuration<a name="options_layout"></a></h2>
<p>
The layout corresponds to the position of the panels inside
<code>calcurse</code> screen. The default layout makes the
@ -753,7 +797,7 @@ $HOME/.calcurse/
his needs by placing the different panels where needed.</p>
<h2>5.4 Notify-bar settings<a name="options_notify"></a></h2>
<h2>5.5 Notify-bar settings<a name="options_notify"></a></h2>
<p>
The following options are used to modify the notify-bar behavior:</p>
<dl>
@ -1126,7 +1170,7 @@ msgid ""
<div class="footer">
Copyright (c) 2004-2008 Frédéric Culot<br>
Calcurse version 2.3 - Last change: September 21, 2008<br>
Calcurse version 2.4 - Last change: December 09, 2008<br>
</div>
</div>

69
doc/manual_es.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!--
/*
* $calcurse: manual_es.html,v 1.17 2008/09/21 14:08:59 culot Exp $
* $calcurse: manual_es.html,v 1.18 2008/12/09 21:09:17 culot Exp $
*
* Calcurse - text-based organizer
* Copyright (c) 2004-2008 Frederic Culot
@ -96,9 +96,10 @@ well as the way one can contribute to <code>calcurse</code> development.
<li><a href="#options">5. Opciones</a>
<ul>
<li><a href="#options_general">5.1 Opciones generales</a></li>
<li><a href="#options_colors">5.2 Color (temas)</a></li>
<li><a href="#options_layout">5.3 Configuración de la disposición</a></li>
<li><a href="#options_notify">5.4 Ajustes de la barra de notificaciones</a></li>
<li><a href="#options_keys"><span class="todo">5.2 Key bindings</span></a>
<li><a href="#options_colors">5.3 Color (temas)</a></li>
<li><a href="#options_layout">5.4 Configuración de la disposición</a></li>
<li><a href="#options_notify">5.5 Ajustes de la barra de notificaciones</a></li>
</ul></li>
<li><a href="#known_bugs">6. Bugs conocidos</a></li>
<li><a href="#bugs">7. Informar de bugs y comentarios</a></li>
@ -185,6 +186,7 @@ well as the way one can contribute to <code>calcurse</code> development.
las posibles acciones visualizadas en todo momento en la barra de
estado. La interfaz de usuario también es configurable y uno puede
elegir entre combinaciones de colores y disposiciones.
<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.
</p>
@ -236,7 +238,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>
<p>
Primero necesitas descomprimir ( gunzip y untar) el archivo fuente:</p>
<pre>tar zxvf calcurse-2.3.tar.gz</pre>
<pre>tar zxvf calcurse-2.4.tar.gz</pre>
<p>
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:
@ -435,6 +437,14 @@ well as the way one can contribute to <code>calcurse</code> development.
programadas para el día actual.</p>
<h3>4.2.2 Modo interactivo<a name="basics_interface_interactive"></a></h3>
<div class="todo">
<p class="rq"><span class="valorise">Note:</span>
Key bindings that are indicated in this manual correspond to
the default ones, defined when <code>calcurse</code> is launched
for the first time. If those key bindings do not suit user's needs,
it is possible to change them within the keys configuration menu
(see <a href="#options_keys">key bindings</a>).</p>
</div>
<p>
Cuando es llamado sin ningún argumento o solo con la opción
<code>-c</code>, <code>calcurse</code> arranca en modo interactivo.
@ -556,6 +566,7 @@ well as the way one can contribute to <code>calcurse</code> development.
$HOME/.calcurse/
|___notes/
|___conf
|___keys
|___apts
|___todo
</pre>
@ -567,6 +578,8 @@ $HOME/.calcurse/
unique, but with no relation with the corresponding item's description.</span></dd>
<dt><code>conf</code>:</dt>
<dd>contiene la configuración del usuario.</dd>
<dt><code>keys</code>:</dt>
<dd><span class="todo">this file contains the user-defined key bindings</span></dd>
<dt><code>apts</code>:</dt>
<dd>contiene todos los eventos y citas del usuario.</dd>
<dt><code>todo</code>:</dt>
@ -643,7 +656,10 @@ $HOME/.calcurse/
pulsando 'C' de nuevo, te lleva a la configuración del esquema de colores.
Pulsando 'L' te permite elegir la disposición de la pantalla principal
de <code>calcurse</code> (en otras palabras, donde colocar los tres diferentes
paneles en pantalla), y finalmente puedes elegir entre diferentes opciones
paneles en pantalla),
<span class="todo">pressing 'K' opens the key bindings configuration
menu,</span>
y finalmente puedes elegir entre diferentes opciones
generales pulsando 'G'.
</p>
@ -723,7 +739,40 @@ $HOME/.calcurse/
</dl>
<h2>5.2 Color (temas)<a name="options_colors"></a></h2>
<div class="todo">
<h2>5.2 Key bindings<a name="options_keys"></a></h2>
<p>
One can define it's own keybindings within the 'Keys' configuration
menu. The default keys look like the one used by the <code>vim</code>
editor, especially the displacement keys. Anyway, within this
configuration menu, users can redefine all of the keys available from
within calcurse's user interface.</p>
<p>
To define new keybindings, first highlight the action to which it will
apply. Then, delete the actual key binding if necessary, and add a new
one. You will then be asked to press the key corresponding to the new
binding. It is possible to define more than one key binding for a single
action.</p>
<p>
An automatic check is performed to see if the new key binding
is not already set for another action. In that case, you will be asked
to choose a different one. Another check is done when exiting from this
menu, to make sure all possible actions have a key associated with it.</p>
<p>
The following keys can be used to define bindings:
<ul>
<li>lower-case, upper-case letters and numbers, such as 'a', 'Z', '0'</li>
<li>CONTROL-key followed by one of the above letters</li>
<li>escape, horizontal tab, and space keys</li>
<li>arrow keys (up, down, left, and right)</li>
</ul> </p>
<p>
While inside the key configuration menu, an online help is available for
each one of the available actions. This help briefly describes what the
highlighted action is used for.</p>
</div>
<h2>5.3 Color (temas)<a name="options_colors"></a></h2>
<p>
El tema de color de <code>calcurse</code> puede se configurado para
cubrir las necesidades del usuario. Para cambiar el tema por defecto, la
@ -751,7 +800,7 @@ $HOME/.calcurse/
a otro valor. (como por ejemplo <span class="emp">xterm-xfree86</span>).
</p>
<h2>5.3 Configuración de la disposición<a name="options_layout"></a></h2>
<h2>5.4 Configuración de la disposición<a name="options_layout"></a></h2>
<p>
La disposición corresponde a la posición de los paneles
dentro de la pantalla de <code>calcurse</code>. La disposición por defecto
@ -764,7 +813,7 @@ $HOME/.calcurse/
modificar la apariencia de <code>calcurse</code> que mejor se adapte a sus
necesidades colocando los diferentes paneles donde los necesite.</p>
<h2>5.4 Ajustes de la barra de notificaciones<a name="options_notify"></a></h2>
<h2>5.5 Ajustes de la barra de notificaciones<a name="options_notify"></a></h2>
<p>
Las siguientes opciones se usan para modificar el comportamiento de la barra de notificaciones:</p>
<dl>
@ -1110,7 +1159,7 @@ msgid ""
Copyright (c) 2004-2008 Frédéric Culot<br>
Traducido al Español por José López
<code>&lt;testinground .at. gmail .dot. com&gt;</code><br>
Calcurse version 2.3 - Last change: September 21, 2008<br>
Calcurse version 2.4 - Last change: December 09, 2008<br>
</div>
</div>

70
doc/manual_fr.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!--
/*
* $calcurse: manual_fr.html,v 1.21 2008/09/21 14:08:59 culot Exp $
* $calcurse: manual_fr.html,v 1.22 2008/12/09 21:09:17 culot Exp $
*
* Calcurse - text-based organizer
* Copyright (c) 2004-2008 Frederic Culot
@ -96,9 +96,10 @@ pour faire remonter les bogues et pour contribuer au d
<li><a href="#options">5. Options</a>
<ul>
<li><a href="#options_general">5.1 Options générales</a></li>
<li><a href="#options_colors">5.2 Thèmes graphiques</a></li>
<li><a href="#options_layout">5.3 Disposition des panneaux</a></li>
<li><a href="#options_notify">5.4 Réglages de la barre de notification</a></li>
<li><a href="#options_keys">5.2 Raccourcis clavier</a>
<li><a href="#options_colors">5.3 Thèmes graphiques</a></li>
<li><a href="#options_layout">5.4 Disposition des panneaux</a></li>
<li><a href="#options_notify">5.5 Réglages de la barre de notification</a></li>
</ul></li>
<li><a href="#known_bugs">6. Bogues connus</a></li>
<li><a href="#bugs">7. Rapporter les bogues et commentaires</a></li>
@ -198,7 +199,9 @@ disponibles.
possibles dans la barre de status. L'interface utilisateur
est également configurable, et l'on peut choisir parmi de
nombreuses combinaisons possibles de couleurs et de positions
des fenêtres. Enfin, le système de notification est
des fenêtres. Les raccourcis clavier peuvent être définis aussi
par l'utilisateur, pour correspondre aux besoins de chacun.
Enfin, le système de notification est
entièrement configurable, l'utilisateur peut donc choisir la
manière dont il veut être prévenu de l'approche d'un
rendez-vous.
@ -264,7 +267,7 @@ disponibles.
<p>
Vous devez tout d'abord décompresser l'archive source de la
manière suivante :</p>
<pre>tar zxvf calcurse-2.3.tar.gz</pre>
<pre>tar zxvf calcurse-2.4.tar.gz</pre>
<p>
Une fois que vous remplissez tous les pré-requis nécessaires à
l'installation, le processus de compilation est simple et suit
@ -475,6 +478,14 @@ disponibles.
<h3>4.2.2 Mode interactif<a name="basics_interface_interactive"></a></h3>
<div class="todo">
<p class="rq"><span class="valorise">Note:</span>
Key bindings that are indicated in this manual correspond to
the default ones, defined when <code>calcurse</code> is launched
for the first time. If those key bindings do not suit user's needs,
it is possible to change them within the keys configuration menu
(see <a href="#options_keys">key bindings</a>).</p>
</div>
<p>
Lorsqu'il est appelé sans aucun argument ou uniquement avec
l'option <code>'-c'</code>, <code>calcurse</code> est lancé
@ -602,6 +613,7 @@ disponibles.
$HOME/.calcurse/
|___notes/
|___conf
|___keys
|___apts
|___todo
</pre>
@ -615,6 +627,8 @@ $HOME/.calcurse/
rattachée.</dd>
<dt><code>conf</code>:</dt>
<dd>ce fichier contient la configuration de l'utilisateur</dd>
<dt><code>keys</code>:</dt>
<dd>ce fichier contient les raccourcis clavier définis par l'utilisateur</dd>
<dt><code>apts</code>:</dt>
<dd>ce fichier contient tous les événements ainsi que les
rendez-vous de l'utilisateur</dd>
@ -695,7 +709,9 @@ $HOME/.calcurse/
au menu de sélection des couleurs de l'interface, appuyer sur
'L' permet de choisir parmi différents emplacements pour les
panneaux de la fenêtre principale de <code>calcurse</code>,
appuyer sur 'G' vous permet de fixer les options générales, et enfin
appuyer sur 'G' vous permet de fixer les options générales, 'K'
vous permet d'accéder au menu de configuration des raccourcis clavier,
et enfin
les paramètres de la barre de notification peuvent être fixés
en appuyant sur 'N'.</p>
@ -781,8 +797,40 @@ $HOME/.calcurse/
</dd>
</dl>
<div class="todo">
<h2>5.2 Key bindings<a name="options_keys"></a></h2>
<p>
One can define it's own keybindings within the 'Keys' configuration
menu. The default keys look like the one used by the <code>vim</code>
editor, especially the displacement keys. Anyway, within this
configuration menu, users can redefine all of the keys available from
within calcurse's user interface.</p>
<p>
To define new keybindings, first highlight the action to which it will
apply. Then, delete the actual key binding if necessary, and add a new
one. You will then be asked to press the key corresponding to the new
binding. It is possible to define more than one key binding for a single
action.</p>
<p>
An automatic check is performed to see if the new key binding
is not already set for another action. In that case, you will be asked
to choose a different one. Another check is done when exiting from this
menu, to make sure all possible actions have a key associated with it.</p>
<p>
The following keys can be used to define bindings:
<ul>
<li>lower-case, upper-case letters and numbers, such as 'a', 'Z', '0'</li>
<li>CONTROL-key followed by one of the above letters</li>
<li>escape, horizontal tab, and space keys</li>
<li>arrow keys (up, down, left, and right)</li>
</ul> </p>
<p>
While inside the key configuration menu, an online help is available for
each one of the available actions. This help briefly describes what the
highlighted action is used for.</p>
</div>
<h2>5.2 Thèmes graphiques<a name="options_colors"></a></h2>
<h2>5.3 Thèmes graphiques<a name="options_colors"></a></h2>
<p>
Le thème graphique de <code>calcurse</code> peut être adapté aux besoins de
l'utilisateur. Pour changer les options par défaut, la page de configuration
@ -812,7 +860,7 @@ $HOME/.calcurse/
<span class="emp">xterm-xfree86</span>).
</p>
<h2>5.3 Disposition des panneaux<a name="options_layout"></a></h2>
<h2>5.4 Disposition des panneaux<a name="options_layout"></a></h2>
<p>
La disposition des panneaux à l'intérieur de la fenêtre de
<code>calcurse</code> peut être paramétrée. Par défaut, le
@ -826,7 +874,7 @@ $HOME/.calcurse/
la fenêtre de <code>calcurse</code>, l'utilisateur peut adapter
à ses besoins l'interface du programme.</p>
<h2>5.4 Réglages de la barre de notification<a name="options_notify"></a></h2>
<h2>5.5 Réglages de la barre de notification<a name="options_notify"></a></h2>
<p>
Les options suivantes permettent de modifier les réglages de la
barre de notification:</p>
@ -1276,7 +1324,7 @@ msgid ""
<div class="footer">
Copyright (c) 2004-2008 Frédéric Culot<br>
Calcurse version 2.3 - Dernière modification: 21 Septembre 2008<br>
Calcurse version 2.4 - Dernière modification: 09 Décembre 2008<br>
</div>
</div>

69
doc/manual_it.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!--
/*
* $calcurse: manual_it.html,v 1.6 2008/09/21 14:08:59 culot Exp $
* $calcurse: manual_it.html,v 1.7 2008/12/09 21:09:17 culot Exp $
*
* Calcurse - text-based organizer
* Copyright (c) 2004-2008 Frederic Culot
@ -95,10 +95,11 @@ partecipare allo sviluppo di calcurse.
<li><a href="#options">5. Opzioni</a>
<ul>
<li><a href="#options_general">5.1 Opzioni generali</a></li>
<li><a href="#options_colors">5.2 Temi dei colori</a></li>
<li><a href="#options_layout">5.3 Configurazione dell'interfaccia</a></li>
<li><a href="#options_keys"><span class="todo">5.2 Key bindings</span></a>
<li><a href="#options_colors">5.3 Temi dei colori</a></li>
<li><a href="#options_layout">5.4 Configurazione dell'interfaccia</a></li>
<li>
<a href="#options_notify">5.4 Configurazioni della barra di
<a href="#options_notify">5.5 Configurazioni della barra di
notifica</a>
</li>
</ul></li>
@ -190,6 +191,7 @@ caratteristiche<a name="overview_features"></a></h2>
cui sono elencate tutte le azioni disponibili.
Anche l'interfaccia utente è configurabile permettendo di poter
scegliere fra diverse combinazioni di colori e layout.
<span class="todo">Key bindings are also configurable, to fit everyone's needs.</span>
Infine un sistema configurabile di allarmi ricorda all'utente
l'avvicinarsi degli appuntamenti.
</p>
@ -252,7 +254,7 @@ caratteristiche<a name="overview_features"></a></h2>
Innanzitutto è necessario scompattare l'archivio contenente i
sorgenti:
</p>
<pre>tar zxvf calcurse-2.3.tar.gz</pre>
<pre>tar zxvf calcurse-2.4.tar.gz</pre>
<p>
Una volta verificati i requisiti e scompattato l'archivio la
procedura d'installazione è piuttosto semplice visto che segue i tre
@ -479,6 +481,14 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
degli appuntamenti previsti per la data odierna.</p>
<h3>4.2.2 Modalità interattiva<a name="basics_interface_interactive"></a></h3>
<div class="todo">
<p class="rq"><span class="valorise">Note:</span>
Key bindings that are indicated in this manual correspond to
the default ones, defined when <code>calcurse</code> is launched
for the first time. If those key bindings do not suit user's needs,
it is possible to change them within the keys configuration menu
(see <a href="#options_keys">key bindings</a>).</p>
</div>
<p>
Se viene avviato senza argomenti oppure solo con
l'opzione <code>'-c'</code> <code>calcurse</code> si avvia nella modalità
@ -605,6 +615,7 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
$HOME/.calcurse/
|___notes/
|___conf
|___keys
|___apts
|___todo
</pre>
@ -621,6 +632,9 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
<dt><code>conf</code>:</dt>
<dd>questo file contiene le configurazioni dell'utente</dd>
<dt><code>keys</code>:</dt>
<dd><span class="todo">this file contains the user-defined key bindings</span></dd>
<dt><code>apts</code>:</dt>
<dd>questo file contiene gli eventi e gli appuntamenti
dell'utente</dd>
@ -699,7 +713,10 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
è possibile scegliere la configurazione dell'interfaccia dello
schermo principale di <code>calcurse</code> (praticamente le posizioni relative
dei tre pannelli); premendo 'G' è possibile modificare alcune
opzioni generali; ed infine premendo 'N' è possibile modificare le
opzioni generali;
<span class="todo">pressing 'K' opens the key bindings configuration
menu,</span>
ed infine premendo 'N' è possibile modificare le
impostazioni della barra di notifica.
</p>
@ -787,8 +804,40 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
</dl>
<div class="todo">
<h2>5.2 Key bindings<a name="options_keys"></a></h2>
<p>
One can define it's own keybindings within the 'Keys' configuration
menu. The default keys look like the one used by the <code>vim</code>
editor, especially the displacement keys. Anyway, within this
configuration menu, users can redefine all of the keys available from
within calcurse's user interface.</p>
<p>
To define new keybindings, first highlight the action to which it will
apply. Then, delete the actual key binding if necessary, and add a new
one. You will then be asked to press the key corresponding to the new
binding. It is possible to define more than one key binding for a single
action.</p>
<p>
An automatic check is performed to see if the new key binding
is not already set for another action. In that case, you will be asked
to choose a different one. Another check is done when exiting from this
menu, to make sure all possible actions have a key associated with it.</p>
<p>
The following keys can be used to define bindings:
<ul>
<li>lower-case, upper-case letters and numbers, such as 'a', 'Z', '0'</li>
<li>CONTROL-key followed by one of the above letters</li>
<li>escape, horizontal tab, and space keys</li>
<li>arrow keys (up, down, left, and right)</li>
</ul> </p>
<p>
While inside the key configuration menu, an online help is available for
each one of the available actions. This help briefly describes what the
highlighted action is used for.</p>
</div>
<h2>5.2 Color themes<a name="options_colors"></a></h2>
<h2>5.3 Color themes<a name="options_colors"></a></h2>
<p>
Il tema del colore di <code>calcurse</code> può essere personalizzato a seconda
delle necessità dell'utente. Nella pagina di configurazione è
@ -820,7 +869,7 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
</p>
<h2>5.3 Configurazione del layout<a name="options_layout"></a></h2>
<h2>5.4 Configurazione del layout<a name="options_layout"></a></h2>
<p>
Il layout è la posizione dei pannelli all'interno dello schermo di
<code>calcurse</code>. Il layout predefinito è così disposto: il pannello del
@ -833,7 +882,7 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
<code>calcurse</code> a seconda delle necessità.
</p>
<h2>5.4 Impostazioni della barra delle notifiche<a name="options_notify"></a></h2>
<h2>5.5 Impostazioni della barra delle notifiche<a name="options_notify"></a></h2>
<p>
Le seguenti opzioni modificano il comportamento della barra delle
notifiche:
@ -1353,7 +1402,7 @@ d'ambiente<a name="basics_invocation_environment"></a></h3>
<div class="footer">
Copyright (c) 2004-2008 Fr&eacute;d&eacute;ric Culot<br>
Calcurse version 2.3 - Last change: September 21, 2008<br>
Calcurse version 2.4 - Last change: December 09, 2008<br>
</div>
</div>

75
doc/manual_nl.html
View File

@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//NL">
<!--
/*
* $calcurse: manual_nl.html,v 1.13 2008/10/15 16:15:40 culot Exp $
* $calcurse: manual_nl.html,v 1.14 2008/12/09 21:09:17 culot Exp $
*
* Calcurse - text-based organizer
* Copyright (c) 2004-2008 Frederic Culot
@ -94,9 +94,10 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
<li><a href="#options">5. Opties</a>
<ul>
<li><a href="#options_general">5.1 Algemene opties</a></li>
<li><a href="#options_colors">5.2 Kleurenschema's</a></li>
<li><a href="#options_layout">5.3 Layout configuratie</a></li>
<li><a href="#options_notify">5.4 Informatiebalk instellingen</a></li>
<li><a href="#options_keys"><span class="todo">5.2 Key bindings</span></a>
<li><a href="#options_colors">5.3 Kleurenschema's</a></li>
<li><a href="#options_layout">5.4 Layout configuratie</a></li>
<li><a href="#options_notify">5.5 Informatiebalk instellingen</a></li>
</ul></li>
<li><a href="#known_bugs">6. Bekende bugs</a></li>
<li><a href="#bugs">7. Rapporteren bugs en aanmerkingen</a></li>
@ -182,8 +183,9 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
mogelijk. Dit betekent dat er een volledige hulp-functie is, en de
beschikbare acties altijd op het scherm staan in de statusbalk. De
gebruikers-interface is ook aan te passen, en men kan tussen
verschillende kleurenschema's en layout-combinaties kiezen. En als
laatste, is er het configurabele meldingssysteem, dat gebruikers
verschillende kleurenschema's en layout-combinaties kiezen.
<span class="todo">Key bindings are also configurable, to fit everyone's needs.</span>
En als laatste, is er het configurabele meldingssysteem, dat gebruikers
verwittigt van op handen zijnde afspraken.
</p>
@ -235,7 +237,7 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
<p>
Als eerste moet het volgende archief uitgepakt worden met gunzip en
untar:</p>
<pre>tar zxvf calcurse-2.3.tar.gz</pre>
<pre>tar zxvf calcurse-2.4.tar.gz</pre>
<p>
Zodra de benodigde pakketten ge&iuml;nstalleerd zijn en het archief
uitgepakt is, is de installatieprocedure vrij simpel, via de
@ -425,6 +427,14 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
weergegeven.</p>
<h3>4.2.2 Interactieve modus<a name="basics_interface_interactive"></a></h3>
<div class="todo">
<p class="rq"><span class="valorise">Note:</span>
Key bindings that are indicated in this manual correspond to
the default ones, defined when <code>calcurse</code> is launched
for the first time. If those key bindings do not suit user's needs,
it is possible to change them within the keys configuration menu
(see <a href="#options_keys">key bindings</a>).</p>
</div>
<p>
Als <code>calcurse</code> zonder opties of alleen met de
<code>-c</code> optie wordt aangeroepen, wordt <code>calcurse</code>
@ -546,6 +556,7 @@ besproken. Als laatste wordt zowel de procedure van het melden van fouten in
$HOME/.calcurse/
|___notes/
|___conf
|___keys
|___apts
|___todo
</pre>
@ -559,6 +570,8 @@ $HOME/.calcurse/
het corresponderende item.</dd>
<dt><code>conf</code>:</dt>
<dd>bevat de configuratie van de gebruiker.</dd>
<dt><code>keys</code>:</dt>
<dd><span class="todo">this file contains the user-defined key bindings</span></dd>
<dt><code>apts</code>:</dt
<dd>bevat alle gebeurtenissen en afspraken van de gebruiker.</dd>
<dt><code>todo</code>:</dt>
@ -632,12 +645,15 @@ $HOME/.calcurse/
<h1>5. Opties<a name="options"></a></h1>
<p>
Alle opties van <code>calcurse</code> zijn aan te passen vanuit het
Configuratie menu. Als je op 'C' drukt, kom je in een submenu met 4
Configuratie menu. Als je op 'C' drukt, kom je in een submenu met 5
keuzes: Druk opnieuw 'C' om naar de configuratie van de
kleurenschema's te gaan, druk op 'L' om naar de hoofdindeling van
<code>calcurse</code> te gaan (in andere woorden, waar de 3 panels op
het scherm komen), druk op 'G' om een aantal algemene opties in te
stellen, en als laatste kan de informatiebalk worden aangepast worden
stellen,
<span class="todo">pressing 'K' opens the key bindings configuration
menu,</span>
en als laatste kan de informatiebalk worden aangepast worden
met de toets 'N'.
</p>
@ -713,7 +729,40 @@ $HOME/.calcurse/
</dd>
</dl>
<h2>5.2 Kleurenschema's<a name="options_colors"></a></h2>
<div class="todo">
<h2>5.2 Key bindings<a name="options_keys"></a></h2>
<p>
One can define it's own keybindings within the 'Keys' configuration
menu. The default keys look like the one used by the <code>vim</code>
editor, especially the displacement keys. Anyway, within this
configuration menu, users can redefine all of the keys available from
within calcurse's user interface.</p>
<p>
To define new keybindings, first highlight the action to which it will
apply. Then, delete the actual key binding if necessary, and add a new
one. You will then be asked to press the key corresponding to the new
binding. It is possible to define more than one key binding for a single
action.</p>
<p>
An automatic check is performed to see if the new key binding
is not already set for another action. In that case, you will be asked
to choose a different one. Another check is done when exiting from this
menu, to make sure all possible actions have a key associated with it.</p>
<p>
The following keys can be used to define bindings:
<ul>
<li>lower-case, upper-case letters and numbers, such as 'a', 'Z', '0'</li>
<li>CONTROL-key followed by one of the above letters</li>
<li>escape, horizontal tab, and space keys</li>
<li>arrow keys (up, down, left, and right)</li>
</ul> </p>
<p>
While inside the key configuration menu, an online help is available for
each one of the available actions. This help briefly describes what the
highlighted action is used for.</p>
</div>
<h2>5.3 Kleurenschema's<a name="options_colors"></a></h2>
<p>
De kleurenschema's van <code>calcurse</code> zijn aan te passen aan de
wensen van de gebruiker. Om het standaard schema te wijzigen, zijn er
@ -740,7 +789,7 @@ $HOME/.calcurse/
(zoals bijvoorbeeld <span class="emp">xterm-xfree86</span>)
</p>
<h2>5.3 Layout configuratie<a name="options_layout"></a></h2>
<h2>5.4 Layout configuratie<a name="options_layout"></a></h2>
<p>
De layout stelt de positie van de panels van <code>calcurse</code> in.
Bij de standaard layout is de positie van het kalender panel in de
@ -752,7 +801,7 @@ $HOME/.calcurse/
gebruiker <code>calcurse</code> zo het beste aan zijn behoeftes
aanpassen.</p>
<h2>5.4 Informatiebalk instellingen<a name="options_notify"></a></h2>
<h2>5.5 Informatiebalk instellingen<a name="options_notify"></a></h2>
<p>
De volgende opties stelt het gedrag van de informatiebalk in:</p>
<dl>
@ -1117,7 +1166,7 @@ msgid ""
<div class="footer">
Copyright (c) 2004-2008 Frédéric Culot<br>
Calcurse version 2.3 - Last change: September 21, 2008<br>
Calcurse version 2.4 - Last change: December 09, 2008<br>
</div>
</div>

15
src/calcurse.1
View File

@ -1,4 +1,4 @@
.\" $calcurse: calcurse.1,v 1.11 2008/09/21 14:09:00 culot Exp $
.\" $calcurse: calcurse.1,v 1.12 2008/12/09 21:09:17 culot Exp $
.\"
.\" Copyright (c) 2004-2008 Frederic Culot
.\"
@ -18,7 +18,7 @@
.\" Boston, MA 02111-1307, USA.
.\"
.fam C
.TH CALCURSE 1 "September 21, 2008" "Version 2.3" "Calcurse Manual"
.TH CALCURSE 1 "December 09, 2008" "Version 2.4" "Calcurse Manual"
.SH NAME
Calcurse \- text-based organizer
.SH SYNOPSIS
@ -139,10 +139,10 @@ key. Once viewing the help screens, informations on a specific command
can be accessed by pressing the keystroke corresponding to that command.
.SH CONFIGURATION
The calcurse options can be changed from the configuration menu (shown
when 'C' is hit). Four possible categories are to be chosen from : the
when 'C' is hit). Five possible categories are to be chosen from : the
color scheme, the layout (the location of the three panels on the
screen), notification options, and more general options (such as automatic
save before quitting).
screen), notification options, key bindings configuration menu,
and more general options (such as automatic save before quitting).
All of these options are detailed in the configuration menu.
.SH FILES
The following structure is created in your $HOME directory
@ -156,6 +156,8 @@ $HOME/.calcurse/
.br
|___conf
.br
|___keys
.br
|___apts
.br
|___todo
@ -165,7 +167,8 @@ which are attached to appointments, events or todos. One text file is
created per note, whose name is built using mkstemp(3) and should be
unique, but with no relation with the corresponding item's description.
.br
The \fIconf\fP file contains the user configuration. The \fIapts\fP
The \fIconf\fP file contains the user configuration. The \fIkeys\fP
file contains the user-defined key bindings. The \fIapts\fP
file contains all of the user's appointments and events, and the
\fItodo\fP file contains the todo list.
.SH ENVIRONMENT