Initial revision

help/Help_0

@@ -0,0 +1,18 @@
+0: pr�sentation de flrn
+
+
+	Pr�sentation de flrn
+	--------------------
+
+Flrn est un super-programme m�ga-torche pour lire les news.
+Son seul bug est d'�tre en fran�ais. Mais c'est promis, un jour je le
+traduis en russe.
+
+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.
+
+	Damien
+
+'q' permet de quitter l'aide � tout moment.
+'m' permet de revenir au menu

help/Help_1

@@ -0,0 +1,98 @@
+1: commandes simples
+
+Les paragraphes en retrait sont des descriptions plus d�taill�es qui peuvent
+�tre ignor�s.
+
+        flrn : commandes de bases
+        -------------------------
+
+	Syntaxe g�n�rale des commande
+	-----------------------------
+
+Les commandes sont utilisables soit en tappant leur nom :
+"\goto" ou en utilisant une touche sur laquelle elles sont bind�es, comme 'g'.
+
+Certaines commandes prennent une chaine de caract�res en argument. On peut la
+mettre directement si l'on utilise la premi�re forme : "\goto flrn".
+
+  Enfin, on peut tapper avant toutes les commandes un prefix d�crivant les
+  articles auxquels elle doit s'appliquer (la s�mantique varie un peu pour
+  certaines commandes particuil�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 anc�tre d'un article (15_).
+  Il existe deux racourcis suppl�mentaires : '.' repr�sente l'article courant,
+  '5<' repr�sente l'origine du fil de discution 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 dfe num�ro sup�rieur � 10.
+
+  Ainsi, pour avoir le r�sum� de la discution en cours, on peut tapper :
+  '.<>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 discution 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 discutions. 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 parmis les articles que l'on vient
+de lire.
+
+* Gestions des articles
+
+V (\view) lance $PAGER.
+s (\save) sauve l'article.
+S (\SAVE) sauve une discution.
+o (\omet) marque l'article non lu. O marque la discution non lue.
+k (\kill) marque l'article lu. Cela sert quand l'article est long.
+	K et J marquent l'article et ses descendants lus (toute la discution
+	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 discution. (�quivalent � '.<>r')
+
+* Gestion des groupes :
+
+u (\unsu) se d�sabonne du groupe.
+a (\abon) s'abonne au groupe.
+z (\zap)  marque tous les messages du groupe lus.
+g (\goto) change de groupe parmis les groupes auxquels on est abonn�.
+G (\GOTO) change de groupe.
+l (\list) donne la liste des groupes auquel on est abonn�.
+L (\LIST) liste tous les groupes.
+
+* Posts :
+
+m (\post) poste un article.
+R (\repond) r�pond � un article, c-�-d poste un followup.
+
+* Divers :
+
+(\config) permet de changer la valeur de certaines options par un menu.
+: (\option) permet de donner 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.
+
+
+'q' permet de quitter l'aide � tout moment.
+'m' permet de revenir au menu

help/Help_2

@@ -0,0 +1,32 @@
+2: Poster des messages
+
+	flrn : poster des messages
+	--------------------------
+
+Pourquoi poster des messages ? N'est-ce pas mieux de lire simplement ?
+Si vous voulez vraiment, les commande post et respond permettent de poster un
+message. respond r�pond � un message. Si auto_edit est ind�fini, vous entrez
+alors dans l'�diteur int�gr� de flrn (qui est tr�s sommaire).
+Pour poster votre message, entrez � la fin de celui-ci une ligne ne 
+comportant qu'un '.' ou tapez ^D.
+
+Vous pouvez lancer une �diteur (d�fini par la variable d'environnement
+EDITOR) en entrant juste ~e ou ~E sur une ligne. En mode edit_all_headers,
+tous les headers d�finis seront affich�s (et vous pourrez en ajouter). Dans
+le mode par d�faut, seul le sujet et les groupes dans lesquels le message
+est post�s sont affich�s.
+
+Si vous entrez ~E, le corps du message auquel vous r�pondez sera inclus
+dans le post avant de lancer l'�diteur, et sera quot� par la chaine
+index_string.
+
+La commande mail-ans peut �tre utilis�e pour envoyer un mail de r�ponse �
+un article. Si respond est utilis� et qu'un Followup-To est d�fini, il
+vous sera demand� si vous souhaitez en tenir compte. Si il est plut�t demand�
+un post dans le newsgroup, et que le message contient en champ To, Cc, ou Bcc,
+le message sera aussi envoy� par mail.
+
+Dans tous les cas, ^C annule le post.
+
+'q' permet de quitter l'aide � tout moment.
+'m' permet de revenir au menu

