Revise plugin documentation. Mainly, this removes remains of documentation

that's only relevant for plugins which are not included in the main distro.
The objective is to make it not
- remove instructions about untarring this plugin (since it's already shipped)
- remove version numbers, which are not updated for a long time and not
  relevant anymore.
- remove changelogs, since they don't log the changes (we do that in the
  main ChangeLog).
- explicitly state that this plugin is not maintained anymore by the
  original authors (so bugs/etc get sent to us in stead of someone who
  maintained it four years ago).

If ok I'd like to put this in stable aswell.

plugins/abook_take/README

@@ -1,4 +1,4 @@
-Address Book Take -- Version 1.3
+Address Book Take
 
 If you would like to add the sender of a message you're reading to your
 address book quickly and easily without cutting and pasting, then this
@@ -43,24 +43,11 @@ Future Work
 Installation
 ============
 
-As with other plugins, just uncompress the archive in the plugins
-directory, go back to the main directory, run configure and add the plugin.
+Go back to the main directory, run configure and add the plugin.
 
-Questions/comments/flames/etc can be sent to
-    Tyler Akins <fidian@tiny.net>
 
-
-Changes
+Credits
 =======
-1.2 -> 1.3
-  * Removed warning created when all warning were enabled in PHP
-  
-1.1 -> 1.2
-  * Fixed some HTML
-  * Fixed how message body is grabbed
-  
-1.0 -> 1.1
-  * Fixed where a color was hardcoded
-  * Moved address <select> to take.php
-  * Moved verification to take.php
-  * Added & changed preferences
+
+This plugin has been originally developed by Tyler Akins and is now
+maintained by the SquirrelMail Project Team.

plugins/administrator/INSTALL

@@ -1,6 +1,5 @@
 Administrator Plugin
 --------------------
-Author: Philippe Mingo <philippe@squirrelmail.org>, 2002
 
 In order to use this plugin, you must first activate it using
 conf.pl and then you must change the config/config.php files
@@ -23,3 +22,10 @@ When plugin checks if user can use it, it first checks
 plugins/administrator/admins file. If file does not exist, plugin
 checks config/admins. If plugin can't find admins file, it tries to
 use uid based authentication.
+
+
+Credits
+-------
+
+The administrator plugin was originally created by Philippe Mingo, and is now
+maintained by the SquirrelMail Project Team.

plugins/bug_report/INSTALL

@@ -1,16 +0,0 @@
-Installing Plugins
-==================
-Simply untar the file in the plugins directory, and make sure it is
-in its own directory, and that the name of the directory is the name
-of the plugin.  Example below uses "plug_demo" as the name of the 
-plugin:
-
-  $ cd plugins
-  $ tar -zxvf /usr/archives/plug_demo.tar.gz
-
-Then go to your config directory and run conf.pl.  Choose option
-8 and add the plugin.  Save and exit, then that should be all
-if the plugin was made correctly.  :)
-
-  $ cd ../config
-  $ ./conf.pl

plugins/bug_report/README

@@ -1,4 +1,4 @@
-Bug Reporter -- Version 1.0
+Bug Reporter
 
 Need to submit a bug?  Need to know valuable system information?  Need
 to be accurate?  This should do it for you.
@@ -35,17 +35,11 @@ Future Work
 Installation
 ============
 
-As with other plugins, just uncompress the archive in the plugins
-directory, go back to the main directory, run configure and add the plugin.
+Go back to the main directory, run configure and add the plugin.
 
-Questions/comments/flames/etc can be sent to
-    Tyler Akins <fidian@tiny.net>
 
-
-Changes
+Credits
 =======
-1.0 -> 1.1
- * Added a bit more data to the report
- * Cleaned up some HTML
- * Altered link in menu bar to look good with other plugins
- * User-selectable list for where message gets sent to
+
+This plugin has been originally developed by Tyler Akins and is now
+maintained by the SquirrelMail Project Team.

plugins/calendar/README

@@ -1,6 +1,4 @@
 SQCalendar  $Id$
-GPL (C) 2001  Michal Szczotka <michal@tuxy.org>
-http://www.tuxy.org/index.php?path=/projects/sqcalendar/index.php
 
 ********** DESCRIPTION ************
 
