From cf5ae67eb832aecc8f90ed3173cdd0da56184590 Mon Sep 17 00:00:00 2001
From: Frederic Culot <calcurse@culot.org>
Date: Wed, 13 Dec 2006 09:30:11 +0000
Subject: documentation added about the built-in input line editor

---
 doc/manual_en.html | 30 ++++++++++++++++++++++++++----
 doc/manual_fr.html | 31 ++++++++++++++++++++++++++++---
 2 files changed, 54 insertions(+), 7 deletions(-)
diff --git a/doc/manual_en.html b/doc/manual_en.html
index e5e5022..b4aabe6 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.5 2006/12/12 14:18:21 culot Exp $
+ *	$calcurse: manual_en.html,v 1.6 2006/12/13 09:30:11 culot Exp $
  *
  * Calcurse - text-based organizer
  * Copyright (c) 2004-2006 Frederic Culot
@@ -377,18 +377,40 @@
                                                                  status bar
 
         </pre>
-        The first panel represents a calendar which allows to highligth 
+        The first panel represents a calendar which allows to highlight 
         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.  
+        of tasks to do but which are not assigned to any specific day.<br>
 	At the very bottom of the screen there is a status bar, which 
-	indicates the possible actions and the corresponding keystrokes.
+	indicates the possible actions and the corresponding keystrokes.<br>
         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.
+	<p>
+	<u>Note:</u> Some actions, such as editing or adding an item,
+	require to type in some text. This is done with the help of 
+	the built-in input line editor.<br>
+	Within this editor, if a line is longer than the screen width,
+	a '&gt;', '*', or '&lt;' character is displayed in the last
+	column indicating that there are more character after, before and 
+	after, or before the current position, respectively. The line is
+	scrolled horizontally as necessary.<br>
+	Moreover, some editing commands are bound to particular control
+	characters. Hereafter are indicated the available editing commands
+	('^' stands for the control key):<br>
+	<ul>
+	<li><b>^a</b>: moves the cursor to the beginning of the input line
+	<li><b>^b</b>: moves the cursor backward
+	<li><b>^d</b>: deletes one character forward
+	<li><b>^e</b>: moves the cursor to the end of the input line
+	<li><b>^f</b>: moves the cursor forward
+	<li><b>^h</b>: deletes one character backward
+	<li><b>^k</b>: deletes the input from the cursor to the end of the line
+	<li><b>ESCAPE</b>: cancels the editing
+	</ul> 	
 
 <a name="basics_files"></a><h2><code>calcurse</code> files</h2>
 <p>
diff --git a/doc/manual_fr.html b/doc/manual_fr.html
index c2e0f90..e07a081 100755
--- a/doc/manual_fr.html
+++ b/doc/manual_fr.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <!--
 /*
- *	$calcurse: manual_fr.html,v 1.5 2006/12/12 14:18:06 culot Exp $
+ *	$calcurse: manual_fr.html,v 1.6 2006/12/13 09:30:30 culot Exp $
  *
  * Calcurse - text-based organizer
  * Copyright (c) 2004-2006 Frederic Culot
@@ -416,10 +416,10 @@ pour l'i18n</h3>
         s&eacute;lectionner un jour en particulier. Le second panneau contient
         une liste d'&eacute;v&egrave;nements et les rendez-vous du jour, et le dernier
         contient une liste des t&acirc;ches &agrave; faire, mais qui ne sont pas
-        assign&eacute;e &agrave; une journ&eacute;e en particulier.
+        assign&eacute;e &agrave; une journ&eacute;e en particulier.<br>
         Tout en bas de l'&eacute;cran on retrouve une barre de status, qui indique
         les actions possibles en fonction du contexte, ainsi que la
-        touche qui doit &ecirc;tre press&eacute;e pour effectuer cette action.
+        touche qui doit &ecirc;tre press&eacute;e pour effectuer cette action.<br>
 	Juste au dessus de cette barre se trouve la barre de notification, qui
 	indique les informations suivantes, de gauche à droite : la date du jour,
 	l'heure courante, le fichier calendrier actuellement ouvert (il s'agit
@@ -427,6 +427,31 @@ pour l'i18n</h3>
 	dans la section suivante), et le premier rendez-vous programmé dans les 
 	prochaines 24 heures. Dans cet exemple, il s'agit d'un dîner qui aura lieu
 	dans une heure et vingt minutes.
+	<p>
+	<u>Remarque:</u> Certaines actions, comme editer ou ajouter un
+	el&eacute;ment, n&eacute;cessitent de renseigner du texte par 
+	l'interm&eacute;diaire de l'&eacute;diteur de ligne de commande
+	fournit avec <code>calcurse</code>.<br>
+	Dans cet &eacute;diteur, si la ligne de commande est plus longue que la 
+	largeur de l'&eacute;cran, le caract&egrave;re '&gt;', '*', ou '&lt;'
+	sera rajout&eacute; dans la derni&egrave;re colonne si il reste du texte
+	apr&egrave;s, avant et apr&egrave;s, ou avant la position courante,
+	respectivement. La ligne d&eacute;file horizontalement si
+	n&eacute;cessaire.<br>
+	De plus, il existe des combinaisons de touches pour
+	effectuer certaines actions courantes utiles lors de l'&eacute;dition
+	de textes. Voici ces raccourcis:<br>
+	<ul>
+	<li><b>^a</b>: d&eacute;placer le curseur au d&eacute;but de la ligne
+	<li><b>^b</b>: d&eacute;placer le curseur d'une position en arri&egrave;re
+	<li><b>^d</b>: effacer le caract&egrave;re suivant
+	<li><b>^e</b>: d&eacute;placer le curseur en fin de ligne
+	<li><b>^f</b>: d&eacute;placer le curseur d'une position en avant
+	<li><b>^h</b>: effacer le caract&egrave;re pr&eacute;c&eacute;dent
+	<li><b>^k</b>: effacer le texte depuis la position courante
+	jusqu'&agrave; la fin de la ligne
+	<li><b>ESCAPE</b>: annuler l'&eacute;dition du texte courant
+	</ul>
 
 <a name="basics_files"></a><h2>Fichiers</h2>
 <p>
-- 
cgit v1.2.3-54-g00ecf

