This directory contains the Perl scripts for the HyperNews 1.10
system.  The version number for this copy is in the Makefile and
in setup-lib.pl.  Get the latest version of the software from:

  http://www.hypernews.org/HyperNews/get/hypernews/source.html

Read the latest installation instructions at

  http://www.hypernews.org/HyperNews/get/hypernews/installation.html

liberte@hypernews.org

Daniel LaLiberte
HyperNews Consortium
9 Juniper Ridge Road
Acton, MA  01720

Included in this distribution:
READMEthis file
LICENSELicense terms for use and redistribution of HyperNews.
hndocsDirectory of html files from www.HyperNews.org, including:
about.htmlOverview of HyperNews features and implementation.
source.htmlOverview and distribution of HyperNews.
compatibility.htmlRequirements and compatibility of HN with OSes, etc.
installation.htmlHow to install it.
features.htmlHyperNews Features
bugs.htmlMiscellaneous bugs that don't fit elsewhere.
history.htmlList of changes to previous versions of HyperNews.
future.htmlWhat might be added to HyperNews in the future.
instructions.htmlOverview of how to use HyperNews.
reading.htmlFeatures for reading messages.
adding.htmlHow to add messages.
admin.htmlHow to move and delete messages.
base-articles.htmlHow to create and edit forums.
subscribing.htmlHow to subscribe to get email for each posting.
email.htmlHow to send message to HyperNews.
usenet.htmlAbout the Usenet gatesay, which doesn't exist yet.
member.htmlHow to register and change member info.
security.htmlAll security-related issues of HyperNews.
Makefilefor packaging up a distribution and (risky?) installation
fixPerlPathchanges the first line of each script to correct perl path
setup.plthe core of the setup process.
setup-form.plgenerates a setup form to be submitted to setup.pl
setup-short-form.pla simpler version of setup-form.pl
setup-lib.plused by setup.pl and setup-form.pl.
hn-lib.plincluded by hnrc, used by everything.
log-lib.plused to write log entries when changes are made.
top.pltop level info, could be used as entry point to HyperNews.
getthe basic HyperNews article and response page generator.
get-lib.plmore 'get' stuff used only when needed.
embedan alternative viewer that embeds messages inline, used by get.
hnview.plroutines common to generating a message page.
hnview-lib.plother common routines, also used by hn-lib.pl.
icon-lib.plroutines common to icon access.
thread.plroutines for finding next and previous messages.
urcdump out just the urc file for a forum or message.
urc.plused to read and write the ",urc" and member files.
edit-article.plthe form for creating and editing forums (base articles).
add-article.plthe action for the edit-article form.
edit-response.plthe form for creating messages (responses).
edit-lib.plroutines common to editing.
add-response.plthe action for the preview-response.pl form.
add-lib.plroutines common to adding articles and responses.
response-lib.plroutines common to generating response trees.
preview-response.plform for previewing responses
preview-lib.plmore
mail-incoming.plhandler of incoming email, forwards to add-response.
batch-incoming-msgs.plsend a digest of messages to mail-incoming.pl
batch-fetch-pop-mail.plfetch POP mail and post with mail-incoming.pl
admin-responses.plcombination of move- and delete-response and more.
admin-lib.plroutines used by 'get' when in admin mode.
move-lib.plroutines for moving message trees.
delete-lib.plroutines for deleting message trees.
batch-delete-messages.pldelete a bunch of old messages in a forum.
batch-rebuild-outline.plforce a rebuild of the whole outline of a forum.
ann_cgi
ann_post_method
get_ann
annotations-lib.pl
not used yet.
view-members.pldisplay list of all members, or those matching query.
view-member.pldisplay member info for one member.
edit-member.plform for joining and editing member information.
change-member.plthe action for the edit-member.pl form.
reset-password.plform and action for resetting password.
member-lib.plused by almost everything to access membership info.
change-member-lib.plused to change members, update password file, etc.
passwd-dbm.plused by change-member-lib.pl with netscape server.
batch-add-members.pladd a bunch of members listed in a file.
edit-subscribe.plform and action for editing subscription info.
subscribe-lib.plroutines for accessing and changing subscription info.
email.plroutines that send out email.
batch-email-list.plbuild an email list of all members.
formlib.plroutines for processing form data and URL query strings.
html.plroutines for parsing and transforming HTML; we use abs
http.plroutines for fetching http URLs.
url.plroutines for parsing URLs.
html-ascii.plJim Davis' library for converting HTML to ascii
html-to-ascii.pl
parse-html.pl
tformat.pl
lock.plroutines for maintaining exclusive lock on a file or directory.
wwwdates.pldate routines from libwww-perl.
icons-table-distthe kind-of-message:icon mapping
Iconsthe directory of Icons.
ExciteCustomizations for use of Excite's search engine.