@@ -22,3 +20,9 @@ SEE INSTALL
 - single entry of repetitve events (ex. birthday repeats every year)
 - reminder email/javascript/etc
 - weekly view
+
+
+************ CREDITS **************
+
+This plugin has been originally created by  Michal Szczotka, and is now
+maintained by the SquirrelMail Project Team.

plugins/filters/CHANGES

@@ -1,64 +0,0 @@
-Changes since 0.8.3
--------------------
-Changed include() calls to require_once() calls.
-Internationalization of the plugin.
-
-Changes since 0.8.2
--------------------
-Added many new FREE anti-spam databases to lookup from.
-Removed ORBS since they're off the air.
-
-Changes since 0.8.1
--------------------
-Added a SpamFilters_DNScache[] array that is useful for 2 reasons:
-
-1. You can put in IPs in the cache that override the SPAMfilter's DNS
-   checking routines -- either to force 'em to NOT filter email coming from
-   a specific IP (ie. for those pesky customers who can't figure out how to
-   make Exchange not be an open relay) or to force 'em to ALWAYS filter email
-   coming from a specific IP (ie. for those pesky sites you KNOW are SPAM
-   sources or relays but that aren't added to any of the DNS databases)
-
-2. Before the SPAMfilters do a DNS query, they check to see if the IP in
-   question is already in the cache.  If not and the query is performed, the
-   result is put in the DNS cache.  This makes the SPAM filters a LOT faster
-   when you get lots of email from various mailing lists (all coming from a
-   very small number of IPs).  The SPAM filters don't have to do a DNS query
-   on every message coming from the squirrelmail-plugins mailing list -- only
-   one the first time through to confirm the list server isn't in any of the
-   DNS databases!  :-)
-
-Changes since 0.8
--------------------
-Just fixed the Bad or malformed FETCH error that occurred when the INBOX was
-empty.  The spamfilter plugin did a FETCH query from MsgNum 1 to * and since
-there WAS no Msg Num 1 the IMAP server would respond with an error.  Now I
-check the number of messages before calling spam_filters or user_filters
-
-Changes since 0.7
---------------------
-Tyler made TONS of changes to incorporate the fixes I'd done and posted
-about, as well as to fix the problem with number of unread messages not
-showing up in the folder panel.  He also added some code to scan the headers
-for specific IPs in order to scan only IPs on the previous hop in the
-header. 
-
-This didn't work well for me (the IP of my gateway wasn't reported on the
-Received from ... by ... line, and so RSS and DUL still had tons of false
-hits.  I munged it so instead it uses a single string provided at 
-setup/install time to find the right line in the header to find the IPs to
-look for in the various databases.  (see SpamFilters_YourHop in setup.php)
-This seems to work pretty well for me -- faster enough to turn on all the
-databases and zero (so far) false hits! (grin)
-
-I also found a bug in sqimap_read_data() in functions/imap_general.php.
-After much discussion with Tyler, I rewrote it and posted it to
-squirrelmail-devel but it hasn't been accepted/tested/blessed yet
-NOTE: THIS NEW VERSION OF sqimap_read_data() IS REQUIRED BY FILTERS 0.8
-so you'll have to edit functions/imap_general.php and replace the function
-with the contents of sqimap_read_data.php.
-
-As soon as either my version of sqimap_read_data is officially part of the
-SM 1.1.2 CVS or until a new working version is posted, this is the only way
-to guarantee filters 0.8 will work.  
-

plugins/filters/README

@@ -1,4 +1,4 @@
-Filters 0.8.3
+Filters Plugin
 
 IMPORTANT: I've noticed at least one version of PHP that has bugs in the
 checkdnsrr() function that the SPAM filtering code RELIES ON.  In my case,

plugins/fortune/INSTALL

@@ -1,21 +0,0 @@
-Installing Fortune Plugin
-=========================
-Simply untar the file in the plugins directory, and make sure it is
-in its own directory, and that the name of the directory is the name
-of the plugin.  Example below uses "fortune" as the name of the 
-directory:
-
-  $ cd plugins
-  $ tar -zxvf /usr/archives/fortune_plugin.tar.gz
-
-Then go to your config directory and run conf.pl.  Choose option
-8 and add the plugin (+).  Save and exit, then that should be all
-if the plugin was made correctly.  :)
-
-  $ cd ../config
-  $ ./conf.pl
-
-Configuration is stored in config/fortune_config.php or 
-plugins/fortune/config.php. System won't load plugins/fortune/config.php,
-if config/fortune_config.php is present. Default configuration values 
-are stored in plugins/fortune/config_default.php.