help/Help_3

@@ -0,0 +1,218 @@
+Help_3
+
+	flrn : options du .flrn
+	-----------------------
+
+Les options sont aussi disponibles sur la page de manuel de flrn.
+La forme g�n�rale des options est inspir�e de mutt. Il y a six commandes :
+
+set <variable>=<valeur>
+	Permet de modifier la valeur d'une variable. On a les racourcis 
+	suivants : "set <variable>" est �quivalent � "set variable=1" ou 
+	"set variable=yes". De m�me, "set no<variable>" est �quivalent � 
+	"set <variable>=no" ou "set <variable>=0".
+
+header	list|weak|hide <une suite de chiffre ou de noms> 
+	donne l'ordre dans lequel les headers d'un
+        article doivent �tre affich�s. � chaque chiffre correspond un header :
+	  1 : Auteur      2 : R�ponse �     3 : Sujet         4 : Date
+	  5 : Newsgroups  6 : Followup-To   7 : Organization  8 : Lines  
+	  9 : Sender     10 : Reply-To     11 : Expires      12 : X-Newsreader
+	On peut mettre d'autres headers en donnant leur nom complet. 
+	On peut aussi mettre others pour signifier tous les autres headers.
+	(d�faut : 2 1 4 3)
+	Avec weak, on donne ceux qui ne doivent pas �tre r�affich�s apr�s la
+	premi�re page d'un message.
+	Avec hide, on indique les headers � ne pas afficher avec others.
+	(pas de d�faut)
+
+color   <types> <n1> <n2> <p1>,<p2>,...
+mono   <types> <p1>,<p2> ...
+regcolor   <types> <flags> <n1> <n2> <p1>,<p2>,... <regexp>
+        Fixe la couleur et/ou les propri�t�s des objets de flrn. La commande
+	color modifie les couleurs par d�faut, la commande mono les sp�cifie
+	si le terminal est monochrome, la commande regcolor permet, pour un
+	objet choisi, de modifier des patterns donn�s.
+        <types> est une suite de mots s�par�s par des virgules, choisis dans :
+	     normal : pour l'article par exemple (d�faut: valeurs du terminal)
+	     header : pour les headers           (d�faut: vert sur fond normal)
+	     status : pour la barre de newsgroup (d�faut: inverse video)
+	     error  : pour les messages d'erreur (d�faut: rouge gras)
+             quoted : pour les citations         (d�faut: magenta)
+	     fin    : pour le "A vous:" final    (d�faut: en gras)
+             sig    : pour les signatures        (d�faut: en bleu)
+             file   : pour les fichiers (aide)   (d�faut: normal)
+             summary: pour les r�sum�s           (d�faut: normal)
+	     all    : tous les objets
+	<n1> et <n2> sont les couleurs des caract�res et du fond
+	<p1> ... sont les attributs des caract�res : cela comprend
+	   	bold (gras), blink (souvent non d�fini),
+		underline (soulign�), et reverse (en inverse video),
+		normal et - (qui �quivaut � normal)
+	on peut aussi mettre pour les couleurs et les attributs std (couleur
+	du dernier type utilis� dans la commande), et std-<type> qui
+	repr�sente la couleur|attribut du dernier color|mono <type> fait.
+	<flags> est une suite de flags, parmis :
+		case : la regexp est case-sensitive
+		exclude : on exclue les autres regcolor d'un ligne qui matche
+		line : toute la ligne est mise dans la couleur choisie
+		n dans [1-9] : seule le groupe n est color�
+	<regexp> est une expression r�guli�re
+  Par exemple :
+    color file std-normal std-normal bold,underline
+    regcolor normal line std-quoted std-quoted std-quoted ^(�|�|<<)
+    mono status,error bold
+
+
+
+bind	<touche> <commande>
+	Permet de changer la fonction d'une touche. La syntaxe changera
+	surement dans les versions a venir, comme les noms ou s�mantiques des
+	commandes. Pour l'instant, on ne peut binder que des touches ne
+	correspondant pas � des carat�res sp�ciaux du .flrn, et correspondant
+	� des caract�res imprimables.
+  Par exemple :
+    bind U pipe urlview
+    bind + summary unread
+    bind \0x01 gotag �  # ^A
+    bind A tag �
+
+
+Voici les variables utilis�es :
+
+* Abonnement
+
+auto_subscribe=<une expression reguliere>
+	demande l'abonnement automatique aux newsgroups dont le nom
+	verifie l'expression r�guli�re
+	(d�faut : "")
+
+auto_ignore=<une expression reguliere>
+	demande le non-abonnement automatique aux newsgroups dont le
+	nom v�rifie l'expression r�guli�re
+	(d�faut : "^control|^[^.]+$", soit en gros ignorer control et junk)
+
+default_subscribe=yes|no
+	d�finit le comportement par d�faut lors de la cr�ation d'un nouveau
+	groupe, quand il ne s'applique pas � auto_subscribe et auto_ignore.
+	(d�faut : yes)
+
+* Affichage
+
+skip_line=<un num�ro>
+	d�finit le nombre de lignes blanches � laisser sous la barre de status.
+	(d�faut : 1)
+
+date_in_summary=yes|no
+	affiche ou non la date dans les r�sum�s
+	(d�faut : yes)
+
+ordered_summary=yes|no
+	affiche les r�sum�s dans l'ordre de leur num�ro, et non dans un ordre
+	thread�.
+	(d�faut : yes)
+
+duplicate_subject=yes|no
+	affiche le sujet � chaque ligne de r�sum�, m�me si c'est le m�me que
+	la ligne au-dessus.
+	(d�faut : no)
+
+color=yes|no|auto
+	demande l'utilisation de la couleur. Auto signifie que flrn tente une
+	d�tection automatique.
+	(d�faut : auto)
+
+* Commandes
+
+space_is_return=yes|no
+	emp�che de changer de groupe par la commande next (qui correspond par
+	d�faut � la barre d'espacement).
+	(d�faut : no)
+
+return_dont_scroll=yes|no
+	si cette option est activ�e, la touche "enter" ne scrolle pas d'une
+	ligne dans les messages longs, mais est directement execut�e hors
+	du message.
+
+cbreak=yes|no
+	passe en mode cbreak. Sans cette options, on est en mode nocbreak.
+	(d�faut : yes)
+
+new_mode=yes|no
+	si cbreak=yes, d�finit le mode d'entr�e des commandes. Le nouveau
+	mode est plus puissant que l'ancien, qui correspond aux commandes des
+	premi�res release de flrn.
+	(d�faut : yes)
+
+use_menus=yes|no
+	utilise des menus interactifs avec certaines commandes. Cette option
+	est exp�rimentale.
+	(d�faut : no pour l'instant)
+
+threaded_space=yes|no
+	permet de lire les messages en suivant la discussion (thread) ou dans
+	l'ordre des num�ros. Cette option modifie l'action de la commande next.
+	(d�faut : no)
+
+cool_arrows=yes|no
+	N'affiche pas de message d'erreur quand on utilise une commande de
+	d�placement dans le thread et que ce d�placement est invalide.
+	(d�faut : yes)
+
+use_regexp=yes|no
+	permet d'utilise les expressions r�guli�res pour les commandes list
+	et goto. Les expressions utilis�es sont les expressions �tendues de
+	rx.
+	(d�faut : no)
+
+zap_change_group=yes|no
+	dit a flrn de changer de groupe si on utilise la commande zap.
+	(d�faut : no)
+
+* Poster
+
+include_in_edit=yes|no
+	ins�re automatiquement le message auquel on r�pond dans l'�diteur.
+	Cette option n'a de sens qu'avec auto_edit.
+	(d�faut : no)
+
+auto_edit=yes|no
+	n'utilise pas l'�diteur int�gr� de flrn, et lance directement l'�diteur
+	ext�rieur quand on poste un message.
+	(d�faut : no)
+
+post_name=<un nom>
+	choisis le nom utilis� dans les messages envoy�s.
+	(d�faut : "")
+
+index_string=<str>
+	donne la cha�ne ajout�e au d�but de chaque ligne du message auquel
+	on r�pond pour quoter celui-ci.
+	(d�faut : "> ")
+
+smart_quote=yes|no
+	si index_string commence par '>' et que la ligne � quoter commence
+	aussi par '>', quote simplement par ">" et non par index_string.
+	(d�faut : yes)
+
+* Autres
+
+quit_if_nothine=yes|no
+	Quitte directement flrn si il n'y a rien de nouveau. Malheureusement,
+	efface quand m�me l'�cran.
+	(d�faut : no, parce que ce comportement est insupportable actuellement)
+
+use_mailbox=yes|no
+	Sauve les messages au format mailbox.
+	(d�faut : yes)
+
+server=<string>
+	utilise la machine correspondant � ce nom comme serveur.
+	(d�faut : selon l'installation locale)
+
+port=<n>
+	utilise le port donn� plut�t que le port nntp.
+	(d�faut : le port nntp)
+
+'q' permet de quitter l'aide � tout moment.
+'m' permet de revenir au menu.