Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

* Small updates to make running text in README* files more fluent

* Removed some ^R characters in file LICENSE
  • Loading branch information...
commit a8de9d56237b959c0cffba7cfe4fb0938d08f338 1 parent 63d37da
Davor Ocelic docelic authored
Showing with 65 additions and 35 deletions.
  1. +5 −5 LICENSE
  2. +42 −21 README
  3. +16 −7 README.cvs
  4. +2 −2 UPGRADE
10 LICENSE
View
@@ -55,7 +55,7 @@ patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
-
+
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
@@ -110,7 +110,7 @@ above, provided that you also meet all of these conditions:
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
-
+
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
@@ -168,7 +168,7 @@ access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
-
+
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
@@ -225,7 +225,7 @@ impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
-
+
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
@@ -278,4 +278,4 @@ PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
-
+
63 README
View
@@ -10,27 +10,46 @@ Copyright (C) 1996-2002 Red Hat, Inc.
Originally based on Vend 0.2 and 0.3, copyright 1995-96 by Andrew M. Wilcox.
This program is offered without warranty of any kind.
-See the file LICENSE for redistribution terms.
+See file LICENSE for redistribution terms.
-----------------------------------------------------------------------------
-Interchange is a full-featured web application server with
-online ordering; real-time credit card processing hooks; high-end
-database access and retrieval with SQL support; product categorizing,
-merchandising, and discounting; basic customer relationship management;
-dynamic content presentation; content management; internationalization
-and localization support; real-time tax and shipping hooks; reporting;
-and web-based administration.
-
-Interchange absolutely REQUIRES Perl 5.6.0 or later on a Unix-like operating
+Interchange is a web application server, electronic catalog and database
+display system. Features include:
+
+ * online ordering
+ * real-time credit card processing hooks
+ * high-end database access and retrieval with SQL support
+ * product categorizing, merchandising, and discounting
+ * basic customer relationship management
+ * dynamic content presentation
+ * content management
+ * internationalization and localization support
+ * real-time tax and shipping hooks
+ * reporting
+ * possibility of web-based administration
+
+Interchange absolutely REQUIRES Perl 5.6.0 or later, on a Unix-like operating
system.
+Interchange also requires some non-standard Perl modules to be installed on
+your system. Unless you are installing from distribution-specific packages
+(Red Hat, Debian, ...), the quick way to install the necessary support is to
+run:
+
+ perl -MCPAN -e 'install "Bundle::Interchange"'
+
+If you would like to use a specific version of Perl, simply invoke
+Perl with an absolute path to the Perl binary, such as
+
+ /usr/local/bin/perl -MCPAN -e 'install "Bundle::Interchange"'
+
-----------------------------------------------------------------------------
More information is in the following files and directories:
-LICENSE The text of the GNU General Public License (GPL) under which
- Interchange is supplied.
+LICENSE The text of the GNU General Public License (GPL), under which
+ the Interchange software is distributed.
README.rpm-dist Notes on using Interchange when installed from RPM packages.
@@ -38,23 +57,24 @@ README.debian Notes on using Interchange when installed from Debian packages.
README.cvs How to access the CVS repository to track ongoing development.
-WHATSNEW Changes per version for this version family.
+WHATSNEW-* Changes per specified version family.
UPGRADE Instructions on how to upgrade from an earlier Interchange
version.
-----------------------------------------------------------------------------
-Major files/directories in the distribution:
+Major files and directories in the distribution:
Makefile.PL Script to create a Makefile, used for installation.
+ (run ./configure for usage instructions)
dist/ The distribution files, exclusive of executable
files and modules. Includes:
- interchange.cfg.dist Distribution interchange.cfg
+ interchange.cfg.dist Distribution-default interchange.cfg
standard/ Demo catalog skeleton, used by makecat
- src/ C and Perl code for CGI links
+ src/ C and Perl code for CGI link programs
lib/ Back-end administrative interface
code/ Usertags and other customizable code
@@ -104,7 +124,7 @@ as described in the next section.
D E M O
-There is a demo catalog skeleton included called 'standard'.
+There is a demo catalog skeleton (called 'standard') included.
To build your own catalog from the demo, go to the directory where you
installed Interchange (default is "interchange" in your home directory,
@@ -114,7 +134,7 @@ for RPM installations) and run:
bin/makecat
Follow the prompts and after restarting the Interchange server you
-should be able to access the demo catalog.
+should be able to access the new instance of the demo catalog.
Please note that some functionality (notably the reporting features)
may not be available if you are not using an SQL database such as
@@ -130,7 +150,8 @@ A documentation package is available, with documentation in many different
formats. This and other information is available at the Interchange home on
the web:
- http://www.icdevgroup.org/
+http://www.icdevgroup.org/
+http://www.icdevgroup.org/xmldocs/
-----------------------------------------------------------------------------
@@ -138,8 +159,8 @@ the web:
Interchange is regularly tested on various Linux distributions and FreeBSD.
It has also been used on Mac OS X, Solaris, OpenBSD, Digital UNIX/Tru64, SCO,
-AIX, and other Unix variants. It should work on any Unix with Perl 5.6.0 or
-higher and the necessary Perl modules.
+AIX, and other Unix variants. It should work on any Unix with sufficiently
+high Perl version number and the necessary Perl modules.
-----------------------------------------------------------------------------
23 README.cvs
View
@@ -12,7 +12,14 @@ changes before incorporating. Better yet, don't use CVS changes for
anything but fixing present bugs, and run the latest release.
-Check out a local copy
+Browse CVS tree online
+----------------------
+
+To browse Interchange CVS contents online, simply point your web
+browser to http://www.icdevgroup.org/cgi-bin/cvsweb/interchange/ .
+
+
+Check-out a local copy
----------------------
You need to have CVS installed on your system, to begin with. It
@@ -79,14 +86,14 @@ If you want to see how your current working files compare to the versions
you checked out from the repository, cd into your checked out CVS copy and
do:
- cvs diff | more
+ cvs diff -d | less
Updating
--------
To update the distribution, change to your checked out CVS directory
-(e.g. src/interchange), then run:
+(e.g. src/interchange), and then run:
$ cvs update -Pd
U MANIFEST
@@ -142,17 +149,19 @@ It is highly recommended that you create a .cvsrc file in your home
directory to automatically use common options such as these:
cvs -z3 -q
- diff -u
+ diff -du
update -Pd
checkout -P
This directs CVS to (1) automatically compress all data communicated
between you and our server (saving bandwidth) and be quiet (printing
-out fewer diagnostic messages); (2) show context-sensitive diffs;
-(3) prune empty directories and create any new directories added to
-the repository since your checkout; and (4) prune empty directories
+out fewer diagnostic messages); (2) show context-sensitive, recursive
+diffs; (3) prune empty directories and create any new directories added
+to the repository since your checkout; and (4) prune empty directories
during your checkouts.
Please see the CVS website for complete documentation:
http://www.cvshome.org/
+
+
4 UPGRADE
View
@@ -37,8 +37,8 @@ WARNING: BACK UP EVERYTHING BEFORE YOU START!
tar czvf ~/ic_backup.tar.gz /usr/local/interchange
- 2. Unpack the new version of the software and change
- to that directory.
+ 2. Unpack the new version of the software to a temporary directory,
+ and change to that directory.
tar xzf interchange-5.x.x.tar.gz
cd interchange-5.x.x
Please sign in to comment.
Something went wrong with that request. Please try again.