plugins/fortune/README

@@ -1,6 +1,7 @@
 Simple SquirrelMail plugin that displays the quotes above the message listing.
 
-Original code contributed by paulm@spider.org
+Original code contributed by paulm@spider.org, now maintained by the
+SquirrelMail Project Team.
 
 Plugin requires /usr/games/fortune or any other similar program, that outputs 
 short text messages. If you are running php in safe_mode, path to program must 

plugins/mail_fetch/README

@@ -1,4 +1,4 @@
-Mail Fetch -- Version 1.3.0
+Mail Fetch
 
 Downloads mail from a pop3 server to your SquirrelMail account.
 
@@ -64,7 +64,7 @@ The second way is to edit functions.php and look for:
         $MF_TIT = "MailFetch Secure for SquirrelMail 1.x";
     }
 
-Once again change the text "MailFetch 0.8 Secure for SquirrelMail 1.x"
+Once again change the text "MailFetch Secure for SquirrelMail 1.x"
 with a secret text.
 
 Please note that you must redefine passwords each time you change the key.
@@ -86,25 +86,7 @@ Future Work
 Installation
 ============
 
-As with other plugins, just uncompress the archive in the plugins
-directory, go back to the main directory, run configure and add the plugin.
-
-Questions/comments/flames/etc can be sent to the SquirrelMail plugins list.
-
-Old versionn (0.7) has been updated from 0.6 by Philippe Mingo <mingo@rotedic.com>
-    IMPORTANT!!! This is a "secured" version, it makes a little encryption
-    of the pop3 passwords. In order to use this facility, systems that
-    have been using older versions (0.6 and lessers) should reenter
-    passwords using the modify button at the options page in order to
-    encrypt the password. The Encrypt passwords checkbox is only informative,
-    and it lets you know if passwords are secure or not.
-
-Old version (0.4) has been updated from Joshua's version 0.3 by
-    Tomaso Minelli <minni@minnata.net>
-    and Tyler (but only VERY minor stuff -- not worth really mentioning)
-
-Old version (0.3) has been updated from Tyler's original version 0.1 by
-    Joshua Pollak <pardsbane@offthehill.org>
+Go back to the main directory, run configure and add the plugin.
 
 
 Translations
@@ -135,65 +117,10 @@ SM configuration. To do so you only have to remove Newmail plugin
 and then add it again.
 
 
-ChangeLog
-=========
-
-1.3.1
-
-Bugfix
-------
-1 Delete mail server routine update record not as expected.
-The logic is still correct to completed the wanted action, but the order
-is not preserved. The last record was to replace the deleted record.
-2. Connection to IMAP server is not terminated at some condition during
-appending email and block the program.
-
-Added features
---------------
-1. The UIDL now updated to reflect last successfully fetched mail when
-fetching mail from server is stopped in the middle.
-2. POP3 connection will be re-established for non-persistent server failure.
-
-"Chiu Wai Pun" <pun@alumni.ust.hk>
-
----------------------------------------------------------------------------
-                   Philippe Mingo <mingo@rotedic.com>
----------------------------------------------------------------------------
-1.3.0 Official SM Version - Moved into the SM package.
-1.2.6 BugFix
-1.2.5 Bugfix
-1.2.4 Optimized class.POP3. Fixed problem with spaces in folders name.
-1.2.3 non-gettext systems now works
-1.2.2 Fixed login problems.
-1.2.1 Added polish translation.
-1.2.0 Added spanish translation.
-1.1.2 Bugfix: Missing include at login check.
-1.1.1 Bugfix: Now works with SM 1.1.1 and 1.1.2. To do this check during
-      login is disabled with these versions.
-1.1   Bugfix: Now messages deletes correctly from pop servers.
-1.0   Added check during folder refresh and check during login code.
-0.9   Added an alias for each server. Changed default encryption key, please
-      reenter passwords if you're not using environment system.
-0.8   Better encryption security through env variables.
-0.7   Added password encryption and strings internationalization.
-----------------------------------------------------------------------------
-0.6   Bugfix for folder list and typo
-      set_time_limit of 20 seconds per message (to avoid timeout errors)
-0.5   Works properly for servers that have 0 messages to fetch
-----------------------------------------------------------------------------
-                    Tomaso Minelli <minni@minnata.net>
-----------------------------------------------------------------------------
-0.4   Allow an infinite amount of remote servers
-      If password is empty, prompt on check
-      Save messages into a local IMAP folder instead of INBOX
-      (Tyler) Uses new 1.1.1 validate.php format
-----------------------------------------------------------------------------
-                 Joshua Pollak <pardsbane@offthehill.org>
-----------------------------------------------------------------------------
-0.3   Converted fetch routine to use the POP3 object from thewebmasters.net
-      Added Leave Mail on Server option
-      Now only downloads new messages if the pop server supports UIDL.
-----------------------------------------------------------------------------
-0.2   Now saves account information
-0.1   Initial release by Tyler Akins
-----------------------------------------------------------------------------
+Credits
+=======
+
+This plugin has been originally created by Tyler Akins, with contributions
+from Philippe Mingo, Tomaso Minelli and Joshua Pollak. It's now maintained
+by the SquirrelMail Project Team.
+

