Creating a Repository
OverviewTeaching: 10 min
Exercises: 5 minQuestions
Where does Mercurial store information?Objectives
Explain how to initialize a new Mercurial repository.
We’ll start by exploring how version control can be used to keep track of what one person did and when. We’re going to pretend to be a researcher named Susan who wants to start running the Salish Sea NEMO ocean model as a daily forecast system. If the example in the next few sections seems contrived, be assured that it is only slightly so to avoid having to do too much typing. Lots of projects (and therefore version control repositories) start with a single text file in which someone writes down some initial ideas.
Now that we have Mercurial configured, we can start using it. Let’s create a directory for Susan’s NEMO forecast project:
$ mkdir forecast $ cd forecast
and tell Mercurial to make it a repository: a place where Mercurial can store versions of our files:
$ hg init
Mercurial commands are written
verb is what we actually want it to do.
If we use
ls to show the directory’s contents,
it appears that nothing has changed:
But if we add the
-a flag to show everything,
we can see that Mercurial has created a hidden directory within
$ ls -a
. .. .hg
Mercurial stores information about the project in this special sub-directory. If we ever delete it, we will lose the project’s history.
We can check that everything is set up correctly by asking Mercurial to verify the structure of our repository:
$ hg verify
checking changesets checking manifests crosschecking files in changesets and manifests checking files 0 files, 0 changesets, 0 total revisions
hg initinitializes a repository.