diff options
author | Frederic Culot <calcurse@culot.org> | 2006-09-18 14:22:44 +0000 |
---|---|---|
committer | Frederic Culot <calcurse@culot.org> | 2006-09-18 14:22:44 +0000 |
commit | 184a2e6d54ca0f1e2661451d2c1cf1b39a629e0b (patch) | |
tree | a54798cf2667d966d04ac64078a96e2b163703be | |
parent | ab1b7eacd7043d5ea5bb0d4c58cd1c9a371c21e4 (diff) | |
download | calcurse-184a2e6d54ca0f1e2661451d2c1cf1b39a629e0b.zip |
explanations concerning the notify-bar added
-rwxr-xr-x | doc/manual_en.html | 83 |
1 files changed, 66 insertions, 17 deletions
diff --git a/doc/manual_en.html b/doc/manual_en.html index 9a0bdb9..d92ffe1 100755 --- a/doc/manual_en.html +++ b/doc/manual_en.html @@ -1,7 +1,7 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!-- /* - * $calcurse: manual_en.html,v 1.3 2006/09/09 20:32:33 culot Exp $ + * $calcurse: manual_en.html,v 1.4 2006/09/18 14:22:44 culot Exp $ * * Calcurse - text-based organizer * Copyright (c) 2004-2006 Frederic Culot @@ -75,6 +75,7 @@ <li><a href="#options_general">General options</a> <li><a href="#options_colors">Color themes</a> <li><a href="#options_layout">Layout configuration</a> +<li><a href="#options_notify">Notify-bar settings</a> </ul> <li><a href="#known_bugs">Known bugs</a> <li><a href="#bugs">Reporting bugs and feedback</a> @@ -205,7 +206,7 @@ <p> First you need to gunzip and untar the source archive: <pre> - tar zxvf calcurse-1.5.tar.gz + tar zxvf calcurse-1.6.tar.gz </pre> Once you meet the requirements and have extracted the archive, the install process is quite simple, and follows the standard @@ -264,6 +265,10 @@ Print a short help text describing the supported command-line options, and exit.<br> <br> + <dt><code>-n</code> + <dd> + Print the next appointment within next 24 hours and exit.<br> + <br> <dt><code>-t</code> <dd> Print the 'todo' list and exit.<br> @@ -294,14 +299,23 @@ </pre> where <em>fr_FR</em> is the locale name in this exemple, but should be replaced by the locale corresponding to the desired - language. + language.<br> + You should also specify the charset to be used, because in some + cases the accents and such are not displayed correctly. + This charset is indicated at the beginning of the po file + corresponding to the desired language. For instance, you can see + in the fr.po file that it uses the iso-8859-1 charset, so you + could run <code>calcurse</code> using the following command: + <pre> + LC_ALL=fr_FR.ISO8859-1 calcurse + </pre> <a name="basics_interface"></a><h2>User interface</h2> <a name="basics_interface_noninteractive"></a><h3>Non-interactive mode</h3> <p> When called with at least one of the following arguments:<br> - <code>-a</code>, <code>-d</code>, <code>-t</code>, - <code>-h</code>, <code>-v</code><br> + <code>-a</code>, <code>-d</code>, <code>-h</code>, + <code>-n</code>, <code>-t</code>, <code>-v</code><br> <code>calcurse</code> is started in non-interactive mode. This means the desired information will be displayed, and after that, <code>calcurse</code> simply quits and you are @@ -317,7 +331,8 @@ <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 - the 'TAB' key, plus a status bar (see figure below). + the 'TAB' key, plus a notification bar and a status bar + (see figure below). <pre> appointment panel---. .---calendar panel @@ -340,13 +355,13 @@ | ||----------------------------| panel | || | | | || | | - | || |<--. - | || | - | || | + | || |<--. | || | +------------------------------------++----------------------------+ + |---[ Mon 2006-11-22 | 10:11:43 ]---(apts)----> 01:20 :: lunch <---|<--. + +------------------------------------------------------------------+ notify-bar | ? Help R Redraw H/L -/+1 Day G GoTo C Config | - | Q Quit S Save J/K -/+1 Week Tab Chg View |<-. + | Q Quit S Save J/K -/+1 Week Tab Chg View |<-. +------------------------------------------------------------------+ | | status bar @@ -356,9 +371,14 @@ a particular day, the second one contains the list of the events and appointments on that day, and the last one contains a list of tasks to do but which are not assigned to any specific day. - In the bottom line of the screen there is a status bar, which + At the very bottom of the screen there is a status bar, which indicates the possible actions and the corresponding keystrokes. - + Just above this status bar is the notify-bar, which indicates + from left to right : the current date, the current time, the + calendar file currently in use (apts on the above example, which + is the default calendar file, see the following section), and + the next appointment within the upcoming 24 hours. Here it says + that it will be lunch time in one hour and twenty minutes. <a name="basics_files"></a><h2><code>calcurse</code> files</h2> <p> @@ -387,12 +407,13 @@ <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 three possible choices : pressing 'C' + driven to a submenu with four 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), and last you can choose between - different general options by pressing 'G'. + 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'. <a name="options_general"></a><h2>General options</h2> <p> @@ -479,6 +500,34 @@ his needs by placing the different panels where needed. +<a name="options_notify"></a><h2>Notify-bar settings</h2> +<p> + The following options are used to modify the notify-bar behavior: + <ul> + <li><code>notify-bar_show</code> (default: <em>yes</em>)<br> + This option indicates if you want the notify-bar to be displayed + or not.<br> + <br> + <li><code>notify-bar_date</code> (default: <em>%a %F</em>)<br> + 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 <tt>man 3 strftime</tt> + inside a terminal.<br> + <br> + <li><code>notify-bar_time</code> (default: <em>%T</em>)<br> + 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 <tt>man 3 strftime</tt> + inside a terminal.<br> + <br> + <li><code>notify-bar_warning</code> (default: <em>300</em>)<br> + When there is an appointment within the next 'notify-bar_warning' + seconds, the display of that appointment inside the notify-bar + starts to blink. That way, the user is warned and knows there + will be soon an upcoming appointment. + </ul> + + <a name="known_bugs"></a><h1>Known bugs</h1> <p> Incorrect highlighting of items appear when using calcurse @@ -678,7 +727,7 @@ give about the translations. You can either just give your name/nick, or add an email address, for exemple: <pre> - "Last-Translator: Frederic Culot <frederic@culot.org>\n" + "Last-Translator: Frederic Culot <frederic@culot.org>\n" </pre> <li><em>Comments</em><br> Adding comments (lines begining with the '#' character) can be @@ -778,7 +827,7 @@ <hr> <small><em> Copyright (c) 2004-2006 Frédéric Culot<br> -Calcurse version 1.5 - Last change: August 24, 2006 +Calcurse version 1.6 - Last change: September 18, 2006 <em></small> |