------------------------------ -*- text -*- ------------------------------


1. Introduction

This package provides a collection of patches to the knews news
reader, that implementents additional features or fixes bugs.  Some of
the patches are made available as individual diff files, so that one
might apply them independently from the others.

See http://www.matematik.su.se/~kjj/knews.html for information about
knews itself.


2. Copyright and legal stuff

The knews program itself is copyrighted (c) 1995,1996 by Karl-Johan
Johnsson <kjj@matematik.su.se>.

The patches provided by this package are copyrighted (c) 1997-2000 by
Rolf Krahl <rolf@rotkraut.de>.

These patches, are free software; you can redistribute them and/or
modify them under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.

These patches, are distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with the knews sources; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


3. Installation

* Unpack the knews source distribution.

* Change in top directory of the knews source tree.

* Apply the patches, that you want to apply, one after the other, with
  the command

  $ patch -p0 -b < patch-name.diff

  with patch-name.diff replaced by the appropriate file name.

* Install knews according to the instructions in the INSTALL file from
  the knews sources.

Note on different versions of knews: Some of the diff files were
originally made against older versions of knews, but they all work
fine at least for version 1.0b.1.  rotkraut.diff was made against
knews version 1.0b.1.  Since it also modifies the version number,
you'll get rejects from patch on src/Knews.ad and src/global.h with
all other versions.  (But you can happily ignore this at least with
version 1.0b.0, you'll lose only the modification of the version
number.)


4. The patches

4.1 rotkraut.diff

This file collects all of the patches in one single diff file.
Useless to apply any other patch from this package, if you applied
this patch.

4.2 subscriptions.diff

This patch implements support for the "LIST SUBSCRIPTIONS" NNTP
command to ask the news server about the list of groups to subscribe
when creating a new newsrc file.

After applying the patch, you might want to edit the application
default file src/Knews.ad and uncomment the "Knews.autoSubscribe" line
of your choice.

4.3 fromaddress.diff

This patch allows the user to set his mail address, that is used in
the From header with the new X-resource "mailAddress".

In order to maintain the default behavior of knews, this feature is
turned off by a compile time switch in configure.h.  So you might want
to edit configure.h and set ALLOW_MAILADDRESS_RESOURCE to 1 after
applying the patch.

4.4 qp-fix.diff

This patch fixes bugs in knews that caused empty lines in
quoted-printable encoded articles to be dropped in the display and
quoting of the article.

--------------------------------------------------------------------------