baz(1)

NAME

baz - arch command line client tool

SYNOPSIS

baz command [ command_options ]
baz command [-h|--help|-H]
baz [-h|--help|-H|-V|--version]

DESCRIPTION

baz is an implementation of arch .

Arrayall significant contributors. Instead, each contributor can have
their own archive for their work. arch seamlessly operates
across archive boundaries.

COMMAND OVERVIEW

Arraybaz replay [options] [version/revision...]

apply revision changesets to a project tree

baz apply-delta [options] FROM(REVISION|DIR)

TO(REVISION|DIR)

Arraybaz library-add [options] revision

add a revision to the revision library

baz library-remove [options] revision

remove a revision from the revision library

baz library-archives [options]

list the archives in your revision library

baz library-categories [options] [archive]

list the categories in your revision library

baz library-branches [options] [category]

list the branches in a library category

baz library-versions [options] [branch]

list the versions in a library branch

baz library-revisions [options] [version]

list the revisions in a library version

baz library-log [options] revision

output a log message from the revision library

baz library-file [options] file revision

find a file in a revision library

Cache Commands

baz cache-config [options] [dir]

Print or change your cache settings

Published Revisions Commands

baz grab [options] location

grab a published revision

Miscellaneous Scripting Support

baz parse-package-name [options] name

parse a package name

baz valid-package-name [options] name

test a package name for validity

baz escape [--unescaped] string

print strings in escaped or unescaped form

HELP

Arraybaz $cmd -H

USER COMMANDS

ArrayYour default archive is determined this way:

ArrayPrint the registered location of an archive.

ArrayPrint a list of registered archives and their locations

Arraydetails to ~/.arch-params/archives. After upgrading, the previous
configuration details are saved in ~/.arch-params/upgraded-bybaz-1.3/
If an archive cannot be connected to, its configuration

details are left untouched

PROJECT TREE COMMANDS

ArrayIf DIR is not specified, "." is assumed.

ArrayIf --no-output is specified, the patch set is not saved.

ArrayNote: baz automatically switches to the _latest_ revision

in the supplied version.

PROJECT TREE INVENTORY COMMANDS

Arraysections and files.
The options -d, -f, and -b cancel each other.

The options --nested and --no-recursion cancel each other.

ArrayUsage: baz mv [options] from to OR from1 from2 ... dir

ArrayWith no arguments, print the previously set ID-PREFIX.

Arraybaz inode-sig

output the inode signature for a source tree.

Usage: baz inode-sig [options] [dir]

PATCH SET COMMANDS

ArraySee also "baz changeset -H".

baz show-changeset

generate a report from a changeset

Usage: baz show-changeset [options] [dir]

--diffs include diff output
--unescaped show filenames in unescaped form

Produce a human-readable summary of a changeset.

ARCHIVE TRANSACTION COMMANDS

Arraybe copied to TO. If LIMIT is a revision, then cached revisions
will be copied and deleted to TO.
(see "baz make-archive -H".).

ARCHIVE COMMANDS

Arrayfunction is to repair .listing files in archives that use them.

PATCH LOG COMMANDS

Arrayname to be printed.
baz new-merges

list tree patches new to a version

Usage: baz new-merges [options] [[archive]/version]

-A, --archive Override `my-default-archive´
-d, --dir DIR cd to DIR first
-r, --reverse sort from newest to oldest

List all patch log entries in the tree containing DIR that

have not already been merged with VERSION.

MULTI-PROJECT CONFIGURATION COMMANDS

Arraying file if --force is provided).

COMMANDS FOR BRANCHING AND MERGING

ArrayTREE is the project tree into which the merge will occur.

Arraydirectory. If you would like a report instead,
append the --diffs option

LOCAL CACHE COMMANDS

Arraytree
baz find-pristine

find and print the path to a pristine revision

Usage: baz find-pristine [options] revision

-A, --archive Override `my-default-archive´
-d, --dir DIR cd to DIR first
-s, --silent exit status only

Print the location of a pristine copy of the indicated re

vision

REVISION LIBRARY COMMANDS

Arraymessage and exit with non-0 status.

CACHE COMMANDS

ArrayWith an argument, record DIR as the path to your

With the option -d (--disable) and no argument, disable

caching and forget the cache directory

PUBLISHED REVISIONS COMMANDS

ArrayGrabs a published revision from LOCATION.

ArrayTarget-Config: [optional][A configuration to build

upon grabbing]

MISCELLANEOUS SCRIPTING SUPPORT

ArrayOptions -v and -l cancel -b and vice versa.

Option -l implies -v.

Arraybaz escape

print strings in escaped or unescaped form

Usage: baz escape [--unescaped] string

--unescaped show filenames in unescaped form

Using Pika escaping rules.

ENVIRONMENT

Array$http_proxy has higher priority than $HTTP_PROXY. If unset, no proxy is used.
TMPDIR If $TMPDIR is set, arch creates temporary files in

the given directory. Otherwise, it uses `/tmp´.

FILES

${HOME}/.arch-cache/

Directory where arch caches archive data

${HOME}/.arch-params/

Directory where all the user´s settings are stored.

${HOME}/.arch-params/hook

Hook script called after every execution of baz.

${HOME}/.arch-params/signing/

Directory where the commands for signing and check

ing signatures are stored.

SEE ALSO

Array1.4.2 2006-11-22

baz(1)