diff docs/NOTES @ 53:9f3a4eccce32 noffle

[svn] Use numbers for sections. Added using Noffle as a maillist newsgroup gateway.
author enz
date Mon, 08 May 2000 17:52:14 +0100
parents 32ba1198c6fa
children 400ff41971ef
line wrap: on
line diff
--- a/docs/NOTES	Sun May 07 08:39:39 2000 +0100
+++ b/docs/NOTES	Mon May 08 17:52:14 2000 +0100
@@ -1,7 +1,32 @@
+
 -------------------------------------------------------------------------------
-NOFFLE Compatibility Notes
+
+    1. NOFFLE Compatibility Notes
+
+        1.1 General
+        1.2 kexpress
+        1.3 krn
+        1.4 Netscape
+        1.5 pine
+        1.6 slrn
+        1.8 Emacs Gnus
+
+    2. Using Noffle as a local maillist - news gateway
+
+        2.1 Create a local group
+        2.2 Create a mail2news script
+        2.3 Create an entry in .procmailrc
+
 -------------------------------------------------------------------------------
 
+
+1.NOFFLE Compatibility Notes
+----------------------------
+
+
+1.1 General
+-----------
+
 Subscribing to groups in "full" mode should work with any news reader.
 Caching of articles is unnecessary, since NOFFLE already caches them and
 should be switched off.
@@ -35,8 +60,10 @@
 list up-to-date.
 
 
-kexpress 0.2.0
---------------
+1.2 kexpress
+------------
+
+Version 0.2.0;
 
 I found no way to disable caching, apart from writing a wrapper script, which
 removes all files from the cache after terminating kexpress:
@@ -48,8 +75,10 @@
 rm $HOME/.kde/share/apps/kexpress/data/*
 
 
-krn 0.4.0
----------
+1.3 krn
+-------
+
+Version 0.4.0:
 
 Set "Options/NNTP Options/Connect on Startup,Connect without asking"
 and "Options/Expire options/Article bodies/Read=0,UnRead=0" Sometimes
@@ -65,9 +94,11 @@
 button. This version of krn is still unstable.
 
 
-netscape 3.04
+1.4 Netscape
 -------------
 
+Version 3.04:
+
 No cache problems, netscape caches the article overviews, but not the
 bodies. It is best to use "Options/Show only Unread Messages" and to
 keep requested articles in unread state until their bodies are
@@ -77,8 +108,7 @@
 immediately after opening.
 
 
-netscape communicator 4.0.5
----------------------------
+Version 4.0.5:
 
 Same as with netscape 3.04, but automatically opens the first article
 of a listed group and marks it for download thereby. If this bothers
@@ -86,21 +116,24 @@
 to be unstable for reading news.
 
 
-netscape communicator 4.5
--------------------------
+Version 4.5:
 
 As with 4.0.5 "View/Show/Message" can be used to switch off automatic
 message display (and marking for download).
 
 
-pine 3.96, 4.05
----------------
+1.5 pine
+--------
+
+Version 3.96, 4.05:
 
 Ok.
 
 
-slrn 0.9.5.2
-------------
+1.6 slrn
+--------
+
+Version 0.9.5.2:
 
 Ok. You can change some keybindings, by saving the following script to
 ~/.slrn.sl and adding "interpret .slrn.sl" at the end of your
@@ -131,15 +164,17 @@
    definekey( "my_hide_article", "h", "article" );
 
 
-tin pre
+1.7 tin
 -------
 
+Version tin pre:
+
 Call with "tin -r" or "rtin". 'K' marks articles/thread as read
 without opening them. '-' marks them as unread.
 
 
-Emacs Gnus
-----------
+1.8 Emacs Gnus
+--------------
 
 Some versions of Gnus freeze up when retrieving active groups. Since
 NOFFLE's log files in DEBUG mode show nothing unusual, I believe that
@@ -183,12 +218,66 @@
    (add-hook 'gnus-summary-mode-hook 'my-gnus-summary-mode-hook)
 
 
-pan 0.8.0beta5
---------------
+1.9 pan
+-------
+
+Version 0.8.0beta5:
 
 Ok.
 
--- 
-Markus Enzenberger <markus.enzenberger@t-online.de>
-Last update: 5/2000
+
+2. Using Noffle as a gateway between a maillist and a local group
+-----------------------------------------------------------------
+
+In combination with procmail, Noffle can be used to gateway all
+mails from a maillist to a local newsgroup.
+This is convenient for filtering out maillists from your personal emails.
+The local group is created with no posting allowed.
+Instead, replies to the list should be sent by email.
+
+2.1 Create a local group
+------------------------
+
+Example:
+
+    noffle --create local.mail-lists.my-maillist-name
+    noffle --modify post local.mail-lists.my-maillist-name n
+
+2.2 Create a mail2news script
+-----------------------------
+
+You need a program that reads an article from stdin and posts it to
+the local group. E.g. the following Python script will post an article
+read from stdin to the newsgroup given as the first argument:
 
+    #!/usr/bin/python
+    # Post article from stdin to noffle in group given as first argument.
+    import StringIO, nntplib, os, sys
+    if len(sys.argv) != 2: raise Exception("Need group as argument")
+    grp = sys.argv[1]
+    buf = StringIO.StringIO()
+    buf.writelines("Newsgroups: " + grp + "\n")
+    buf.write(sys.stdin.read())
+    buf.seek(0)
+    os.system("/usr/local/bin/noffle --modify post " + grp + " y")
+    srv = nntplib.NNTP("localhost")
+    srv.group(grp)
+    srv.post(buf)
+    srv.quit
+    os.system("/usr/local/bin/noffle --modify post " + grp + " n")
+
+2.3 Create an entry in .procmailrc
+----------------------------------
+
+Add a procmail entry for recognizing mails from the maillist and
+posting it using mail2news.
+
+Example of a ~/.procmailrc:
+
+    PATH=/bin:/usr/bin
+    MAILDIR=$HOME/Mail
+    LOGFILE=$MAILDIR/procmail.log
+
+    :0
+    * ^To.*my-maillist-name@lists.somewhere.org
+    |/home/user/bin/mail2news local.mail-lists.my-maillist-name