Installing the News Queue

1. Configuration
----------------
First, you'll need to edit newsq.pm.  Modify the variables in the
"Configuration Section" as appropriate:

$basepath - should be the full path to the directory you've installed the
queue into.  Presumably you're in this directory now; if so, just type
'pwd' to find the full path name.

$background, $bgcolor, $text, $link, and $vlink control the document
colors for the queue pages.  These may be omitted.

$title is the title prefix for the pages inside the queue.

$dates controls whether the queue prepends the date to the title of the
news item being uploaded.  Example:  July 4, 1997: News Stuff.  If
dates=0, the date is left off.  Default is on (1).

$fileperms - the permissions for queue-created and queue-writable files.
This is set by default to mode 666 (readable/writable by ALL) so that the
webserver process can write to your files.  Keep in mind this is highly
un-secure, and if you're on a shared server, your files could be
overwritten by another user.  If your server runs suEXEC or Cgiwrap or
other configuration that allows your CGI's to run with YOUR userid, you
should change $fileperms to 600, as it is more secure.

$currentfile and $oldfile are the full paths for current.news and
old.news, respectively.  Whenever you upload new news, it'll be stored in
current.news, and whatever used to be in current.news will be moved to
old.news.

2. Password protection
----------------------
You'll probably want to set up your newsq directory so that it requires a
password to access.  (You don't want just anyone going in and
writing/uploading news for your site.)  We've provided a skeleton
.htaccess file in the news queue directory; the contents of this file are
as such:

	AuthUserFile /path/to/newsq/.control
	AuthName "News Queue"
	AuthType Basic
	
	require valid-user

You must edit this file and change /path/to/newsq to whatever the current
path is.  (It's the same value as $basepath, above)

Next you need to create the control file and add a username/password at
least for yourself.  You'll want to do this using your server's "htpasswd"
program.  (If they don't have one, complain fiercely, then see below)  To
create the file, type:

   htpasswd -c .control yourusername
   
Provided the htpasswd program is found, you'll be prompted for your
password.

You can add more users the same way, except you'll omit the -c flag when
the file already exists:

   htpasswd .control newusername


3. Permissions
--------------
Before running the news queue for the first time, you'll need to fix the
permissions of several scripts.  We've included a program that will fix
perms all at once.  To run it, just type:
 
   ./fixperms.pl

If you get "Permission denied" when trying to run this script, you should
first type 'chmod 700 fixperms.pl'.  Then run it.
 

Troubleshooting
---------------
All of the scripts in this package look for Perl in /usr/bin/perl.  If
Perl is in some other location, you'll need to change it for every .cgi
and .pl script in this package... or persuade your friendly sysadmin to
add a symlink from /usr/bin/perl to whatever the actual location is.