plugins/newmail/HISTORY

@@ -1,61 +0,0 @@
-This is the history for the newmail plugin in SquirrelMail.  Currently
-works with the 1.1.2+ versions of SquirrelMail.
-
-From SquirrelMail v.1.2.0 plugin is included in main SquirrelMail package.
-All changes are logged in main SquirrelMail changelog.
-
-2.1
-Fixes bug in when used with the 1.1.3 distro 
-
-2.0
-Adds a "try" sounds option to the Newmail plugins works with 1.1.2
-
-1.4
-Tyler Akins cleaned up the javascript and now it can change the title
-bar's text if you have new mail.  Additionally, this now correctly
-uses the new 1.1.1 validate.php format.  Uses the new
-sqimap_unseen_messages() format in 1.1.2.
-
-1.3a
-Hm. Apparently the Sent box is being used to indicate new mail when
-checking all folders.  Disabled this.  Ditto for the Trash folder
-as well.
-
-Changed the plugin name to "newmail", seeing that it really is more
-than just a sound plugin ;)
-
-
-1.3
-Now added the ability to only check for RECENT messages (those that
-have not had their information not yet looked at).  Once a message
-is "noticed", it will not show up again as recent.  Nice for
-people who want to limit the number of notifications.
-
-Also changed the popup from a javascript alert to a popup window.
-This way, it doesn't screw up the browser near as much.
-
-Finally, I added a new sub-directory called sounds.  Put in here
-any sounds you want users to choose from.  They now can choose
-from any file in that directory via a drop-down menu in the options 
-screen (or, they can still choose a local file).
-
-1.2
-Added the ability to show a popup window on new mail arrival (via a
-JavaScript function).
-
-Added the ability to check for ONLY the INBOX for unseen messages
-(the default).  Also fixed a bug in counting unseen messages. ;)
-
-1.1
-Now added the ability to turn off this feature for users who don't want
-it.  The default is NOT enabled, so you need to go to the options menu to
-turn it on.
-
-Also a nice way to reset the file back to the server default.
-
-1.0
-First release (with an option page)!
-
-0.9
-First pass-through of making a plugin.  Hack hack hack . . .
-

plugins/newmail/README

@@ -1,6 +1,3 @@
-Ok, this is my first attempt at a plugin, so excuse the mess you may find
-in here.
-
 This plugin is used to play sounds (currently a WAV file) through the
 browser whenever the user has unseen messages flagged in the left window
 pane.  There are options available (on the options page of course) to
@@ -9,51 +6,15 @@ from the users local computer.  The default is that this is NOT enabled,
 so you'll need to go to the options menu to turn it on first! There are
 also options to show a popup window via JavaScript.
 
