The Hackerlab at regexps.com

Summary of the Examples

up: arch Meets hello-world
next: Introducing Yourself to arch
prev: arch Commands in General

In the chapters that follow, larch subcommands are gradually introduced through a specific worked example. This chapter simply summarizes most of the commands you'll be learning:

Setting Your arch User ID See Introducing Yourself to arch.

        % larch my-id "Tom Lord <lord@emf.net>"

        % larch my-id
        Tom Lord <lord@emf.net>

Creating a New Archive See Creating a New Archive.

        % larch make-archive lord@emf.net--2003-example \
                             ~/{archives}/2003-example

        % larch my-default-archive lord@emf.net--2003-example
        default archive set (lord@emf.net--2003-example)

        % larch my-default-archive
        lord@emf.net--2003-example

        % larch archives
        lord@emf.net--2003-example
                /home/lord/{archives}/2003-example

        % larch whereis-archive lord@emf.net--2003-example
        /home/lord/{archives}/2003-example

Starting a New Project See Starting a New Project.

        % larch make-category hello-world
        % larch make-branch hello-world--mainline
        % larch make-version hello-world--mainline--0.1

        % larch categories
        hello-world

        % larch branches hello-world
        hello-world--mainline

        % larch versions hello-world--mainline
        hello-world--mainline--0.1

Starting a New Source Tree See Starting a New Source Tree.

        % cd ~/wd/hello-world

        % larch init-tree hello-world--mainline--0.1

        % larch tree-root
        /usr/lord/wd/hello-world

        % larch tree-version
        lord@emf.net--2003-example/hello-world--mainline--0.1

Project Tree Inventories See Project Tree Inventories.

        % larch inventory --source
        [....]

Inventory Tags for Source See Inventory Tags for Source.

        % larch tagging-method implicit

        % larch tagging-method
        implicit

Importing the First Revision See Importing the First Revision.

        % cd ~/wd/hello-world

        % larch make-log
        ++log.hello-world--mainline--0.1--lord@emf.net--2003-example

        [edit the log message adding a summary and message body]

        % larch import
        [....]

        % larch revisions hello-world--mainline--0.1
        base-0

Checking-in Changes See Checking-in Changes.

        % cd ~/wd/hello-world

        % larch make-log
        ++log.hello-world--mainline--0.1--lord@emf.net--2003-example

        [edit the log message adding a summary and message body]

        % larch commit
        [....]

        % larch revisions hello-world--mainline--0.1
        base-0
        patch-1

        % larch revisions --summary hello-world--mainline--0.1
        base-0
            initial import
        patch-1
            Fix bugs in the "hello world" string

Retrieving Earlier Revisions See Retrieving Earlier Revisions.

        % larch get hello-world--mainline--0.1 hello-world
        [...]

        % larch get hello-world--mainline--0.1--base-0 hello-world-0

Shared and Public Archives see Shared and Public Archives.

HTTP and WebDAV archives:

    % larch register-archive lord@emf.net--2003 \
            http://regexps.srparish.net/{archives}/lord@emf.net--2003

FTP archives:

    % larch register-archive lord@regexps.com--2002 \
            ftp://ftp.regexps.com/{archives}/lord@regexps.com--2002

The update and commit Style: See The update/commit Style of Cooperation.


        % larch whats-missing
        patch-2

        % larch whats-missing --summary
        patch-2
            commented return from main

        % larch cat-archive-log hello-world--mainline--0.1--patch-2


Changesets See Introducing Changesets and Exploring Changesets.

        % larch mkpatch ORIGINAL MODIFIED DESTINATION

        % larch dopatch PATCH-SET TREE

        % larch get-patch hello-world--mainline--0.1--patch-1 patch-1

        % larch patch-report --diffs patch-1

The replay Command See Introducing replay -- An Alternative to update.

        % larch replay --in-place .

Selected Files commit See Selected Files Commit.

        % larch commit --files -- file-a.c file-b.c

Elementary Branches See Elementary Branches -- Maintaining Private Changes.

    % larch tag \
        lord@emf.net--2003-example/hello-world--mainline--0.1--patch-1 \
        hello-world--candice--0.1

   % larch archive-cache-revision hello-world--candice--0.1--base-0

   % larch archive-cached-revisions hello-world--candice--0.1

   % larch log-for-merge

arch Meets hello-world: A Tutorial Introduction to The arch Revision Control System
The Hackerlab at regexps.com