mise a jour

mise à jour de l'aide

help/Help_0

@@ -4,17 +4,22 @@
 	Pr�sentation de flrn
 	--------------------
 
-Flrn est un super-programme m�ga-torche pour lire les news, locales ou
-ext�rieures.
-Son seul bug officiel est d'�tre en fran�ais. Mais c'est promis, un jour je
-le traduis en russe.
+  flrn est un lecteur de groupe de discussions (news) similaire � trn
+ou slrn. D�velopp� � l'�cole Normale Sup�rieure (en France), sa
+langue originale est le fran�ais (m�me si certaines commandes porte
+un nom anglais), mais des traductions sont en cours.
+  flrn se veut relativement puissant et configurable, tout en restant
+r�solument en mode texte. Il fonctionne exclusivement sous Unix
+avec la biblioth�que s-lang.
 
-Pour l'instant, c'est moi <[email protected]> et Jo 
-<[email protected]> qui travaillons dessus. Pour toute suggestion 
-ou bug-report, envoyez-nous un mail, nous serons ravis de (mal) satisfaire 
-votre demande.
+  flrn a �t� �crit initialement par Jo�l-Yann Fourr� et Damien Mass�.
+Ce dernier en reste le d�veloppeur principal, profitant de l'aide
+ponctuelle de contributeurs occasionnels.
 
-	Damien
+  Les commentaires sur flrn peuvent �tre envoy�s � l'adresse
+[email protected] pour joindre l'�quipe de d�veloppement de
+flrn, ou [email protected] pour une liste plus large.
 
+--------
 'q' permet de quitter l'aide � tout moment.
-'m' permet de revenir au menu
+'m' permet de revenir au menu de l'aide

help/Help_1

@@ -1,106 +1,154 @@
 1: commandes simples
 
