summaryrefslogtreecommitdiffstats
path: root/files/manual.chunked/ar01s05.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/manual.chunked/ar01s05.html')
-rw-r--r--files/manual.chunked/ar01s05.html108
1 files changed, 59 insertions, 49 deletions
diff --git a/files/manual.chunked/ar01s05.html b/files/manual.chunked/ar01s05.html
index b9090ca..9b741d8 100644
--- a/files/manual.chunked/ar01s05.html
+++ b/files/manual.chunked/ar01s05.html
@@ -1,71 +1,74 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5. Options</title><link rel="stylesheet" type="text/css" href="docbook-xsl.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="CALCURSE - text-based organizer" /><link rel="up" href="index.html" title="CALCURSE - text-based organizer" /><link rel="prev" href="ar01s04.html" title="4. calcurse basics" /><link rel="next" href="ar01s06.html" title="6. Known bugs" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><td width="20%" align="left"><a accesskey="p" href="ar01s04.html"><img src="images/icons/prev.png" alt="Prev" /></a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ar01s06.html"><img src="images/icons/next.png" alt="Next" /></a></td></tr></table><hr /></div><div class="section" title="5. Options"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_options"></a>5. Options</h2></div></div></div><p>All of the <code class="literal">calcurse</code> parameters are configurable from the Configuration menu
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5. Options</title><link rel="stylesheet" type="text/css" href="docbook-xsl.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.77.1" /><link rel="home" href="index.html" title="CALCURSE - text-based organizer" /><link rel="up" href="index.html" title="CALCURSE - text-based organizer" /><link rel="prev" href="ar01s04.html" title="4. calcurse basics" /><link rel="next" href="ar01s06.html" title="6. Known bugs" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><td width="20%" align="left"><a accesskey="p" href="ar01s04.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ar01s06.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_options"></a>5. Options</h2></div></div></div><p>All of the <code class="literal">calcurse</code> parameters are configurable from the Configuration menu
available when pressing <code class="literal">C</code>. You are then driven to a submenu with five
possible choices : pressing <code class="literal">C</code> again will lead you to the Color scheme
configuration, pressing <code class="literal">L</code> allows you to choose the layout of the main
<code class="literal">calcurse</code> screen (in other words, where to put the three different panels on
screen), pressing <code class="literal">G</code> permits you to choose between different general options,
pressing <code class="literal">K</code> opens the key bindings configuration menu, and last you can modify
-the notify-bar settings by pressing <code class="literal">N</code>.</p><div class="section" title="5.1. General options"><div class="titlepage"><div><div><h3 class="title"><a id="options_general"></a>5.1. General options</h3></div></div></div><p>These options control <code class="literal">calcurse</code> general behavior, as described below:</p><div class="variablelist"><dl><dt><span class="term">
-<code class="literal">auto_save</code> (default: <span class="strong"><strong>yes</strong></span>)
+the notify-bar settings by pressing <code class="literal">N</code>.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="options_general"></a>5.1. General options</h3></div></div></div><p>These options control <code class="literal">calcurse</code> general behavior, as described below:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
+<code class="literal">general.autosave</code> (default: <span class="strong"><strong>yes</strong></span>)
</span></dt><dd>
This option allows to automatically save the user’s data (if set to <span class="strong"><strong>yes</strong></span>)
when quitting. &lt;p class="rq"&gt;&lt;span class="valorise"&gt;warning:&lt;/span&gt; No data
- will be automatically saved if <code class="literal">auto_save</code> is set to <span class="strong"><strong>no</strong></span>. This means the
- user must press <code class="literal">S</code> (for saving) in order to retrieve its modifications.
+ will be automatically saved if <code class="literal">general.autosave</code> is set to <span class="strong"><strong>no</strong></span>. This means
+ the user must press <code class="literal">S</code> (for saving) in order to retrieve its modifications.
</dd><dt><span class="term">
-<code class="literal">periodic_save</code> (default: <span class="strong"><strong>0</strong></span>)
+<code class="literal">general.autogc</code> (default: <span class="strong"><strong>no</strong></span>)
+</span></dt><dd>
+ Automatically run the garbage collector for note files when quitting.
+</dd><dt><span class="term">
+<code class="literal">general.periodicsave</code> (default: <span class="strong"><strong>0</strong></span>)
</span></dt><dd>
If different from <code class="literal">0</code>, user’s data will be automatically saved every
- <span class="strong"><strong>periodic_save</strong></span> minutes. When an automatic save is performed, two asterisks
- (i.e. <code class="literal">**</code>) will appear on the top right-hand side of the screen).
+ <span class="strong"><strong>general.periodicsave</strong></span> minutes. When an automatic save is performed, two
+ asterisks (i.e. <code class="literal">**</code>) will appear on the top right-hand side of the screen).
</dd><dt><span class="term">
-<code class="literal">confirm_quit</code> (default: <span class="strong"><strong>yes</strong></span>)
+<code class="literal">general.confirmquit</code> (default: <span class="strong"><strong>yes</strong></span>)
</span></dt><dd>
If set to <span class="strong"><strong>yes</strong></span>, confirmation is required before quitting, otherwise pressing
<code class="literal">Q</code> will cause <code class="literal">calcurse</code> to quit without prompting for user confirmation.
</dd><dt><span class="term">
-<code class="literal">confirm_delete</code> (default: <span class="strong"><strong>yes</strong></span>)
+<code class="literal">general.confirmdelete</code> (default: <span class="strong"><strong>yes</strong></span>)
</span></dt><dd>
If this option is set to <span class="strong"><strong>yes</strong></span>, pressing <code class="literal">D</code> for deleting an item (either a
<span class="strong"><strong>todo</strong></span>, <span class="strong"><strong>appointment</strong></span>, or <span class="strong"><strong>event</strong></span>), will lead to a prompt asking for user
confirmation before removing the selected item from the list. Otherwise, no
confirmation will be needed before deleting the item.
</dd><dt><span class="term">
-<code class="literal">skip_system_dialogs</code> (default: <span class="strong"><strong>no</strong></span>)
+<code class="literal">general.systemdialogs</code> (default: <span class="strong"><strong>yes</strong></span>)
</span></dt><dd>
- Setting this option to <span class="strong"><strong>yes</strong></span> will result in skipping the system dialogs
+ Setting this option to <span class="strong"><strong>no</strong></span> will result in skipping the system dialogs
related to the saving and loading of data. This can be useful to speed up
the input/output processes.
</dd><dt><span class="term">
-<code class="literal">skip_progress_bar</code> (default: <span class="strong"><strong>no</strong></span>)
+<code class="literal">general.progressbar</code> (default: <span class="strong"><strong>yes</strong></span>)
</span></dt><dd>
- If set to <span class="strong"><strong>yes</strong></span>, this will cause the disappearing of the progress bar which
- is usually shown when saving data to file. If set to <span class="strong"><strong>no</strong></span>, this bar will be
+ If set to <span class="strong"><strong>no</strong></span>, this will cause the disappearing of the progress bar which is
+ usually shown when saving data to file. If set to <span class="strong"><strong>yes</strong></span>, this bar will be
displayed, together with the name of the file being saved (see section
<a class="link" href="ar01s04.html#basics_files" title="4.4. calcurse files">calcurse files</a>).
</dd><dt><span class="term">
-<code class="literal">calendar_default_view</code> (default: <span class="strong"><strong>0</strong></span>)
+<code class="literal">appearance.calendarview</code> (default: <span class="strong"><strong>0</strong></span>)
</span></dt><dd>
If set to <code class="literal">0</code>, the monthly calendar view will be displayed by default
otherwise it is the weekly view that will be displayed.
</dd><dt><span class="term">
-<code class="literal">week_begins_on_monday</code> (default: <span class="strong"><strong>yes</strong></span>)
+<code class="literal">general.firstdayofweek</code> (default: <span class="strong"><strong>monday</strong></span>)
</span></dt><dd>
- One can choose between Monday and Sunday as the first day of the week. If the
- option <code class="literal">week_begins_on_monday</code> is set to <span class="strong"><strong>yes</strong></span>, Monday will be first in the
- calendar view. Else if the option is set to <span class="strong"><strong>no</strong></span>, then Sunday will be the
- first day of the week.
+ One can choose between Monday and Sunday as the first day of the week. If
+ <code class="literal">general.firstdayofweek</code> is set to <span class="strong"><strong>monday</strong></span>, Monday will be first in the
+ calendar view. Otherwise, Sunday will be the first day of the week.
</dd><dt><span class="term">
-<code class="literal">output_datefmt</code> (default: <span class="strong"><strong>%D</strong></span>)
+<code class="literal">format.outputdate</code> (default: <span class="strong"><strong>%D</strong></span>)
</span></dt><dd>
This option indicates the format to be used when displaying dates in
non-interactive mode. Using the default values, dates are displayed the
following way: <span class="strong"><strong>mm/dd/aa</strong></span>. You can see all of the possible formats by typing
<code class="literal">man 3 strftime</code> inside a terminal.
</dd><dt><span class="term">
-<code class="literal">input_datefmt</code> (default: <span class="strong"><strong>1</strong></span>)
+<code class="literal">format.inputdate</code> (default: <span class="strong"><strong>1</strong></span>)
</span></dt><dd><p class="simpara">
This option indicates the format that will be used to enter dates in
<span class="strong"><strong>calcurse</strong></span>. Four choices are available:
@@ -77,16 +80,16 @@ dd/mm/yyyy
yyyy/mm/dd
</li><li class="listitem">
yyyy-mm-dd
-</li></ol></div></dd></dl></div></div><div class="section" title="5.2. Key bindings"><div class="titlepage"><div><div><h3 class="title"><a id="options_keys"></a>5.2. Key bindings</h3></div></div></div><p>One can define it’s own keybindings within the <code class="literal">Keys</code> configuration menu. The
+</li></ol></div></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="options_keys"></a>5.2. Key bindings</h3></div></div></div><p>One can define ones own key bindings within the <code class="literal">Keys</code> configuration menu. The
default keys look like the one used by the <code class="literal">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.
+all of the keys available from within calcurse’s user interface.</p><p>To define new key bindings, 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:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+possible actions have a key associated with it.</p><p>The following keys can be used to define bindings:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
lower-case, upper-case letters and numbers, such as <code class="literal">a</code>, <code class="literal">Z</code>, <code class="literal">0</code>
</li><li class="listitem">
CONTROL-key followed by one of the above letters
@@ -98,7 +101,9 @@ arrow keys (up, down, left, and right)
<code class="literal">HOME</code> and <code class="literal">END</code> keys
</li></ul></div><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><div class="section" title="5.3. Color themes"><div class="titlepage"><div><div><h3 class="title"><a id="_color_themes"></a>5.3. Color themes</h3></div></div></div><p><code class="literal">calcurse</code> color theme can be customized to suit user’s needs. To change the
+action is used for.</p><div class="note" style="margin-left: 0; margin-right: 10%;"><h3 class="title">Note</h3><p>As of calcurse 3.0.0, displacement commands can be preceded by an
+ optional number to repeat the command. For example, <code class="literal">10k</code> will move the
+ cursor ten weeks forwards if you use default key bindings.</p></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_color_themes"></a>5.3. Color themes</h3></div></div></div><p><code class="literal">calcurse</code> color theme can be customized to suit user’s needs. To change the
default theme, the configuration page displays possible choices for foreground
and background colors. Using arrows or calcurse displacement keys to move, and
<code class="literal">X</code> or space to select a color, user can preview the theme which will be
@@ -106,55 +111,55 @@ applied. It is possible to keep the terminal’s default colors by selecting th
corresponding choice in the list.</p><p>The chosen color theme will then be applied to the panel borders, to the
titles, to the keystrokes, and to general informations displayed inside status
bar. A black and white theme is also available, in order to support non-color
-terminals.</p><div class="note" title="Note" style="margin-left: 0; margin-right: 10%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/icons/note.png" /></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>Depending on your terminal type and on the value of the <code class="literal">$TERM</code>
- environnement variable, color could or could not be supported. An error
+terminals.</p><div class="note" style="margin-left: 0; margin-right: 10%;"><h3 class="title">Note</h3><p>Depending on your terminal type and on the value of the <code class="literal">$TERM</code>
+ environment variable, color could or could not be supported. An error
message will appear if you try to change colors whereas your terminal
does not support this feature. If you do know your terminal supports
colors but could not get <code class="literal">calcurse</code> to display them, try to set your
- <code class="literal">$TERM</code> variable to another value (such as <span class="strong"><strong>xterm-xfree86</strong></span> for instance).</p></td></tr></table></div></div><div class="section" title="5.4. Layout configuration"><div class="titlepage"><div><div><h3 class="title"><a id="_layout_configuration"></a>5.4. Layout configuration</h3></div></div></div><p>The layout corresponds to the position of the panels inside <code class="literal">calcurse</code> screen.
+ <code class="literal">$TERM</code> variable to another value (such as <span class="strong"><strong>xterm-xfree86</strong></span> for instance).</p></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_layout_configuration"></a>5.4. Layout configuration</h3></div></div></div><p>The layout corresponds to the position of the panels inside <code class="literal">calcurse</code> screen.
The default layout makes the calendar panel to be displayed on the top-right
corner of the terminal, the todo panel on the bottom-right corner, while the
appointment panel is displayed on the left hand-side of the screen (see the
figure in section <a class="link" href="ar01s04.html#basics_interface_interactive" title="Interactive mode">Interactive mode</a> for an
-exemple of the default layout). By choosing another layout in the
-configuration screen, user can customize <code class="literal">calcurse</code> appearence to best suit his
-needs by placing the different panels where needed.</p><p>The following option is used to modify the layout configuration:</p><div class="variablelist"><dl><dt><span class="term">
-<code class="literal">layout</code> (default: <span class="strong"><strong>0</strong></span>)
+example of the default layout). By choosing another layout in the
+configuration screen, user can customize <code class="literal">calcurse</code> appearance to best suit his
+needs by placing the different panels where needed.</p><p>The following option is used to modify the layout configuration:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
+<code class="literal">appearance.layout</code> (default: <span class="strong"><strong>0</strong></span>)
</span></dt><dd>
Eight different layouts are to be chosen from (see layout configuration
screen for the description of the available layouts).
-</dd></dl></div></div><div class="section" title="5.5. Sidebar configuration"><div class="titlepage"><div><div><h3 class="title"><a id="_sidebar_configuration"></a>5.5. Sidebar configuration</h3></div></div></div><p>The sidebar is the part of the screen which contains two panels: the calendar
+</dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_sidebar_configuration"></a>5.5. Sidebar configuration</h3></div></div></div><p>The sidebar is the part of the screen which contains two panels: the calendar
and, depending on the chosen layout, either the todo list or the appointment
-list.</p><p>The following option is used to change the width of the sidebar:</p><div class="variablelist"><dl><dt><span class="term">
-<code class="literal">side-bar_width</code> (default: <span class="strong"><strong>0</strong></span>)
+list.</p><p>The following option is used to change the width of the sidebar:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
+<code class="literal">appearance.sidebarwidth</code> (default: <span class="strong"><strong>0</strong></span>)
</span></dt><dd>
Width (in percentage, 0 being the minimum width) of the side bar.
-</dd></dl></div></div><div class="section" title="5.6. Notify-bar settings"><div class="titlepage"><div><div><h3 class="title"><a id="options_notify"></a>5.6. Notify-bar settings</h3></div></div></div><p>The following options are used to modify the notify-bar behavior:</p><div class="variablelist"><dl><dt><span class="term">
-<code class="literal">notify-bar_show</code> (default: <span class="strong"><strong>yes</strong></span>)
+</dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="options_notify"></a>5.6. Notify-bar settings</h3></div></div></div><p>The following options are used to modify the notify-bar behavior:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
+<code class="literal">appearance.notifybar</code> (default: <span class="strong"><strong>yes</strong></span>)
</span></dt><dd>
This option indicates if you want the notify-bar to be displayed or not.
</dd><dt><span class="term">
-<code class="literal">notify-bar_date</code> (default: <span class="strong"><strong>%a %F</strong></span>)
+<code class="literal">format.notifydate</code> (default: <span class="strong"><strong>%a %F</strong></span>)
</span></dt><dd>
With this option, you can specify the format to be used to display the
current date inside the notification bar. You can see all of the possible
formats by typing <code class="literal">man 3 strftime</code> inside a terminal.
</dd><dt><span class="term">
-<code class="literal">notify-bar_time</code> (default: <span class="strong"><strong>%T</strong></span>)
+<code class="literal">format.notifytime</code> (default: <span class="strong"><strong>%T</strong></span>)
</span></dt><dd>
With this option, you can specify the format to be used to display the
current time inside the notification bar. You can see all of the possible
formats by typing <code class="literal">man 3 strftime</code> inside a terminal.
</dd><dt><span class="term">
-<code class="literal">notify-bar_warning</code> (default: <span class="strong"><strong>300</strong></span>)
+<code class="literal">notification.warning</code> (default: <span class="strong"><strong>300</strong></span>)
</span></dt><dd>
When there is an appointment which is flagged as <code class="literal">important</code> within the next
- <code class="literal">notify-bar_warning</code> seconds, the display of that appointment inside the
- notify-bar starts to blink. Moreover, the command defined by the
- <code class="literal">notify-bar_command</code> option will be launched. That way, the user is warned
+ <code class="literal">notification.warning</code> seconds, the display of that appointment inside the
+ notify-bar starts to blink. Moreover, the command defined by the
+ <code class="literal">notification.command</code> option will be launched. That way, the user is warned
and knows there will be soon an upcoming appointment.
</dd><dt><span class="term">
-<code class="literal">notify-bar_command</code> (default: <span class="strong"><strong>printf <span class="emphasis"><em>\a</em></span></strong></span>)
+<code class="literal">notification.command</code> (default: <span class="strong"><strong>printf <span class="emphasis"><em>\a</em></span></strong></span>)
</span></dt><dd><p class="simpara">
This option indicates which command is to be launched when there is an
upcoming appointment flagged as <code class="literal">important</code>. This command will be passed to
@@ -164,15 +169,20 @@ list.</p><p>The following option is used to change the width of the sidebar:</p>
</p><div class="informalexample"><p>Say the <code class="literal">mail</code> command is available on the user’s system, one can use the
following command to get notified by mail of an upcoming appointment (the
appointment description will also be mentioned in the mail body):</p><pre class="screen">$ calcurse --next | mail -s "[calcurse] upcoming appointment!" user@host.com</pre></div></dd><dt><span class="term">
-<code class="literal">notify-daemon_enable</code> (default: <span class="strong"><strong>no</strong></span>)
+<code class="literal">notification.notifyall</code> (default: <span class="strong"><strong>no</strong></span>)
+</span></dt><dd>
+ Invert the sense of flagging an appointment as <code class="literal">important</code>. If this is
+ enabled, all appointments will be notified - except for flagged ones.
+</dd><dt><span class="term">
+<code class="literal">daemon.enable</code> (default: <span class="strong"><strong>no</strong></span>)
</span></dt><dd>
If set to yes, daemon mode will be enabled, meaning <code class="literal">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 class="link" href="ar01s04.html#basics_daemon" title="4.3. Background mode">Background mode</a>.
</dd><dt><span class="term">
-<code class="literal">notify-daemon_log</code> (default: <span class="strong"><strong>no</strong></span>)
+<code class="literal">daemon.log</code> (default: <span class="strong"><strong>no</strong></span>)
</span></dt><dd>
If set to yes, <code class="literal">calcurse</code> daemon activity will be logged (see section
<a class="link" href="ar01s04.html#basics_files" title="4.4. calcurse files">files</a>).
-</dd></dl></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ar01s04.html"><img src="images/icons/prev.png" alt="Prev" /></a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ar01s06.html"><img src="images/icons/next.png" alt="Next" /></a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"><a accesskey="h" href="index.html"><img src="images/icons/home.png" alt="Home" /></a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
+</dd></dl></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ar01s04.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ar01s06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>