@need 3200

@node Summary of the Examples
@chapter Summary of the Examples

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


@strong{Setting Your arch User ID} See @ref{Introducing Yourself to arch}.

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

@strong{Creating a New Archive} See @ref{Creating a New Archive}.

@example
@group
        % larch make-archive lord@@emf.net--2003-example \
                             ~/@{archives@}/2003-example
@end group
@group
@end group
@end example
@example
@group
        % larch my-default-archive lord@@emf.net--2003-example
        default archive set (lord@@emf.net--2003-example)
@end group
@group
@end group
@end example
@example
@group
        % larch my-default-archive
        lord@@emf.net--2003-example
@end group
@group
@end group
@end example
@example
@group
        % larch archives
        lord@@emf.net--2003-example
                /home/lord/@{archives@}/2003-example
@end group
@group
@end group
@end example
@example
@group
        % larch whereis-archive lord@@emf.net--2003-example
        /home/lord/@{archives@}/2003-example
@end group
@group
@end group
@end example

@strong{Starting a New Project}  See @ref{Starting a New Project}.

@example
@group
        % larch make-category hello-world
        % larch make-branch hello-world--mainline
        % larch make-version hello-world--mainline--0.1
@end group
@group
@end group
@end example
@example
@group
        % larch categories
        hello-world
@end group
@group
@end group
@end example
@example
@group
        % larch branches hello-world
        hello-world--mainline
@end group
@group
@end group
@end example
@example
@group
        % larch versions hello-world--mainline
        hello-world--mainline--0.1
@end group
@group
@end group
@end example

@strong{Starting a New Source Tree} See @ref{Starting a New Source Tree}.

@example
@group
        % cd ~/wd/hello-world
@end group
@group
@end group
@end example
@example
@group
        % larch init-tree hello-world--mainline--0.1
@end group
@group
@end group
@end example
@example
@group
        % larch tree-root
        /usr/lord/wd/hello-world
@end group
@group
@end group
@end example
@example
@group
        % larch tree-version
        lord@@emf.net--2003-example/hello-world--mainline--0.1
@end group
@group
@end group
@end example

@strong{Project Tree Inventories} See @ref{Project Tree Inventories}.

@example
@group
        % larch inventory --source
        [....]
@end group
@group
@end group
@end example

@strong{Inventory Tags for Source} See @ref{Inventory Tags for Source}.

@example
@group
        % larch tagging-method implicit
@end group
@group
@end group
@end example
@example
@group
        % larch tagging-method
        implicit
@end group
@group
@end group
@end example

@strong{Importing the First Revision} See @ref{Importing the First Revision}.

@example
@group
        % cd ~/wd/hello-world
@end group
@group
@end group
@end example
@example
@group
        % larch make-log
        ++log.hello-world--mainline--0.1--lord@@emf.net--2003-example
@end group
@group
@end group
@end example
@example
@group
        [edit the log message adding a summary and message body]
@end group
@group
@end group
@end example
@example
@group
        % larch import
        [....]
@end group
@group
@end group
@end example
@example
@group
        % larch revisions hello-world--mainline--0.1
        base-0
@end group
@group
@end group
@end example

@strong{Checking-in Changes} See @ref{Checking-in Changes}.

@example
@group
        % cd ~/wd/hello-world
@end group
@group
@end group
@end example
@example
@group
        % larch make-log
        ++log.hello-world--mainline--0.1--lord@@emf.net--2003-example
@end group
@group
@end group
@end example
@example
@group
        [edit the log message adding a summary and message body]
@end group
@group
@end group
@end example
@example
@group
        % larch commit
        [....]
@end group
@group
@end group
@end example
@example
@group
        % larch revisions hello-world--mainline--0.1
        base-0
        patch-1
@end group
@group
@end group
@end example
@example
@group
        % larch revisions --summary hello-world--mainline--0.1
        base-0
            initial import
        patch-1
            Fix bugs in the "hello world" string
@end group
@group
@end group
@end example

@strong{Retrieving Earlier Revisions} See @ref{Retrieving Earlier Revisions}.

@example
@group
        % larch get hello-world--mainline--0.1 hello-world
        [...]
@end group
@group
@end group
@end example
@example
@group
        % larch get hello-world--mainline--0.1--base-0 hello-world-0
@end group
@group
@end group
@end example

@strong{Shared and Public Archives} see @ref{Shared and Public Archives}. 


HTTP and WebDAV archives:

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

FTP archives:

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

@strong{The update and commit Style:} See @ref{The update/commit Style of Cooperation}.

@example
@group

@end group
@group
        % larch whats-missing
        patch-2
@end group
@group

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

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

@end group
@end example

@strong{Changesets} See @ref{Introducing Changesets} and @ref{Exploring Changesets}.

@example
@group
        % larch mkpatch ORIGINAL MODIFIED DESTINATION
@end group
@group
@end group
@end example
@example
@group
        % larch dopatch PATCH-SET TREE
@end group
@group
@end group
@end example
@example
@group
        % larch get-patch hello-world--mainline--0.1--patch-1 patch-1
@end group
@group
@end group
@end example
@example
@group
        % larch patch-report --diffs patch-1
@end group
@group
@end group
@end example

@strong{The replay Command} See @ref{Introducing replay -- An Alternative to update}.

@example
@group
        % larch replay --in-place .
@end group
@group
@end group
@end example

@strong{Selected Files commit} See @ref{Selected Files Commit}.

@example
@group
        % larch commit --files -- file-a.c file-b.c
@end group
@group
@end group
@end example

@strong{Elementary Branches} See @ref{Elementary Branches -- Maintaining Private Changes}.

@example
@group
    % larch tag \
        lord@@emf.net--2003-example/hello-world--mainline--0.1--patch-1 \
        hello-world--candice--0.1
@end group
@group
@end group
@end example
@example
@group
   % larch archive-cache-revision hello-world--candice--0.1--base-0
@end group
@group
@end group
@end example
@example
@group
   % larch archive-cached-revisions hello-world--candice--0.1
@end group
@group
@end group
@end example
@example
@group
   % larch log-for-merge
@end group
@group
@end group
@end example



