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`