info: Show some basic information about the current repository
Usage:
eg info [/PATH/TO/REPOSITORY]
Description:
Shows information about the specified repository, or the current
repository if none is specified.
Most of the output of eg info is self-explanatory, but some fields
benefit from extra explanation or pointers about where to find related
information. These fields are:
Total commits
The total number of commits (or revisions) found in the repository.
eg log can be used to view revision authors, dates, and commit log
messages.
Local repository
eg has a number of files and directories it uses to track your data,
including (by default) a copy of the entire history of the project.
These files and directories are all stored below a single directory,
referred to as the local repository. See 'eg help topic storage' for
more details.
Named remote repositories
To make it easier to track changes from multiple remote repositories,
eg provides the ability to provide nicknames for and work with
multiple branches from a remote repository and even working with
multiple remote repositories at once. See 'eg help remote' for more
details, though you will want to make sure you understand 'eg help
pull' and 'eg help push' first.
Current branch
All development is done on a branch, though smaller projects may only
use one branch per repository (thus making the repository effectively
serve as a branch). In contrast to cvs and svn which refer to
mainline development as "HEAD" and "TRUNK", respectively, eg
calls the mainline development a branch as well, with the default
name of "master"). See 'eg help branch' and 'eg help topic
storage' for more details.
Cryptographic checksum
Each revision has an associated cryptographic checksum of both its
contents and the revision(s) it was derived from, providing strong
data consistency checks and guarantees. These checksums are shown in
the output of eg log, and serve as a way to refer to revisions. See
also 'eg help topic storage' for more details.
Default pull/push configuration options:
The default repository to push to or pull from defaults to 'origin',
if the 'origin' remote has been set up (see 'eg help remote' for
setting up remote repository nicknames).
However, the default repository can be set on a per-branch basis as a
configuration option (see 'eg help config'). In fact, a number of
default pull/push actions can be set as per-branch configuration
options: default merge options to use on a given branch, default
branch to merge with from the remote repository, and whether to
rebase (rewrite local commits on top of new remote commits; see 'eg
help rebase') rather than merge (keep local commits as they are and
just make a merge commit combining local and remote changes; see 'eg
help merge').
Differences from git info:
eg info is unique to eg; git does not have a similar command. It
originally was intended just to do something nice if svn converts happen
to try this command, but I have found it to be a really nice way of
helping users get their bearings. It also provides some nice statistics
that git users may appreciate (particularly when it comes time to fill
out the Git User Survey).