diff NOTES.html @ 0:04124a4423d4 noffle

[svn] Initial revision
author enz
date Tue, 04 Jan 2000 11:35:42 +0000
parents
children 9c32711fc479
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/NOTES.html	Tue Jan 04 11:35:42 2000 +0000
@@ -0,0 +1,198 @@
+<html>
+
+<head>
+<title>NOFFLE Compatibility Notes</title>
+</head>
+
+<body bgcolor=white>
+
+<center>
+<h1>NOFFLE Compatibility Notes</h1>
+</center>
+
+<p>
+<hr>
+<p>
+
+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.
+<p>
+Subscribing to groups in "overview" or "thread" mode requires more
+from the news reader program:
+<p>
+<ul>
+<li>
+It must not cache articles at all (or allow to switch the cache off),
+because the article bodies change from the pseudo article
+"marked for download" to the real body.
+<li>
+The reader should rarely open article bodies automatically,
+because it will mark them unwantedly for download.
+</ul>
+
+Please send me reports on your experiences. If a reader does not work at
+all, compile NOFFLE with the -DDEBUG option in CFLAGS. Then you will
+see every NNTP command and status line in /var/log/news. Most interesting
+is the last line, before the reader (or NOFFLE) hangs :-)
+<p>
+Here comes a list with news readers that have been tested with NOFFLE,
+especially with regards to subscribing to groups in "overview" or "thread"
+mode.
+<p>
+
+<h2>kexpress 0.2.0</h2>
+
+I found no way to disable caching, apart from writing a
+wrapper script, which removes all files from the cache after
+terminating kexpress:
+<p>
+<pre>
+      #!/bin/bash
+      # kexpress wrapper, save as /usr/local/bin/kexpress
+
+      /opt/kde/bin/kexpress $@
+      rm $HOME/.kde/share/apps/kexpress/data/*
+</pre>
+<p>
+
+<h2>krn 0.4.0</h2>
+
+Set "Options/NNTP Options/Connect on Startup,Connect without asking"
+and "Options/Expire options/Article bodies/Read=0,UnRead=0"
+Sometimes the article bodies remain in the cache, the following
+wrapper script helps:
+<p>
+<pre>
+      #!/bin/bash
+      # krn wrapper, save as /usr/local/bin/krn
+
+      /opt/kde/bin/krn $@
+      rm $HOME/.kde/share/apps/krn/cache/*
+</pre>
+<p>
+Articles can be marked as read/unread without opening with the
+middle mouse button.
+This version of krn is still unstable.
+
+<h2>netscape 3.04</h2>
+
+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 downloaded.
+For avoiding unwanted opening of articles one should first
+"Message/Mark Newsgroup read", then open the wanted articles
+one by one and mark them as unread again ("Message/Mark as Unread")
+immediately after opening.
+
+<h2>netscape communicator 4.0.5</h2>
+
+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 you,
+choose "View/Hide message".
+This version of netscape still seems to be unstable for reading
+news.
+
+<h2>netscape communicator 4.5</h2>
+
+As with 4.0.5 "View/Show/Message" can be used to switch off
+automatic message display (and marking for download).
+
+<h2>pine 3.96, 4.05</h2>
+
+Ok.
+
+<h2>slrn 0.9.5.2</h2>
+
+Ok. You can change some keybindings, by saving the following
+script to ~/.slrn.sl and adding "interpret .slrn.sl" at the end
+of your ~/.slrnrc
+<p>
+<pre>
+      % SLRN script for better interplay with NOFFLE news server.
+      % Redefines some keys for opening articles without modifying flags.
+      define my_article_linedn()
+      {
+          variable flags = get_header_flags();
+          call ( "article_linedn" );
+          set_header_flags( flags );
+      }
+      define my_scroll_dn()
+      {
+          variable flags = get_header_flags();
+          call ( "scroll_dn" );
+          set_header_flags( flags );
+      }
+      define my_hide_article()
+      {
+          variable flags = get_header_flags();
+          call ( "hide_article" );
+          set_header_flags( flags );
+      }
+      definekey( "my_article_linedn", "\r", "article" );
+      definekey( "my_scroll_dn", " ", "article" );
+      definekey( "my_hide_article", "h", "article" );
+</pre>
+<p>
+
+<h2>tin pre</h2>
+
+Call with "tin -r" or "rtin". 'K' marks articles/thread as
+read without opening them. '-' marks them as unread.
+
+<h2>Emacs Gnus</h2>
+
+With newer versions of NOFFLE, Gnus freezes up when retrieving active
+groups. Since NOFFLE's log files in DEBUG mode show nothing unusual,
+I believe that this is a bug in Gnus. 
+<p>
+Here is a proposal for changing some key-bindings.
+<p>
+<pre>
+      ;; Customising Gnus for use with the NOFFLE news server
+      ;; 
+      ;; <return> tick and open article
+      ;;          for reading/marking for download
+      ;; <space>  scroll article text circular
+      ;;          for avoiding automatic opening of next article
+      ;; <d>      mark article as read and go to next line
+      (defun my-gnus-summary-tick-and-open(n)
+        "Tick and open article, so that NOFFLE marks it for download" 
+        (interactive "p")
+        (gnus-summary-scroll-up n)
+        (gnus-summary-mark-article nil gnus-ticked-mark t)
+        )
+      (defun my-gnus-summary-next-page(n)
+        "Next page of article, but do not open next article automatically"
+        (interactive "p")
+        (gnus-summary-next-page 10 t) ;; Call with argument `circular'.
+        )
+      (defun my-gnus-summary-mark-read-next-line(n)
+        "Mark article as read and go to next line"
+        (interactive "p")
+        (gnus-summary-mark-article-as-read gnus-read-mark)
+        (next-line n)
+        )
+      (defun my-gnus-summary-mode-hook ()
+        (define-key gnus-summary-mode-map "\r"
+          'my-gnus-summary-tick-and-open)
+        (define-key gnus-summary-mode-map " "
+          'my-gnus-summary-next-page)
+        (define-key gnus-summary-mode-map "d"
+          'my-gnus-summary-mark-read-next-line)
+        )
+      (add-hook 'gnus-summary-mode-hook 'my-gnus-summary-mode-hook)
+</pre>
+
+<p>
+<hr>
+<small><i>
+Last modified 4/99,
+<a href="mailto:markus.enzenberger@t-online.de">Markus Enzenberger</a>
+</i></small>
+
+</body>
+</html>