-I tried to make this fairly simple to install.  To install the plugin:
-
-  1.  Change to the plugins directory.
-
-        $ cd plugins/
-
-  2.  Unarchive the plugin.
-
-        $ tar zxvf /your/path/to/newmail-x.x.tgz
-
-  2.  This should create a newmail/ directory under plugins.
-
-  4.  Go to the config directory and run conf.pl
-
-        $ cd ../../config/
-        $ ./conf.pl
-
-  5.  Choose option 8 and proceed to add the new plugin following
-      the instructions there.  Save and exit, and your plugin should
-      be in place.
-
-Any questions, you can let me know --
-
-Mike Huttinger
-huttinger@ipact.com
-
------------------------------------------
-
-Modifications by Tyler Akins to support changing the title bar and for the
-new 1.1.1 validate.php format.  Also uses the new sqimap_unseen_messages()
-function in 1.1.2
-
------------------------------------------
-
-Modification by Wouter Teepe from Seth Randall...
-to disallow the use of audio, change 
-    $allowsound = "true";
-to 
-    $allowsound = "false";
-on line 33 of newmail_opt.php
-
------------------------------------------
-
 From SquirrelMail 1.5.1 newmail plugin's site configuration can be stored in
 config/newmail_config.php or plugins/newmail/config.php.
 
 $allowsound setting is replaced with $newmail_allowsound and should be stored
 inside plugin's site configuration file.
+
+
+CREDITS
+
+This plugin has been originally created by Mike Huttinger, with contributions
+by Tyler Akins and Seth Randall. It's now maintained by the SquirrelMail
+Project Team.

plugins/spamcop/README

@@ -1,4 +1,4 @@
-SpamCop Reporting -- Version 1.5
+SpamCop Reporting
 
 Helps you identify spam and send a proper message to the correct address to
 SpamCop.  (See http://spamcop.net/ for more information)
@@ -30,33 +30,9 @@ This plugin is also an example of how to use the identity hooks.  Just open
 up setup.php and read the comments.
 
 
-Future Work
-===========
-
-* Dunno
-
-
 Installation
 ============
 
-As with other plugins, just uncompress the archive in the plugins
-directory, go back to the main directory, run configure and add the plugin.
-
-Questions/comments/flames/etc can be sent to the SquirrelMail Plugins list.
-
-
-Changes
-=======
-1.5 - Reworked system to match up with SpamCop changes.  Modified code to
-      keep it up-to-date with current SquirrelMail changes.
-
-1.4 - Added forms-based reporting, thanks to Stefan Sels
-
-1.3 - Fixed table rendition -- added  
+Go back to the main directory, run configure and add the plugin.
 
-1.2 - Added support for the multiple identities in SquirrelMail 1.1.2
-      (not required to use the plugin)
-      
-1.1 - Fixed a stupid bug
 
-1.0 - Initial version

plugins/squirrelspell/INSTALL

@@ -1,8 +1,7 @@
 SquirrelSpell plugin
 --------------------
 
-Untar SquirrelSpell into your squirrelmail/plugins directory. Modify the
-sqspell_config.php file making sure you have ispell or aspell
+Modify the sqspell_config.php file making sure you have ispell or aspell
 available on your system and located in PHP's path. The squirrelspell
 doesn't check for that and if it is not available, you're just going to
 get a "No errors found" message every time. :) Quite pleasing, but not

plugins/squirrelspell/doc/ChangeLog

@@ -1,84 +0,0 @@
-SQUIRRELSPELL
-
-v0.3.7
-------
-- General formatting updates, javadoc-style comments, and cleanups.
-- Potential privacy vulnerability fixed (possible symlink attack)
-- Moving some strings from .js files into .mod or .php so they can be
-  translated.
-- Miscellaneous code moves and smallish rewrites.
-
-v0.3.6
-------
-- Remote arbirtary execution as apache user vulnerability fix.
-
-v0.3.5
--------
-- Making it work with 1.1.1 broke it under 1.0.6. Decided not to support
-  developmental versions after this release.
-
-v0.3.4
--------
-- Changes to unbreak it in 1.1.1. :)
-
-v0.3.3
--------
-- Apparently, magic quotes wasn't a bug, but something introduced in 1.0.6,
-  so I took out all magic-quotes escaping routines, since it's done
-  automatically now by validate.php.
-
-v0.3.2
--------
-- Rolled back changes in v0.3.1
-- Workaround for an odd bug with PHP's magic_quotes_gpc
-- Changed trim to chop so the newline-trimming function doesn't trim
-  leading spaces.
-- Changed SOUP_NAZI to only deny Opera-4 versions
-- Moved SQSPELL_VERSION to sqspell_functions.php for easier
-  upgrades.
-
-v0.3.1
--------
-Changes to make it work with 1.0.5.
-
-v0.3
------
-Added vlink and alink settings, plus fixed some colors.
-
-v0.3b
-------
-- Major code re-organization.
-- Moved modules into separate directory.
-- Moved most JavaScript out of the main code into separate .js files
-- Created generic GUI-wrappers for most interface screens.
-- Added support for multiple international dictionaries.
-- Added MCRYPT support for encrypting the user dictionaries.
-- No longer checks lines starting with ">" (reply).
-- No longer checks anything past the "--" on a single line (signature).
-- SquirrelSpell options are now on the main OPTIONS page, not on the
-  personal options page.
-
-v0.2.1
-------
-Added a SoupNazi function. :)) Checks for bad browsers which are known not to
-work with SquirrelSpell due to their odd JavaScript.
-
-v0.2pl1
--------
-Fixed the Magic Quotes problems.
-
-v0.2
------
-Added user dictionaries.
-
-v0.1.1
--------
-Added support for aspell
-
-v0.1pl1
---------
-Fixed Magic Quotes errors.
-
-version v0.1
--------------
-Initial release.

