first import of project's documentation for the webserver.
authorswa <swa@users.sourceforge.net>
Wed, 13 Jun 2001 14:20:37 +0000 (14:20 +0000)
committerswa <swa@users.sourceforge.net>
Wed, 13 Jun 2001 14:20:37 +0000 (14:20 +0000)
doc/webserver/README.txt [new file with mode: 0644]
doc/webserver/developer-manual.html [new file with mode: 0644]
doc/webserver/documentation-guidelines.html [new file with mode: 0644]
doc/webserver/faq.html [new file with mode: 0644]
doc/webserver/index.html [new file with mode: 0644]
doc/webserver/redirect.php [new file with mode: 0755]
doc/webserver/swa.css [new file with mode: 0644]
doc/webserver/testplan.html [new file with mode: 0644]
doc/webserver/user-manual.html [new file with mode: 0644]

diff --git a/doc/webserver/README.txt b/doc/webserver/README.txt
new file mode 100644 (file)
index 0000000..60680f9
--- /dev/null
@@ -0,0 +1,8 @@
+All files contained in this directory should eventually be
+on the project's homepage 
+
+   ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
+
+which is indeed http://ijbswa.sourceforge.net.
+
+-Stefan, June 2001
\ No newline at end of file
diff --git a/doc/webserver/developer-manual.html b/doc/webserver/developer-manual.html
new file mode 100644 (file)
index 0000000..3f547e0
--- /dev/null
@@ -0,0 +1,72 @@
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+<!--
+ File        :  $Source: /cvsroot/ijbswa/current/project.h,v $
+
+ Purpose     :  Developer Manualk
+                This file belongs into
+                ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
+                
+ $Id: Makefile.in,v 1.12 2001/06/12 17:15:56 swa Exp $
+
+ Written by and Copyright (C) 2001 the SourceForge
+ IJBSWA team.  http://ijbswa.sourceforge.net
+
+ Based on the Internet Junkbuster originally written
+ by and Copyright (C) 1997 Anonymous Coders and 
+ Junkbusters Corporation.  http://www.junkbusters.com
+-->
+
+<head>
+<title>Junkbuster|Developer Manual</title>
+<link rel=stylesheet type="text/css" href="swa.css">
+
+</head>
+ <body bgcolor="#ffffff"
+ topmargin="0" leftmargin="0" marginwidth = "0" marginheight = "0" 
+ text="#000000" 
+ link="#0000ff" 
+ vlink="#ff0000" 
+ alink="#ff0000"
+ >
+
+<body>
+<p>
+<br><br>
+<h1>How to quickly dive into Junkbuster Development:</h1>
+<p>
+
+<br>
+
+<hr>
+<address></address><p>
+<!-- hhmts start -->
+Last modified: Wed Jun 13 16:11:22 CEST 2001
+<!-- hhmts end -->
+</body>
+ <!--
+ This program is free software; you can redistribute it 
+ and/or modify it 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.
+
+ This program is 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.
+
+ The GNU General Public License should be included with
+ this file.  If not, you can view it at
+ http://www.gnu.org/copyleft/gpl.html
+ or write to the Free Software Foundation, Inc., 59
+ Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+
+$Log: Makefile.in,v $
+ Revision 1.12  2001/06/12 17:15:56  swa
+ fixes, because a clean build on rh6.1 was impossible.
+ GZIP confuses make, %configure confuses rpm, etc.
+
+-->
+</html>
diff --git a/doc/webserver/documentation-guidelines.html b/doc/webserver/documentation-guidelines.html
new file mode 100644 (file)
index 0000000..01f41aa
--- /dev/null
@@ -0,0 +1,87 @@
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+<!--
+ File        :  $Source: /cvsroot/ijbswa/current/project.h,v $
+
+ Purpose     :  Gives direction on writing documentation.
+                This file belongs into
+                ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
+                
+ $Id: Makefile.in,v 1.12 2001/06/12 17:15:56 swa Exp $
+
+ Written by and Copyright (C) 2001 the SourceForge
+ IJBSWA team.  http://ijbswa.sourceforge.net
+
+ Based on the Internet Junkbuster originally written
+ by and Copyright (C) 1997 Anonymous Coders and 
+ Junkbusters Corporation.  http://www.junkbusters.com
+-->
+
+<head>
+<title>Junkbuster|Documentation Guidelines</title>
+<link rel=stylesheet type="text/css" href="swa.css">
+
+</head>
+ <body bgcolor="#ffffff"
+ topmargin="0" leftmargin="0" marginwidth = "0" marginheight = "0" 
+ text="#000000" 
+ link="#0000ff" 
+ vlink="#ff0000" 
+ alink="#ff0000"
+ >
+
+<body>
+<p>
+<br><br>
+<h1>Documentation guideline:</h1>
+<p>
+All docs should be ...
+<ul>
+  <li>in a format that is widely used. I propose HTML.
+  <li>we either
+      <ul>
+       <li>generate man pages from the documentation (let's _NOT_ write them manually), or 
+       <li>we have a man page that points to the documentation (I propose
+           this option)
+      </ul>
+  <li>have a consistent layout
+  <li>have a link to the latest version of the document (i.e. point to a URL at sf)
+  <li>be consistent with the redirect script (i.e. the junkbuster program
+      points via the redirect URL at sf to valid end-points in the document)
+  <li>started from scratch but recycle parts from the original junkbuster documents
+</ul>
+
+<br>
+
+<hr>
+<address></address><p>
+<!-- hhmts start -->
+Last modified: Wed Jun 13 16:06:08 CEST 2001
+<!-- hhmts end -->
+</body>
+ <!--
+ This program is free software; you can redistribute it 
+ and/or modify it 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.
+
+ This program is 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.
+
+ The GNU General Public License should be included with
+ this file.  If not, you can view it at
+ http://www.gnu.org/copyleft/gpl.html
+ or write to the Free Software Foundation, Inc., 59
+ Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+
+$Log: Makefile.in,v $
+ Revision 1.12  2001/06/12 17:15:56  swa
+ fixes, because a clean build on rh6.1 was impossible.
+ GZIP confuses make, %configure confuses rpm, etc.
+
+-->
+</html>
diff --git a/doc/webserver/faq.html b/doc/webserver/faq.html
new file mode 100644 (file)
index 0000000..5912dcf
--- /dev/null
@@ -0,0 +1,116 @@
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+<!--
+ File        :  $Source: /cvsroot/ijbswa/current/project.h,v $
+
+ Purpose     :  FAQ
+                This file belongs into
+                ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
+                
+ $Id: Makefile.in,v 1.12 2001/06/12 17:15:56 swa Exp $
+
+ Written by and Copyright (C) 2001 the SourceForge
+ IJBSWA team.  http://ijbswa.sourceforge.net
+
+ Based on the Internet Junkbuster originally written
+ by and Copyright (C) 1997 Anonymous Coders and 
+ Junkbusters Corporation.  http://www.junkbusters.com
+-->
+
+<head>
+<title>Junkbuster|FAQ</title>
+<link rel=stylesheet type="text/css" href="swa.css">
+
+</head>
+ <body bgcolor="#ffffff"
+ topmargin="0" leftmargin="0" marginwidth = "0" marginheight = "0" 
+ text="#000000" 
+ link="#0000ff" 
+ vlink="#ff0000" 
+ alink="#ff0000"
+ >
+
+<body>
+<p>
+<br><br>
+<h1>Questions</h1>
+
+<p>
+
+Please read the <a href="http://www.junkbusters.com/ht/en/ijbfaq.html">Junkbuster FAQ</a> at <a href="http://www.junkbusters.com">Junkbuster Corp.</a> and some other docs first.
+
+<h2>Installation</h2>
+<h2>Mail accounts</h2>
+<p>
+<a href="#yahoo">How can I make my Yahoo account work?</a>
+<p>
+<a href="#hotmail">How can I make my Hotmail account work?</a>
+<p>
+<a href="#gmx">How can I make my GMX account work?</a>
+<h2>Misc</h2>
+<p>
+<a href="#ip">How can I hide my IP address?</a>
+<p>
+<a href="#image">What is the imagefile (simage.ini, etc.) for?</a>
+<h2>Removal</h2>
+
+<h1>Answers</h1>
+
+<h3><a name="yahoo"></a>How can I make my Yahoo account work?</h3>
+<p>
+to be filled
+</p>
+
+<h3><a name="hotmail"></a>How can I make my Hotmail account work?</h3>
+<p>
+to be filled
+</p>
+
+<h3><a name="gmx"></a>How can I make my GMX account work?</h3>
+<p>
+to be filled
+
+<h3><a name="ip"></a>How can I hide my IP address?</h3>
+<p>
+You cannot hide your IP address with Junkbuster.
+
+<h3><a name="image"></a>What is the imagefile (simage.ini, etc.) for?</h3>
+<p>
+Anytime the Junkbuster determines (with the help of the blocklist) that a URL
+contains an advertisement, it has to decide whether this advertisement is an
+image or not. The Junkbuster uses the imagefile for that purpose..
+
+<br>
+
+<hr>
+<address></address><p>
+<!-- hhmts start -->
+Last modified: Wed Jun 13 16:06:08 CEST 2001
+<!-- hhmts end -->
+</body>
+ <!--
+ This program is free software; you can redistribute it 
+ and/or modify it 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.
+
+ This program is 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.
+
+ The GNU General Public License should be included with
+ this file.  If not, you can view it at
+ http://www.gnu.org/copyleft/gpl.html
+ or write to the Free Software Foundation, Inc., 59
+ Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+
+$Log: Makefile.in,v $
+ Revision 1.12  2001/06/12 17:15:56  swa
+ fixes, because a clean build on rh6.1 was impossible.
+ GZIP confuses make, %configure confuses rpm, etc.
+
+-->
+</html>
diff --git a/doc/webserver/index.html b/doc/webserver/index.html
new file mode 100644 (file)
index 0000000..8e72378
--- /dev/null
@@ -0,0 +1,20 @@
+<head>
+  <meta http-equiv="refresh" content="5; URL=http://www.waldherr.org/junkbuster/">
+</head>
+
+<body bgcolor="#ffffff"
+ topmargin="0" leftmargin="0" marginwidth = "0" marginheight = "0" 
+ text="#000000" 
+ link="#0000ff" 
+ vlink="#ff0000" 
+ alink="#ff0000"
+ >
+
+<br>
+<br>
+
+<center>
+You will be <a href="http://www.waldherr.org/junkbuster/">redirected</a> in a couple of moments. This page will soon have more content.
+</center>
+
+</body> </html>
diff --git a/doc/webserver/redirect.php b/doc/webserver/redirect.php
new file mode 100755 (executable)
index 0000000..70d7e0b
--- /dev/null
@@ -0,0 +1,141 @@
+M<?php
+
+error_reporting(E_ALL);
+
+// File        :  $Source: /cvsroot/ijbswa/current/project.h,v $
+//
+// Purpose     :  redirects requests to a specific paragraph in the online docs
+//                This file belongs into
+//                ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
+//                
+// $Id: Makefile.in,v 1.12 2001/06/12 17:15:56 swa Exp $
+//
+// Written by and Copyright (C) 2001 the SourceForge
+// IJBSWA team.  http://ijbswa.sourceforge.net
+//
+// Based on the Internet Junkbuster originally written
+// by and Copyright (C) 1997 Anonymous Coders and 
+// Junkbusters Corporation.  http://www.junkbusters.com
+
+
+// Parse the v= and to= paramaters
+function parse_parameters()
+{
+   global $v, $to;
+   global $version_major, $version_minor, $version_point;
+
+   $version_major = 0;
+   $version_minor = 0;
+   $version_point = 0;
+
+   if (isset($v))
+   {
+      // Version specified
+
+      $v = trim($v);
+
+      // Check if it's valid.
+      // Valid versions have the form "n.n.n", where n=digit(s).
+      if ( (strspn($v,"0123456789.") == strlen($v)) )
+      {
+         // Probably valid.  Copy into globals.
+         $version_pieces = explode (".", $v, 4);
+         if (isset($version_pieces[0]))
+         {
+            $version_major = 0 + $version_pieces[0];
+         }
+         if (isset($version_pieces[1]))
+         {
+            $version_minor = 0 + $version_pieces[1];
+         }
+         if (isset($version_pieces[2]))
+         {
+            $version_point = 0 + $version_pieces[2];
+         }
+      }
+   }
+
+   if (isset($to))
+   {
+      // Trim whitespace and convert to lowercase.
+      $to = strtolower(trim($to));
+
+      // Restrict the characters in the string by removing everything
+      // from the first disallowed character onwards.
+      //
+      // Allowed characters are 0-9, a-z, ".", "_", "-".
+      //
+      $to = substr($to, 0, strspn($to, "0123456789abcdefghijklmnopqrstuvwxyz._-"));
+   }
+   else
+   {
+      $to = "";
+   }
+}
+
+parse_parameters();
+
+// For debugging:
+// print "Version {$version_major}.{$version_minor}.{$version_point}<br>";
+// print "Target \"{$to}\"<br>";
+
+
+// Please do NOT delete any of these redirects.  Even if you take them
+// out of JunkBuster, they may be in use by older releases.
+
+// Note 2: Should *not* include #target part in these URLs.
+// (It works with MS IE, but is not valid HTTP.)
+
+switch($to)
+{
+   case "faq":
+      // Used by 2.9.0+
+      header ("Location: http://www.junkbusters.com/ht/en/ijb2faq.html");
+      exit;
+   case "option":
+      // Used by 2.9.0+
+      // Config file options
+      // called as redirect.php?v=X.X.X&to=option#optionname
+      header ("Location: http://www.junkbusters.com/ht/en/ijb2man.html");
+      exit;
+   case "win":
+      // Used by 2.9.0+ on WIN32
+      header ("Location: http://www.junkbusters.com/ht/en/ijbwin.html");
+      exit;
+//   case "home":
+//      // Currently hard-wired into the code.
+//      header ("Location: http://ijbswa.sourceforge.net/");
+//      exit;
+//   case "gpl":
+//      // Currently hard-wired into the code.
+//      header ("Location: http://www.fsf.org/copyleft/gpl.html");
+//      exit;
+   default:
+      header ("Location: http://ijbswa.sourceforge.net/");
+      exit;
+}
+
+exit;
+?>
+
+// This program is free software; you can redistribute it 
+// and/or modify it 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.
+//
+// This program is 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.
+//
+// The GNU General Public License should be included with
+// this file.  If not, you can view it at
+// http://www.gnu.org/copyleft/gpl.html
+// or write to the Free Software Foundation, Inc., 59
+// Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+//
+//
+// $Log: Makefile.in,v $
+//
diff --git a/doc/webserver/swa.css b/doc/webserver/swa.css
new file mode 100644 (file)
index 0000000..22489e5
--- /dev/null
@@ -0,0 +1,9 @@
+body { margin-left:0px; margin-right:0px; margin-top:0px; margin-bottom:0px;}
+h1 { margin-left:20px; font-family:Helvetica,Arial; font-size:18pt;}
+h2 { margin-left:25px; font-family:Helvetica,Arial; font-size:14pt; }
+h3 { margin-left:25px; font-family:Helvetica,Arial; font-size:12pt; }
+p  { margin-left:27px; margin-right:20px; font-size:10pt; }
+# next definition removes bullets for netscape
+# li { margin-left:27px; margin-right:20px; font-size:10pt; }
+form,pre,ul,ol { margin-left:27px; margin-right:20px; font-size:10pt; }
+div,td,th,address,nobr,b,i { font-size:10pt; }
diff --git a/doc/webserver/testplan.html b/doc/webserver/testplan.html
new file mode 100644 (file)
index 0000000..ce8364d
--- /dev/null
@@ -0,0 +1,103 @@
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+<!--
+ File        :  $Source: /cvsroot/ijbswa/current/project.h,v $
+
+ Purpose     :  Provide guideance to test before release
+                This file belongs into
+                ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
+                
+ $Id: Makefile.in,v 1.12 2001/06/12 17:15:56 swa Exp $
+
+ Written by and Copyright (C) 2001 the SourceForge
+ IJBSWA team.  http://ijbswa.sourceforge.net
+
+ Based on the Internet Junkbuster originally written
+ by and Copyright (C) 1997 Anonymous Coders and 
+ Junkbusters Corporation.  http://www.junkbusters.com
+-->
+
+<head>
+<title>Junkbuster|Testplan</title>
+<link rel=stylesheet type="text/css" href="swa.css">
+
+</head>
+ <body bgcolor="#ffffff"
+ topmargin="0" leftmargin="0" marginwidth = "0" marginheight = "0" 
+ text="#000000" 
+ link="#0000ff" 
+ vlink="#ff0000" 
+ alink="#ff0000"
+ >
+
+<body>
+<p>
+<br><br>
+<h1>Testplan for releases:</h1>
+<p>
+<ol>
+  <li>Remove any existing rpm with rpm -e
+  <li>Remove any file that was left over. This includes (but is not limited
+      to)
+      <ul>
+       <li>/var/log/junkbuster
+       <li>/etc/junkbuster
+       <li>/usr/sbin/junkbuster
+       <li>/etc/init.d/junkbuster
+       <li>/usr/doc/junkbuster*
+      </ul>
+  <li>Install the rpm. Any error messages?
+  <li>start,stop,status junkbuster with the specific script
+      (e.g. /etc/rc.d/init/junkbuster stop). Reboot your machine. Does
+      autostart work?
+  <li>Start browsing. Does the junkbuster work? Logfile written?
+  <li>Remove the rpm. Any error messages? All files removed?
+</ol>
+
+<h1>Test reports:</h1>
+<p>
+Please submit test reports only with the <a href="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=395005">test form</a>
+at sourceforge. Three simple steps:
+<ul>
+  <li>Select category: the distribution you test on.
+  <li>Select group: the version of Junkbuster that we are about to release.
+  <li>Fill the Summary and Detailed Description with something intelligent
+      (keep it short and precise).
+</ul>
+<p>
+Do not mail to the mailinglist (we cannot keep track on issues there).
+
+<br>
+
+<hr>
+<address></address><p>
+<!-- hhmts start -->
+Last modified: Wed Jun 13 16:06:08 CEST 2001
+<!-- hhmts end -->
+</body>
+ <!--
+ This program is free software; you can redistribute it 
+ and/or modify it 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.
+
+ This program is 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.
+
+ The GNU General Public License should be included with
+ this file.  If not, you can view it at
+ http://www.gnu.org/copyleft/gpl.html
+ or write to the Free Software Foundation, Inc., 59
+ Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+
+ $Log: Makefile.in,v $
+ Revision 1.12  2001/06/12 17:15:56  swa
+ fixes, because a clean build on rh6.1 was impossible.
+ GZIP confuses make, %configure confuses rpm, etc.
+
+-->
+</html>
diff --git a/doc/webserver/user-manual.html b/doc/webserver/user-manual.html
new file mode 100644 (file)
index 0000000..f78159c
--- /dev/null
@@ -0,0 +1,72 @@
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+<!--
+ File        :  $Source: /cvsroot/ijbswa/current/project.h,v $
+
+ Purpose     :  User Manual
+                This file belongs into
+                ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
+                
+ $Id: Makefile.in,v 1.12 2001/06/12 17:15:56 swa Exp $
+
+ Written by and Copyright (C) 2001 the SourceForge
+ IJBSWA team.  http://ijbswa.sourceforge.net
+
+ Based on the Internet Junkbuster originally written
+ by and Copyright (C) 1997 Anonymous Coders and 
+ Junkbusters Corporation.  http://www.junkbusters.com
+-->
+
+<head>
+<title>Junkbuster|User Manual</title>
+<link rel=stylesheet type="text/css" href="swa.css">
+
+</head>
+ <body bgcolor="#ffffff"
+ topmargin="0" leftmargin="0" marginwidth = "0" marginheight = "0" 
+ text="#000000" 
+ link="#0000ff" 
+ vlink="#ff0000" 
+ alink="#ff0000"
+ >
+
+<body>
+<p>
+<br><br>
+<h1>To be filled:</h1>
+<p>
+
+<br>
+
+<hr>
+<address></address><p>
+<!-- hhmts start -->
+Last modified: Wed Jun 13 16:06:08 CEST 2001
+<!-- hhmts end -->
+</body>
+ <!--
+ This program is free software; you can redistribute it 
+ and/or modify it 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.
+
+ This program is 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.
+
+ The GNU General Public License should be included with
+ this file.  If not, you can view it at
+ http://www.gnu.org/copyleft/gpl.html
+ or write to the Free Software Foundation, Inc., 59
+ Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+
+ $Log: Makefile.in,v $
+ Revision 1.12  2001/06/12 17:15:56  swa
+ fixes, because a clean build on rh6.1 was impossible.
+ GZIP confuses make, %configure confuses rpm, etc.
+
+-->
+</html>