Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Numerous 4.5.6 changes.

  • Loading branch information...
commit 693b281f4a8c2242831eed9ea9d1627bfb6e2231 1 parent 3fe6453
@jonjensen jonjensen authored
Showing with 98 additions and 87 deletions.
  1. +98 −87 README
View
185 README
@@ -1,28 +1,29 @@
-# 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,
@@ -30,26 +31,26 @@ 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,45 +61,55 @@ 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
--------------------
@@ -106,13 +117,45 @@ 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.
+
+-------------------------------------------------------------------
Please sign in to comment.
Something went wrong with that request. Please try again.