Welcome to ArchWay
------------------

ArchWay is a GNU Arch GUI.  It follows the unix tradition of small tools
doing their work well and cooperating nicely with each other.

This is the initial version 0.1.0.  Some users reported core dumps on
certain operations, we will try to work around these problems later.
Your feedback is welcome.  Please read TODO before making feature requests.

Some tips: in a working tree, run "archelf" to operate on project files;
run "archmag" to manage tree merges; run "archeye ." to view tree changes;
run "archeye ,,undo-1" to view any changeset; run "archrog" to manage
registered archives and search for new archives; and so on.

Alternativelly, just run "archway" and choose the desired tools from there.
Set environment variable ARCHWAY_NO_IMAGES=1 if you find images annoying.


Verify dependencies
-------------------

Please run "make". This roughly checks you have all needed dependancies.


How to install
--------------

Please run "make" to get a short explanation.


ArchWay information
-------------------

The archway development may be browsed using archzoom:

  http://archzoom.sourcecontrol.net/demo/migo@homemail.com--Perl-GPL/archway?expand

Unlike other GUIs for Arch, this one is a combination of:

  * GNU GPL
  * GTK2
  * Perl

That means freedom, portability and power.

Names used in ArchWay:

Executable | Title     | Label             | Remarks
-----------+-----------+-------------------+--------------------------------
  archway  | ArchWay   | Main Dispatcher   | loads all other interfaces
  archeye  | ArchEye   | Changeset Viewer  | lists modified files, diffs
  archelf  | ArchElf   | Project Tree      | changes, add, update, commit
  archmag  | ArchMage  | Project Merges    | partners, missing, star-merge
  archero  | ArchHero  | Personal Info     | my-id, hats
  archaos  | ArchChaos | Conflict Resolver | *.rej. *.orig
  archgen  | ArchGenie | Branch Graph      | branch/merge ancestry
  archang  | ArchAngel | Archive Browser   | abrowse, archive-setup
  archrog  | ArchRogue | Archive Registry  | local and world-wide archives

Please read the files in doc/ directory for additional information.

Home Page: http://www.nongnu.org/archway/