plugins/squirrelspell/doc/README

@@ -39,7 +39,9 @@ in English.
 
 AUTHOR:
 --------
-Konstantin Riabitsev, http://www.mricon.com/
+This plugin was origintally authored by Konstantin Riabitsev
+(http://www.mricon.com/) and is now maintained by the SquirrelMail Project
+Team.
 
 SUPPORT:
 ---------

plugins/squirrelspell/doc/UPGRADING

@@ -1,15 +0,0 @@
-From version v0.2 to version v0.3
-----------------------------------
-
-The user dictionaries will be converted to v0.3 format. Once they are
-converted, you can't downgrade back to v0.2. If this scares you, backup all
-*.words files in your $data_dir somewhere safe.
-
-Files are renamed around. config.php is now sqspell_config.php. 
-
-When you are setting up SQSPELL_DEFAULT_APP in the sqspell_config, keep in 
-mind that this has to reflect whichever dictionary you used in version 0.2.
-Say, if you used "ispell -d german", you will need to specify German as 
-your SQSPELL_DEFAULT_APP so user dictionaries can be upgraded successfully.
-Otherwise wrong words will end up in a wrong dictionary.
-

plugins/translate/INSTALL

@@ -1,20 +0,0 @@
-Installing Plugins
-==================
-Simply untar the file in the plugins directory, and make sure it is
-in its own directory, and that the name of the directory is the name
-of the plugin.  Example below uses "plug_demo" as the name of the 
-plugin:
-
-  $ cd plugins
-  $ tar -zxvf /usr/archives/plug_demo.tar.gz
-
-Then go to your config directory and run conf.pl.  Choose option
-8 and add the plugin.  Save and exit, then that should be all
-if the plugin was made correctly.  :)
-
-  $ cd ../config
-  $ ./conf.pl
-
-Some plugin settings might be adjusted by creating config/translate_config.php or
-plugins/translate/config.php configuration file. See plugins/translate/config_default.php 
-and plugins/translate/config_sample.php

plugins/translate/README

@@ -1,4 +1,4 @@
-Message Translation -- Version 1.4
+Message Translation
 
 If you have ever received a mail message from someone who is not in
 your country, you probably noticed that they used a different language
@@ -50,29 +50,5 @@ Google Translate = www.google.com/translate
 Installation
 ============
 
-As with other plugins, just uncompress the archive in the plugins
-directory, go back to the main directory, run configure and add the plugin.
+Go back to the main directory, run configure and add the plugin.
 
-Questions/comments/flames/etc can be sent to the SquirrelMail Plugins list
-
-
-Changes
-=======
-  * Plugin included into SquirrelMail distribution
-  * Added site configuration options
-
-1.3 -> 1.4
-  * Modified to use new option page hook.
-    Paul Joseph Thompson <captbunzo@squirrelmail.org>
-
-1.2 -> 1.3
-  * Stupid bugfix.  :-)
-
-1.1 -> 1.2
-  * HTML changed to look better
-
-1.0 -> 1.1
-  * Added more servers
-  * Added better language handling
-  * You have to pick a server, but you can choose not to have the box
-  * Added better support for direction of translation