interchange/

------------------------------------------------------------------------------

Tracking Interchange development in CVS

------------------------------------------------------------------------------

If you don't want to wait for an official release, you can use anonymous
CVS to follow the latest Interchange development.

WARNING: There may be bugs introduced at any time! Thoroughly test any
changes before incorporating. Better yet, don't use CVS changes for
anything but fixing present bugs, and run the latest release.


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
comes pre-installed on most free Unix-like systems if you selected
the development tools at install time. See http://www.cvshome.org/
for download locations if you don't have it.

If you are already an experienced CVS user, the information is:

CVSROOT :pserver:cvs@cvs.icdevgroup.org:/var/cvs
password (none)
module interchange

If you are not experienced with CVS, it is still easy to get going by
following these steps. First, choose a place to put the local copy you're
going to check out. A good choice is somewhere in your home directory,
probably a src/ subdirectory:

$ cd
$ mkdir src
$ cd src
$ cvs -z3 -d :pserver:cvs@cvs.icdevgroup.org:/var/cvs checkout -P interchange

It will take a while, as there are several megabytes of files to download.


Make a distribution tar file
----------------------------

If it is your first time installing Interchange from the CVS, you will want
to make a distribution tar file:

$ cd interchange
$ perl Makefile.PL nocopy
Writing Makefile for Interchange
$ make tardist
/usr/local/bin/perl -I/YOUR/PERL/LIB -MExtUtils::Manifest=manicopy,maniread \
-e "manicopy(maniread(),'interchange-4.9.x', 'best');"
mkdir interchange-5.0.0
mkdir interchange-5.0.0/dist
....
$ ls interch*.tar.gz
interchange-5.0.0.tar.gz


Unpack and install
------------------

Unpack the tar file and install as normal. See the README file and other
documentation for help. You should already be familiar with the Interchange
developer website at:

http://www.icdevgroup.org/

Make sure you don't check out your CVS copy into $HOME/interchange
and then install on top of it, since $HOME/interchange is the default
install directory.


Checking for differences
------------------------

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 | less


Updating
--------

To update the distribution, change to your checked out CVS directory
(e.g. src/interchange), and then run:

$ cvs update -Pd
U MANIFEST
U WHATSNEW
....

In many cases, the major differences in the distribution will be easily
updateable. You can copy any changed files directly to these library
directories:

lib/Vend (and all subdirectories)
lib/UI (and all subdirectories)

You should check the files:

catalog_after.cfg (infrequently updated)
catalog_before.cfg (frequently updated)
interchange.cfg.dist (infrequently updated)
usertag/* (infrequently updated)

Finally, you should check differences in the bin/* files. While they
are not as frequently updated as the lib/* files, they do change. Run
diffs against the source files in scripts/*.PL, or do another install
to a blank directory and do a diff to that.


Keeping the catalog in sync
---------------------------

If you are patterning your order methods after one of the template
catalogs, you will want to check the products/*.txt and products/*.asc
files for changes. In particular, mv_metadata.asc is used to format
and present quite a few things in the user interface. You may have
to merge the databases, but there is an automated admin UI facility
that can help you do this.


Troubleshooting
---------------

If you get a complaint that a "file is not found" when trying to do a
'make tardist' or 'make dist', that means your MANIFEST file is out of
sync with the current codebase. Just do:

rm MANIFEST
make manifest


More on CVS
-----------

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
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, 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/

Click on a directory to enter that directory. Click on a file to display its revision history and to get a chance to display diffs between revisions.

Current directory: [Local Repository] / interchange

File		Rev.	Age	Author	Last log entry
Parent Directory
Attic/ [show]
SPECS/
code/
debian/
dist/
eg/
extensions/
extra/
features/
help/
lib/
pdf/
perl/
pod/
scripts/
share/
win/
.cvsignore		2.3	4 years	mheins	* Add _allow_threads file
.gitignore		2.1	20 months	jon	Reduce noise for those of us who use Git: * Convert various .cvsignore files to...
LICENSE		2.3	2 years	pajamian	Update LICENSE with fresh copy from the FSF at http://www.gnu.org/licenses/gpl.t...
MANIFEST		2.239	8 weeks	racke	Removed spurious SQLite database configuration file.
MANIFEST.SKIP		2.6	20 months	jon	Reduce noise for those of us who use Git: * Convert various .cvsignore files to...
Makefile.PL		2.69	7 months	jon	Require Perl 5.8.5 or newer, and remove logic for various older versions. Inclu...
README		2.41	7 months	jon	Require Perl 5.8.5 or newer, and remove logic for various older versions. Inclu...
README.cvs		2.5	2 years	docelic	* Remove -d from cvs diff invocation since diff is recursive by default, as...
README.debian		2.12	2 years	racke	branches: 2.12.2; merged changes 2.11 vs 2.11.2.1 +++ 2.11.2.1 +++ etch has bee...
README.rpm-dist		1.12	8 months	jon	Bump version to 5.7.1, and update some instructions.
UPGRADE		2.33	6 months	jon	There is no INSTALL file, so mention README instead.
WHATSNEW-4.5		1.1	5 years	jon	Add separate files for each development stage of Interchange. We may want to pr...
WHATSNEW-4.7		1.2	3 years	mheins	* Remove [/page] and [/order] from a couple of obscure places.
WHATSNEW-4.9		1.2	5 years	kwalsh	* Re-created the missing 5.0.1 entries.
WHATSNEW-5.1		1.1	5 years	jon	Add separate files for each development stage of Interchange. We may want to pr...
WHATSNEW-5.3		2.23	3 years	mheins	* Updates to WHATSNEW should include most major 2005 feature additions. * If I ...
WHATSNEW-5.5		1.120	13 months	jon	Note Vend::Swish change, and upgrade ramifications of removed extra/ modules.
WHATSNEW-5.7		2.45	6 weeks	pajamian	New user_merge specialsub is run from the [user-merge] usertag. Arguments passe...
configure		2.23	13 months	jon	Update copyright year.
hints.pl		2.1	4 years	mheins	* Allow Interchange to install and run on a threaded system without manual ins...
install_lsb.pl		2.1	6 years	mheins	* Add LSB=1 option to Makefile.PL. This causes: -- Set interchange directory ...
relocate.pl		2.2	6 years	jon	Quell unneeded warnings about undef string concatenation.
test.pl		2.6	13 months	jon	Remove extra/ copied CPAN modules.