Skip to content
Browse files

Numerous 4.5.6 changes.

  • Loading branch information...
1 parent 3fe6453 commit 693b281f4a8c2242831eed9ea9d1627bfb6e2231 @jonjensen jonjensen committed Sep 25, 2000
Showing with 98 additions and 87 deletions.
  1. +98 −87 README
View
185 README
@@ -1,55 +1,56 @@
-# Interchange V4.5.x
-#
-# Copyright (C) 1996-2000 Akopia, Inc. <info@akopia.com>
-#
-# Originally based on Vend 0.2
-# Copyright 1995 by Andrew M. Wilcox
-#
-# Portions from Vend 0.3
-# Copyright 1995,1996 by Andrew M. Wilcox
-#
-# 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.
-#
-# You should have received a copy of the GNU General Public
-# License along with this program; if not, write to the Free
-# Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
-# MA 02111-1307 USA.
+Interchange V4.5.6
+
+Copyright (C) 1996-2000 Akopia, Inc. <info@akopia.com>
+
+Originally based on Vend 0.2
+Copyright 1995 by Andrew M. Wilcox
+
+Portions from Vend 0.3
+Copyright 1995,1996 by Andrew M. Wilcox
+
+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.
+
+You should have received a copy of the GNU General Public
+License along with this program; if not, write to the Free
+Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+MA 02111-1307 USA.
+
Welcome to Interchange! This program is completely unsupported, without
warranty of any kind. The author is interested in problems, suggestions,
or comments, but does not have time to offer free individual support
in most cases. See the Interchange website at http://www.akopia.com/
for more information.
---------------------------------------------------------------
+-------------------------------------------------------------------
I N T E R C H A N G E
- Interchange is a full-featured electronic catalog system (commonly known
- as a shopping cart) with online ordering capability. It is a high-end
- database access and retrieval system with SQL support via the Perl DBI.
+Interchange is a full-featured electronic catalog system (commonly known
+as a shopping cart) with online ordering capability. It is a high-end
+database access and retrieval system with SQL support via the Perl DBI.
- A full list of its features is available at:
+A full list of its features is available at:
http://www.akopia.com/
-IMPORTANT NOTE: Interchange 4.5.x requires, repeat REQUIRES, Perl 5.005 or Perl 5.6.
+IMPORTANT NOTE: Interchange 4.5.6 absolutely REQUIRES Perl 5.005 or Perl 5.6.
The information you need is in the following files:
- README Copyright info, roadmap to installation
+ README This file: Copyright info, roadmap to installation
and pointers to support system
- Copying Your Interchange license -- please read.
+ LICENSE Your Interchange license -- please read.
QuickStart Document to help you install Interchange
@@ -60,59 +61,101 @@ The information you need is in the following files:
Major files/directories in the distribution:
- Makefile.PL The installation scripts
+ Makefile.PL The installation script.
dist/ The distribution files, exclusive of executable
files and modules. Includes:
- minivend.cfg.dist Distribution minivend.cfg
- barry/ The "barry" catalog demo application.
- simple/ The not so aptly named "simple" demo
- application.
- src/ C and Perl code for CGI links
- compat/ Some Minivend-3 compatibility tags
- lib/ User interface
- usertag/ Some fairly-standard usertags
+ interchange.cfg.dist Distribution interchange.cfg
+ construct/ The "barry" catalog demo application.
+ src/ C and Perl code for CGI links
+ lib/ User interface
+ usertag/ Some fairly-standard usertags
extra/ Some not-always-needed Perl libraries.
lib/ The library modules needed to run Interchange.
-
- scripts/ The executable files, relocated to bin in the run
+
+ pod/ Manual pages, viewable with perldoc.
+
+ scripts/ The executable files, relocated to bin/ in the run
directory.
test.pl The installation test script.
- win/ Windows-specific files
+-------------------------------------------------------------------
UNIX INSTALLATION
------------------
Here is the short version:
- gzip -dc interchange-4.x.x.tar.gz | tar xvf -
- cd interchange-4*
+ gzip -dc interchange-4.5.6.tar.gz | tar xvf -
+ cd interchange-4.5.6
+ ./configure
+
+The 'configure' script is basically a shortcut for:
+
perl Makefile.PL
make
make test && make install
--- WHEN IN DOUBT, RE-START THE SERVER. It won't take but a few
- seconds, and changes in configurable options don't take effect
- until it is done. You may even change a page and not see the
- effect until the server is restarted.
+Then you will need to make your first Interchange catalog. See the
+section 'DEMO' below.
+
+Remember to check http://developer.akopia.com/ for documentation and
+help from other users if you have any trouble.
+
+PLEASE NOTE:
+After making configuration changes, make sure to restart the server.
+It won't take but a few seconds, and changes in configurable options
+don't take effect until it is done. You may even change a page and not
+see the effect until the server is restarted.
WINDOWS INSTALLATION
--------------------
Interchange will not yet run reliably on Windows.
-------------------------------------------------------------------
+ D E M O
+
+There is a demo application included called "construct".
+
+To install the demo, go to the directory where you installed Interchange
+(default is "interchange" in your home directory, /usr/local/interchange
+for root installations, or /usr/lib/interchange for RPM installations)
+and run:
+
+ bin/makecat construct
+
+ or
+
+ bin/makecat any_id_you_pick
+
+Follow the prompts and after restarting the Interchange server you
+should be able to access the demo catalog.
+
+-------------------------------------------------------------------
+
+ D O C U M E N T A T I O N
+
+The documentation is in several man pages and HTML files in the doc/
+subdirectory of the main Interchange directory.
+
+There is extended documentation available at
+http://developer.akopia.com/
+which includes user-annotated documentation, HTML versions of the manual,
+and a user-contributed code library.
+
+-------------------------------------------------------------------
+
A V A I L A B I L I T Y
A N D
C O M P A T I B I L I T Y
-Interchange 4 has been tested on Solaris 2, Linux, FreeBSD, and Digital
+Interchange 4 has been tested on Linux, FreeBSD, Solaris 2.x, and Digital
UNIX/Tru64. Its predecessor Minivend 3 also reportedly runs on SCO, AIX,
-and other Unix ports. It should work on any UNIX or Win32 OS with Perl
+and other Unix ports. It should work on any UNIX or Win32 OS with Perl
5.005 or higher.
IMPORTANT NOTE FOR BSD USERS: Interchange has been known to segfault when
@@ -128,40 +171,6 @@ not yet tested to run on Windows; the canonical installation is UNIX.
-------------------------------------------------------------------
- D E M O
-
-There are two demo applications included; one is not so aptly named "simple",
-the other is "barry".
-
-To install the demo, go to the directory where you installed
-Interchange (default is "interchange" in your home directory or
-/usr/local/interchange for root installations) and run:
-
- bin/makecat barry
-
- or
-
- bin/makecat simple
-
- or
-
- bin/makecat any_id_you_pick
-
-Follow the prompts and after restarting the Interchange server you
-should be able to access the demo catalog.
-
--------------------------------------------------------------
-
- D O C U M E N T A T I O N
-
-The documentation is in several man pages and HTML files in the doc/
-subdirectory of the main Interchange directory.
-
-There is an extended documentation package available
-at www.akopia.com.
-
--------------------------------------------------------------
-
K N O W N P R O B L E M S
BSDI, FreeBSD, Net BSD:
@@ -181,3 +190,5 @@ Apache with SUEXEC:
Windows:
Interchange will not work properly with Windows. No strategy
has been yet developed for providing reliable operation on Windows.
+
+-------------------------------------------------------------------

0 comments on commit 693b281

Please sign in to comment.
Something went wrong with that request. Please try again.