---

   gitweb    ( 1 )

---

ACTIONS, AND URLS

Gitweb can use path_info (component) based URLs, or it can pass all necessary information via query parameters. The typical gitweb URLs are broken down in to five components:

.../gitweb.cgi/<repo>/<action>/<revision>:/<path>?<arguments>

repo The repository the action will be performed on.

All actions except for those that list all available projects, in whatever form, require this parameter.

action The action that will be run. Defaults to projects_list if repo is not set, and to summary otherwise.

revision Revision shown. Defaults to HEAD.

path The path within the <repository> that the action is performed on, for those actions that require it.

arguments Any arguments that control the behaviour of the action.

Some actions require or allow to specify two revisions, and sometimes even two pathnames. In most general form such path_info (component) based gitweb URL looks like this:

.../gitweb.cgi/<repo>/<action>/<revision_from>:/<path_from>..<revision_to>:/<path_to>?<arguments>

Each action is implemented as a subroutine, and must be present in %actions hash. Some actions are disabled by default, and must be turned on via feature mechanism. For example to enable blame view add the following to gitweb configuration file:

$feature{'blame'}{'default'} = [1];

Actions: The standard actions are:

project_list Lists the available Git repositories. This is the default command if no repository is specified in the URL.

summary Displays summary about given repository. This is the default command if no action is specified in URL, and only repository is specified.

heads, remotes Lists all local or all remote-tracking branches in given repository.

The latter is not available by default, unless configured.

tags List all tags (lightweight and annotated) in given repository.

blob, tree Shows the files and directories in a given repository path, at given revision. This is default command if no action is specified in the URL, and path is given.

blob_plain Returns the raw data for the file in given repository, at given path and revision. Links to this action are marked raw.

blobdiff Shows the difference between two revisions of the same file.

blame, blame_incremental Shows the blame (also called annotation) information for a file. On a per line basis it shows the revision in which that line was last changed and the user that committed the change. The incremental version (which if configured is used automatically when JavaScript is enabled) uses Ajax to incrementally add blame info to the contents of given file.

This action is disabled by default for performance reasons.

commit, commitdiff Shows information about a specific commit in a repository. The commit view shows information about commit in more detail, the commitdiff action shows changeset for given commit.

patch Returns the commit in plain text mail format, suitable for applying with git-am(1).

tag Display specific annotated tag (tag object).

log, shortlog Shows log information (commit message or just commit subject) for a given branch (starting from given revision).

The shortlog view is more compact; it shows one commit per line.

history Shows history of the file or directory in a given repository path, starting from given revision (defaults to HEAD, i.e. default branch).

This view is similar to shortlog view.

rss, atom Generates an RSS (or Atom) feed of changes to repository.