Pr�paration de la distrib.

BUGS

@@ -0,0 +1,10 @@
+Hum...
+Comment dire...
+Ben...
+Si on fait la somme des bugs et des misfeatures...
+�a fait beaucoup, vraiment beaucoup....
+
+donc on se limitera � un (ou plut�t deux) bug(s) :
+_ le man est nul
+_ l'aide n'est pas mieux.
+

INSTALL

@@ -0,0 +1,37 @@
+Installation de flrn
+====================
+
+pour installer flrn, le plus simple est de taper :
+./configure --with-default-domain=DOMAIN
+make
+make install   (avec des droits acceptables, donc souvent en super-utilisateur)
+
+configure
+=========
+
+configure dipose d'un certain nombre d'options. Entre autres :
+
+--prefix=DIR : pr�cise o� flrn doit �tre install�
+
+--with-rx=DIR : demande l'utilisation de la biblioth�que rx et pr�cise ou
+		trouver cette biblioth�que
+
+--with-slang=DIR : pr�cise o� trouver slang, s'il n'est pas � la place
+		   habituelle
+
+--with-default-host=DIR : pr�cise le nom de la machine d'o� sont cens�s
+			  provenir les posts (indispensable si gethostname
+			  n'existe pas)
+--with-default-domain=DOMAIN : pr�cise le nom de domaine, indispensable si
+			       on ne veut pas ens.fr  ;-)
+
+Il faut d'autre part que configure puisse trouver sendmail, soit dans
+le chemin d'acc�s courant, soit dans /usr/lib ou /usr/sbin.
+Faute de quoi flrn sera incapable d'envoyer des mails.
+
+
+Apr�s le configure, vous pouvez regarder les diff�rents fichiers
+Makefile, ainsi que src/config.h .
+Il est aussi possible de modifier src/site_config.h (et quelques
+passages de src/flrn_config.h), voir le fichier INSTALL.site pour plus
+de d�tails.

INSTALL.site

