Arcv

Usage Command Examples

Usage

av -h

av -h

Put under revision control

av ^[1]

av

Puts the current working directory under revision control

av -y

Idem, but without prompting for confirmation

Check-in:

new,
modified,
removed files

av [ -m <commit message> ] ^[2]

av

av -m "bug fix 23"

Commit with log message

av -y -m "bug fix 23"

Automatic commit, no change check

av --silent -m "bug fix 23"

Commit with no output

Check out:

from the current source folder

av co [ <revision> | <release tag> | <filename>[:<revision>]] [ -o <output folder> ] ^[2]

av co 0 -o /tmp

Check out revision 0 in /tmp

av co R1.0.0 -o /tmp

Check out tag R1.0.0 in /tmp

av -y co "test_report.txt"

Restore a file from head revision

av co

Check out/restore head revision of current source folder

Check out:

from the specified source folder of the repository

av co … [ --source=<directory name> ]

av co --source=arcv

Check out head revision of source 'arcv' into the current directory ^[3]

av co R1.0.0 --source=arcv

Check out tag R1.0.0 of source 'arcv' into the current directory ^[3]

av co 2 --source=arcv

Check out 0 revision 2 of source 'arcv' into the current directory ^[3]

av co --source=arcv -o /tmp

Check out head revision of source 'arcv' into /tmp folder

Create a branch

av <branch folder>[:<revision> | <release tag>] [ -o <output folder> ] ^[2]

av branch fundev

Create a new source folder 'fundev' in the parent directory, derived from the head revision

av branch fundev:2

Create a new source folder 'fundev' in the parent directory, derived from revision 2

av branch fundev:R1.0.0

Create a new source folder 'fundev' in the parent directory, derived from the tagged release R.1.0.0

av branch fundev:0 -o /tmp/

Create a new source folder 'fundev' in the /tmp directory, derived from revision 0

Status polling

av check [ --verbose ] ^[2]

av check

Returns 0 if there are no changes, 1 otherwise

Listing new, removed and modified files

av ^[2]

`av`	Type 'q' to quit changed file menu if necessary, then enter 'a' or 'CTRL-C' to abort.

Display current revision

av rev ^[2]

av rev

Outputs '2' if revision 2 is the head.

Display current hash signature

av hash ^[2]

av hash

Outputs the SHA256 fingerprint in hexadecimal

Compute and display hash signature of a random folder

av hash <directory>

av hash /tmp/arcv-rev1

Computes and outputs the SHA256 fingerprint of a revision 1 checkout of the 'arcv' source folder

Show the revision history

av log [ --verbose ] ^[2]

av log

Shows all the revison log messages from most recent to oldest

av log --verbose

Shows all the revison log messages including changed files from most recent to oldest

Check revision history of a specific file

av log [ --verbose ] <file> ^[2]

av log file_A.txt

Shows a menu of all revisions where the file 'file_A.txt' was changed. <ENTER> to diff with previous rev, <h> to diff with head

Tag head revision as a release

av pub [ -m <log message> ] ^[2]

av pub -m "A test release 1.0.0"

Creates release tag R.1.0.0 from head revision

Check differences

av <diff tool> [ <revision> | head | current[vs<revision | release tag>] ] ^[2]

where <diff tool> is any of : diff, meld, git

av diff

Between working dir and head rev

av diff 2

Between working dir and rev 2

av diff R1.0.0

Between working dir and tag R1.0.0

av diff headvs2

Between head and rev 2

av diff 2vs0

Between rev 2 and rev 0

av diff 1vs0

Between rev 1 and rev 0

av diff 3vsR1.0.0

Between rev 3 and tag R1.0.0

Export as a tar ball

av tarball [ <revision> | head ] ^[2]

av tarball -o /tmp

Create tar for current working source directory in /tmp

av tarball head -o /tmp

Create tar for head revision in /tmp

av tarball 0 -o $HOME

Create tar for very first revision in user’s home

Export to GitHub

av export [ <directory> ] ^[2]

av export

The source folder will be copied in the 'git' subdir below the top archive directory, which is then pushed to the configured GitHub repository. See documentation for more info.

Display available sources in repository

av list

av list

Example of out:

Source           Head  Hash             Owner

arcv             152   f003f2778b1cd656 michel (1000)
arcv-test        82    ffe48281b805d5a6 michel (1000)
wwwserver        127   94ff298a1852e3f0 michel (1000)

¹ There’s no directory of the same name already in the repository
² The current working directory is under revision control, i.e. a directory of the same name as the current one is already in the repository.
³ The current working directory is assumed not to be under revision control. It is just aimed at a storing a copy of the checked out folder.