-Les paragraphes en retrait sont des descriptions plus d�taill�es qui peuvent
-�tre ignor�es.
-
-        flrn : commandes de bases
-        -------------------------
-
-	Syntaxe g�n�rale des commande
-	-----------------------------
-
-Les commandes sont utilisables soit en tapant leur nom :
-"\goto" ou en utilisant une touche sur laquelle elles sont bind�es, comme 'g'.
-
-  Quand on tappe leur nom, il y a une completion automatique obtenue avec
-  <tab>. On peut appuyer plusieurs fois de suite sur la touche pour voir
-  les diff�rentes possibilit�s que propose flrn.
-
-Certaines commandes prennent une cha�ne de caract�res en argument. On peut la
-mettre directement si l'on utilise la premi�re forme : "\goto flrn".
-
-  Enfin, on peut taper avant toutes les commandes un pr�fixe d�crivant les
-  articles auxquels elle doit s'appliquer (la s�mantique varie un peu pour
-  certaines commandes particuli�res). La forme g�n�rale de ce pr�fixe est :
-  elem_1,elem_2...
-  o� chaque �l�ment peut �tre un num�ro (15), une suite de num�ro (10-20),
-  un article et ses r�ponses (15>) ou l'ensemble des ascendants d'un 
-  article (15_).
-  Il existe deux racourcis suppl�mentaires : '.' repr�sente l'article courant,
-  '5<' repr�sente l'origine du fil de discussion et '1' repr�sente le
-  premier article du groupe. Enfin, '-10' et '10-' sont utilisables, et
-  repr�sentent respectivement tous les articles de num�ro inf�rieur � 10, 
-  et tous les articles de num�ro sup�rieur � 10.
-
-  Ainsi, pour avoir le r�sum� de la discussion en cours, on peut taper :
-  '.<>r'.
-
-	Commandes de flrn
-	-----------------
-
-Les touches peuvent �tre rebind�es. Cependant on d�crit le comportement
-par d�faut.
-
-* D�placement dans les articles :
-
-espace, enter et n changent d'article. Espace affichera l'article suivant de
-la discussion qui n'as pas encore �t� lu. Enter (comme n) va juste � l'article
-suivant.
-
-v affiche un article. Par exemple '15v'.
-
-Les fl�ches permettent de se d�placer dans les discussions. La fl�che gauche
-va au p�re, celles du haut et du bas se d�placent parmis les fr�res.
-(On a aussi les bindings �quivalents []() comme trn, ainsi que b et f issus
-de forum).
-
-On peut encore avec B, F et H se d�placer parmi les articles que l'on vient
-de lire.
-
-* Gestions des articles
-
-V (\view) lance $PAGER.
-s (\save) sauve l'article.
-S (\SAVE) sauve une discussion.
-o (\omet) marque l'article comme non lu. O marque la discussion non lue.
-k (\kill) marque l'article comme lu. Cela sert quand l'article est long.
-	K et J marquent l'article et ses descendants lus (toute la discussion
-	pour J)
-
-* Affichage de r�sum�s
-
-r (\summary) affiche un r�sum�.
-t (\summ_fil) r�sum� d'un article et de ses fils. (�quivalent � '.>r')
-T (\summ_thr) r�sum� de la discussion. (�quivalent � '.<>r')
-/ (\menu-search) affiche un menu des articles v�rifiant une condition :
-	�a peut �tre soit des flags (read/unread, selected/unselected),
-	ou des ent�tes (par exemple, From: toto proposera les articles
-	dont l'ent�te From: contient "toto").
-
-* Gestion des groupes :
-
-u (\unsubscribe) se d�sabonne du groupe.
-a (\subscribe) s'abonne au groupe.
-z (\zap)  marque comme lus tous les messages du groupe.
-g (\goto) change de groupe, en restant dans ceux auxquels on est abonn�
-G (\GOTO) change de groupe.
-l (\list) donne la liste des groupes auxquel on est abonn�.
-L (\LIST) liste tous les groupes.
-
-* Posts :
-
-m (\post) poste un article.
-R (\reply) r�pond en public � un article, c-�-d poste un "followup"
-
-* Divers :
-
-(\config) permet de changer la valeur de certaines options � l'aide d'un menu
-: (\option) �value directement une ligne d'option
-q (\quit) quitte.
-Q (\QUIT) quitte sans sauver le .flnewsrc.
-h (\help) lance cette aide.
-
-Cf la page 4 pour plus de d�tails.
+        flrn : description simple des commandes
+        ---------------------------------------
+
+====================================
+A) Comment entrer une commande ?
+B) Les commandes de flrn
+     * D�placement dans les articles
+     * Gestion des articles
+     * Affichage de r�sum�s
+     * Gestion des groupes
+     * Posts
+     * Divers
+====================================
+
+Cette section de l'aide se veut relativement simple, et ne d�taille pas
+l'ensemble des fonctions de chaque commande ou la puissance d'entr�e
+des commandes. De m�me certaines commandes ne sont pas d�taill�es.
+Pour plus d'informations on peut se reporter aux sections 4 et 5 de l'aide.
+
+A) Comment entrer une commande ?
+   -----------------------------
+
+Les commandes sont utilisables soit en tapant leur nom pr�c�d� d'un
+� \ � (par exemple, en tapant � \goto �), ou en utilisant une touche sur
+laquelle elles sont li�es (par exemple � g � est, par d�faut, un raccourci
+pour � \goto �). Il n'est pas n�cessaire d'appuyer sur <enter> quand on
+utilise une touche li�e sauf si la commande doit prendre une cha�ne de
+caract�re en argument.
+
+Certaines commandes prennent une cha�ne de caract�res en argument :
+"\goto aide" ou "gaide" permet ainsi de se rendre dans le groupe 'aide'.
+
+On peut aussi pr�c�der l'entr�e de la commande par un pr�fixe d�crivant
+les articles auxquels elle doit s'appliquer (si rien n'est indiqu�,
+en g�n�ral la commande s'applique sur l'article courant). Par exemple, pour
+la commande � s � (\save), qui permet de sauver des articles dans un fichier :
+  � s � ou � .s � permet de sauver l'article courant
+  � 15s � permet de sauver l'article 15 du groupe courant
+  � >s � permet de sauver l'article courant et tous ses descendants
+  � <>s � permet de sauver l'ensemble du fil de discussion courant
+  � *s � permet de sauver l'ensemble de la discussion courante dans ce groupe
+  � 1-100s � permet de sauver les articles entre 1 et 100 du groupe courant
+  � -s � permet de sauver l'ensemble des articles du groupe courant
+
+
+B) Commandes de flrn
+   -----------------
+
+Les raccourcis pr�sent�s sont ceux de la configuration par d�faut. 
+Il est possible de changer les liens entre touches de raccourci et commandes.
+
+*** D�placement dans les articles
+
+� v � (\article) passe � l'article pass� en param�tre. Par exemple,
+� 15v � permet de passer � l'article num�ro 15. Quand <enter>
+est pr�c�d� d'un num�ro d'article, il se comporte comme � v �.
+
+<espace> et � n � (\nxt-unread) permet de passer � l'article suivant de
+la discussion qui n'a pas encore �t� lu. Si tous les messages sont lus,
+cette commande peut changer de groupe.
+
+<enter> (\nxt-article), s'il n'est pas pr�c�d� d'un num�ro d'article,
+permet de passer � l'article suivant par num�ro dans le groupe.
+� p � ou � - � (\previous) permet de passer � l'article pr�c�dent par
+num�ro.
+
+Les fl�ches permettent de se d�placer dans les discussions.
+La fl�che gauche (\left) va au p�re, la fl�che droite (\right) a un
+des fils, les fl�ches haut (\up) et bas (\down) se d�placent parmi
+les fr�res d'un article.
+(les raccourcis � ( �, � ) �, � [ � et � ] � sont aussi d�finis
+respectivement pour \up, \down, \left et \right, et � b � et � f �
+d�finissent aussi \left et \right)
+
+flrn garde en m�moire (m�me entre plusieurs sessions) un historique
+des messages visit�s. On peut se d�placer dans cet historique avec
+� B � (\hist-prev) et � F � (\hist-next).
+
+*** Gestions des articles
+
+� V � (\view) lance un "pager", c'est-�-dire un programme charg� d'afficher
+              du texte sur l'�cran, et lui transmet les articles en param�tre.
+� s � (\save) sauve les articles dans un fichier.
+� S � (\SAVE) sauve les articles et leurs descendants.
+� o � (\omit) marque les articles comme non lus.
+� O � (\OMIT) marque les articles et leurs descendants comme non lus
+� k � (\kill) marque les articles comme lus (y compris, pour les articles
+              crosspost�s, dans les autres groupes).
+� K � (\kill-replies) marque les articles et leurs descendants comme lus.
+� J � (\kill-thread) marque les articles et leurs fils de discussion comme lus.
+
+
+*** Affichage de r�sum�s
+
+Les r�sum�s des articles donnent un menu dans lequel on peut choisir un
+article ou appliquer certaines commandes de gestion d'articles.
+
+� r � (\summary) affiche un r�sum� des articles s�lectionn�s.
+                 Exceptionnellement, cette commande sans param�tre affiche
+		 un r�sum� des articles � autour � de l'article courant,
+		 dans la limite d'une page.
+� t � (\summ-replies) affiche un r�sum� des articles et de leurs descendants.
+� T � (\summ-thread) affiche un r�sum� des articles et de leurs fils
+                     de discussion.
+� / � (\menu-search) fonctionne comme \summary mais permet de poser
+                     des conditions sur les articles : soit des drapeaux
+		     (par exemple � /unread � ne proposera que des articles
+		     non lus), soit une condition sur une ent�te (par
+		     exemple � /From: toto � proposera les articles dont
+		     l'ent�te From: contient "toto").
+
+*** Gestion des groupes :
+
+Ces commandes prennent souvent une cha�ne en argument pour d�signer le
+nom d'un (ou de plusieurs) groupe(s). Quand la commande ne concerne
+qu'un seul groupe et que le groupe est ambigue, un menu est propos�.
+Si aucune cha�ne n'est rentr�e, le groupe courant est pris en compte.
+
+� u � (\unsubscribe) se d�sabonne d'un groupe.
+� a � (\subscribe) s'abonne � un groupe.
+� z � (\zap)  marque comme lus tous les messages d'un groupe.
+� g � (\goto) change de groupe, en restant dans les groupes abonn�s. Sans
+              argument, cette commande cherche un groupe o� des messages
+	      sont non lus.
+� G � (\GOTO) fonctionne comme \goto, mais ne se limite pas aux groupes
+              abonn�s.
+� l � (\list) pr�sente la liste des groupes abonn�s choisis (par d�faut,
+              tous les groupes abonn�s), sous la forme d'un menu. On peut
+	      alors en s�lectionner un, ou appliquer certaines commandes.
+� L � (\LIST) pr�sente la liste de tous les groupes, avec jusqu'� trois
+              menus : en se limitant aux groupes abonn�s, puis aux groupes
+	      connus, puis � tous les groupes (si un menu est vide, il
+	      n'est pas propos�).
+
+*** Posts :
+
+Ces commandes peuvent prendre un nom de fichier en param�tre (qui contiendra
+le message � poster), ou alors lancent un �diteur.
+
+� m � (\post) poste un article.
+� R � (\reply) r�pond en public � un article.
+� e � (\cancel) permet d'annuler un article qu'on a post�.
+
+*** Divers :
+
+� : � (\option) �value directement une ligne d'option.
+� q � (\quit) quitte flrn en prenant en compte la lecture des articles.
+� Q � (\QUIT) quitte flrn sans prendre en compte la lecture des articles.
+� h � ou � ? � (\help) lance cette aide.
 
 
 'q' permet de quitter l'aide � tout moment.