@@ -0,0 +1,71 @@
+Configurer flrn pour un site donn�
+==================================
+
+0) modifier flrn_config.h  (avant la compilation)
+   ----------------------
+
+Le d�but de flrn_config.h contient quelques d�finitions que vous pouvez
+modifier... � vos risques et p�rils.
+
+1) modifier site_config.h  (avant la compilation)
+   ----------------------
+
+site_config.h donne la configuration par d�faut (qui est modifi� par
+le .flrnrc de l'utilisateur, ou le flrnrc par d�faut de l'installation
+si l'utilisateur n'a pas de .flrnrc).
+
+Comme flrn a �t� pr�vu pour un serveur local, certaines valeurs ne
+sont pas compatibles avec une installation pour les news ext�rieures.
+On conseille particuli�rement de changer :
+     (cf le manuel pour plus d'explications sur ces variables)
+
+_ server : mieux vaut mettre "news", ou le nom de votre serveur pr�f�r�.
+  (cette variable est de toute fa�on �cras�e par $NNTPSERVER)
+_ header, weak_headers, hidden_headers : on peut faire quelques
+  modifications, mais cela ne permet h�las pas d'avoir ce que l'on
+  peut obtenir avec un vrai flrnrc (faute de pouvoir introduire des
+  headers non "connus" de flrn).
+_ edit_all_headers : dans une configuration pour des news ext�rieures, il 
+  FAUT mettre 1.
+_ include_in_edit : mis � 0 pour �viter la pr�sence de quote dans les
+  r�ponses (les messages n'expirant pas), il faut mettre 1 pour des
+  news ext�rieures, surtout si auto_edit est �gal � 1.
+_ threaded_space : il faut mettre 1. Ce sera 1 dans les futures versions.
+_ auto_edit : il est pr�f�rable de mettre 1, sauf si votre �diteur favori
+  est (x)emacs et qu'il prend trop de temps � se lancer. :-)
+_ auto_kill : cette option sp�ciale est mieux � 0
+_ use_regexp, use_menus, with_cousins : mieux vaut mettre 1
+_ default_subscribe : 0 est peut-�tre pr�f�rable
+_ alpha_tree (quel nom idiot !) : il faut mettre 1
+_ flags_group : la chaine "M DDm*dd" est probablement meilleure
+_ hist_file_name : mettre ".flrnhist" n'est pas plus mal
+_ warn_if_new : mettre 1 n'est pas plus mal non plus
+_ default_flnewsfile : mettre "flnewsrc" n'est pas plus mal
+_ help_line : vu la gueule des lignes d'aide, on peut mettre 0 sans risque
+
+
+Comme ces modifications sont un peu lourde, on peut tout simplement ne
+rien faire, et installer un flrnrc par d�faut qui sera charg� si 
+l'utilisateur n'en a pas dans son r�pertoire. Mais un utilisateur
+qui d�sirerait personnaliser sa configuration devra alors inclure la
+configuration par d�faut par un "include ..." au d�but de son .flrnrc
+(ou alors il peut reprendre le flrnrc par d�faut et le modifier).
+
+2) faire un flrnrc par d�faut (apr�s l'installation)
+   --------------------------
+
+Un exemple de flrnrc est le flrnrc.sample donn� dans ce r�pertoire.
+On pourra avantageusement le copier dans  $datadir/flrn pour
+avoir une configuration par d�faut.
+
+3) faire un flnewsrc par d�faut (apr�s l'installation)
+   ----------------------------
+
+On pourra rajouter un flnewsrc dans $datadir/flrn qui servira si
+lorsque l'utilisateur lance flrn pour la premi�re fois (si la
+configuration est bien pr�vue pour). Ce flnewsrc a le format d'un
+.newsrc normal.
+On pourra par exemple y mettre la simple ligne :
+fr.bienvenue:
+
+afin que l'utilisateur soit par d�faut abonn� � un groupe utile.

README

@@ -0,0 +1,100 @@
+README pour flrn en fran�ais 
+
+(d�sol� pour le pompeux du discours, on essaie de faire un truc s�rieux)
+
+Description
+===========
+
+flrn est un lecteur de news en fran�ais d�velopp� � l'�cole Normale Sup�rieure.
+(fran�ais = franglais... les commandes par exemple ont des noms anglais)
+
+flrn dispose d'un certains nombre de features : affichage de r�sum�s
+des messages (comme slrn), configurable sans trop de difficult�s, historique
+des messages lus, passage facile d'un groupe � l'autre d'un message
+crosspost�...
+Principal d�faut (� mon avis) : flrn ne d�code pas les messages (sauf
+�ventuellement les headers en QP ou en base64), et ne g�re �videmment pas
+les messages en multi-part.
+
+Les auteurs de flrn sont Jo�l-Yann Fourr� et Damien Mass� (auteur du pr�sent
+fichier).
+
+Les discussions autour de flrn se font pour des raisons historique sur
+un groupe de discussion interne � l'ENS, mais on peut envoyer les
+suggestions et bug-reports � [email protected] o� ils seront bien
+accueillis (en principe). Il est �ventuellement envisageable de cr�er
+une mailing-liste si le programme se r�pand vraiment (heureusement,
+c'est pas encore fait).
+
+flrn a �t� essentiellement test� sur des serveurs de news innd (de
+diff�rentes versions). Quelques essais ont �t� effectu�s avec leafnode
+(qui dispose d'un nombre moindre de commandes).
+
+Histoire
+========
+
+Le projet d'�crire flrn date de novembre 1997. L'objectif �tait d'obtenir
+un lecteur de news qui simule l'interface d'un vieux programme de news
+interne (non client-serveur) dont le nom �tait forum, afin de passer
+� un syst�me client-serveur o� le serveur serait un truc standard (innd).
+D'o� flrn = forum-like rn.
+Par la suite les auteurs ont tent� de rendre ce programme utilisable pour
+autre chose que la lecture de groupes de discussions locaux.
+
+Syst�mes support�s
+==================
+
+flrn est cens� tourner sur n'importe quel Unix un peu r�cent, pour
+peu que slang soit install�.
+Il a �t� essentiellement test� sous Linux (PC et alpha) et SunOS 5,
+mais de vieilles versions ont �t� un peu test�es sous SunOS 4 (avec la
+biblioth�que rx), NextStep (avec gcc -posix), HPUX et OpenBSD.
+Il est conseill� d'utiliser gcc, mais cc semble le plus souvent marcher.
+
+La biblioth�que slang (ftp://space.mit.edu/pub/davis/slang) est indispensable
+pour flrn. flrn a �t� test� avec des versions entre 0.99 et 1.2 (pas la
+1.3, il faudrait que je v�rifie si rien n'a chang�). flrn n'utilise que
+la partie gestion de terminal de la biblioth�que (comme mutt). Il est
+envisag� (mais non d�cid�) d'utiliser � terme le langage associ�.
+
+La biblioth�que rx (ftp://prep.ai.mit.edu/pub/gnu/rx) est n�cessaire si
+la biblioth�que C n'inclut pas la gestion des expression r�guli�res.
+
+L'installation du programme urlview 
+(ftp://ftp.lip6.fr/pub/unix/mail/mutt/contrib/)
+est conseill�e. �a s'adapte tr�s bien au programme.
+
+
+Installation
+============
+
+cf INSTALL pour l'installation "de base"
+Il est conseill� de regarder aussi INSTALL.site pour une
+configuration sp�cifique � un site donn�.
+
+Documentation
+=============
+
+flrn dispose d'une page de man qui d�crit les options de la ligne
+de commande et les options du fichier de configuration.
+L'aide en ligne d�crit le fichier de configuration, les commandes
+de flrn et le kill-file de flrn.
+L'ensemble des fichiers de l'aide en ligne est dans le r�pertoire help.
+
+Bug-reports, etc...
+===================
+
+Envoyer � [email protected], ou a [email protected] (ceci si
+on cr�e une mailing-list un jour, pour l'instant �a finit dans ma
+mailbox ;-) )
+cf src/README.dev pour avoir des renseignements sur l'organisation (tr�s
+d�sorganis�e) du code.
+
+
+Copie
+=====
+
+flrn est sous GPL
+Une petite partie du code a �t� reprise � mutt (ancien parsing de la
+date, codage et d�codage des headers en QP pour l'iso-8859-1)
+cf COPYING pour plus de d�tails.

TODO

@@ -0,0 +1,3 @@
+_ crosspost sans fu2
+_ inclusion d'un .signature
+[mettez ici votre feature pr�f�r�e]