Differences between revisions 22 and 23
Revision 22 as of 2008-01-06 13:41:38
Size: 2656
Editor: abuehl
Comment: +name of branch
Revision 23 as of 2008-01-12 11:01:48
Size: 2742
Editor: abuehl
Comment: using lowercase in textflow for linked words (more professional)
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
A '''changeset''' (sometimes abbreviated "cset") is an atomic collection of changes to files in a ["Repository"]. The act of creating a changeset is usually called a ["Commit"] or Checkin. The information in a changeset includes A '''changeset''' (sometimes abbreviated "cset") is an atomic collection of changes to files in a [:Repository:repository]. The act of creating a changeset is usually called a [:Commit:commit] or checkin. The information in a changeset includes
Line 12: Line 12:
Each changeset has zero, one or two ["Parent"] changesets. It has two parent changesets, if the commit was a ["Merge"]. It has no parent, if the changeset is a root in the repository. There may be multiple roots in a repository (normally, there is only one), each representing the start of a branch. Each changeset has zero, one or two [:Parent:parent] changesets. It has two parent changesets, if the commit was a [:Merge:merge]. It has no parent, if the changeset is a root in the repository. There may be multiple roots in a repository (normally, there is only one), each representing the start of a branch.
Line 14: Line 14:
If a changeset is not the ["Head"] of a branch, it has one or more child changesets (it is then the parent of its child changesets). If a changeset is not the [:Head:head] of a branch, it has one or more child changesets (it is then the parent of its child changesets).
Line 16: Line 16:
Technically, the parent changesets of a changeset are retrieved from the revision history of the changelog file(s) in the repository (files {{{00changelog.i}}} and {{{00changelog.d}}} in {{{.hg/store}}}). Each changeset references a revision of the ["Manifest"] (see ["Design"] for the technical details). Technically, the parent changesets of a changeset are retrieved from the revision history of the changelog file(s) in the repository (files {{{00changelog.i}}} and {{{00changelog.d}}} in {{{.hg/store}}}). Each changeset references a revision of the [:Manifest:manifest] (see ["Design"] for the technical details).
Line 18: Line 18:
The ["WorkingDirectory"] can be ["Update"]d to any commited changeset of the repository, which then becomes the parent of the working directory. The [:WorkingDirectory:working directory] can be [:Update:updated] to any commited changeset of the repository, which then becomes the parent of the working directory.
Line 22: Line 22:
"Updating" back to a changeset which already has a child, changeing files and then committing creates a new child changeset, thus starting a new branch. Branches can be named (see ["NamedBranches"]). "Updating" back to a changeset which already has a child, changeing files and then committing creates a new child changeset, thus starting a new branch. Branches can be [:NamedBranches:named].
Line 24: Line 24:
A changeset is identified uniquely by a ["ChangeSetID"]. In a single repository, you can identify it using a RevisionNumber. A changeset is identified uniquely by a [:ChangeSetID:changeset ID]. In a single repository, you can identify it using a [:RevisionNumber:revision number].

Changeset

(for a short intro of the basic concepts of Mercurial, see UnderstandingMercurial)

A changeset (sometimes abbreviated "cset") is an atomic collection of changes to files in a [:Repository:repository]. The act of creating a changeset is usually called a [:Commit:commit] or checkin. The information in a changeset includes

  • changes to the contents of the files
  • changes to file names or other external attributes (such as execute permissions)
  • information about who made the change (the "committer"), why ("comments") and when (date/time, timezone)
  • the name of the branch ("default", if omitted or not set)

Each changeset has zero, one or two [:Parent:parent] changesets. It has two parent changesets, if the commit was a [:Merge:merge]. It has no parent, if the changeset is a root in the repository. There may be multiple roots in a repository (normally, there is only one), each representing the start of a branch.

If a changeset is not the [:Head:head] of a branch, it has one or more child changesets (it is then the parent of its child changesets).

Technically, the parent changesets of a changeset are retrieved from the revision history of the changelog file(s) in the repository (files 00changelog.i and 00changelog.d in .hg/store). Each changeset references a revision of the [:Manifest:manifest] (see ["Design"] for the technical details).

The [:WorkingDirectory:working directory] can be [:Update:updated] to any commited changeset of the repository, which then becomes the parent of the working directory.

Committing changes in the working directory creates a new revision in the manifest and a new changeset (a new revision in the changelog). The parent(s) of the working directory become the parents of the new changeset and the new changeset becomes the new parent of the working directory.

"Updating" back to a changeset which already has a child, changeing files and then committing creates a new child changeset, thus starting a new branch. Branches can be [:NamedBranches:named].

A changeset is identified uniquely by a [:ChangeSetID:changeset ID]. In a single repository, you can identify it using a [:RevisionNumber:revision number].

  • Question: Is a changeset a particular state of the project (like a Subversion revision number), or is it a set of changes to files (like a Darcs patch)?

See also: ["ChangeSetComments"]


CategoryGlossary

ChangeSet (last edited 2018-02-03 04:31:09 by SangeetKumarMishra)