Browse Source

Merge branch 'ak/everyday-git'

* ak/everyday-git:
  everyday: fsck and gc are not everyday operations
maint
Junio C Hamano 15 years ago
parent
commit
7135046b8b
  1. 51
      Documentation/everyday.txt

51
Documentation/everyday.txt

@ -1,13 +1,8 @@ @@ -1,13 +1,8 @@
Everyday GIT With 20 Commands Or So
===================================

<<Basic Repository>> commands are needed by people who have a
repository --- that is everybody, because every working tree of
git is a repository.

In addition, <<Individual Developer (Standalone)>> commands are
essential for anybody who makes a commit, even for somebody who
works alone.
<<Individual Developer (Standalone)>> commands are essential for
anybody who makes a commit, even for somebody who works alone.

If you work with other people, you will need commands listed in
the <<Individual Developer (Participant)>> section as well.
@ -20,46 +15,6 @@ administrators who are responsible for the care and feeding @@ -20,46 +15,6 @@ administrators who are responsible for the care and feeding
of git repositories.


Basic Repository[[Basic Repository]]
------------------------------------

Everybody uses these commands to maintain git repositories.

* linkgit:git-init[1] or linkgit:git-clone[1] to create a
new repository.

* linkgit:git-fsck[1] to check the repository for errors.

* linkgit:git-gc[1] to do common housekeeping tasks such as
repack and prune.

Examples
~~~~~~~~

Check health and remove cruft.::
+
------------
$ git fsck <1>
$ git count-objects <2>
$ git gc <3>
------------
+
<1> running without `\--full` is usually cheap and assures the
repository health reasonably well.
<2> check how many loose objects there are and how much
disk space is wasted by not repacking.
<3> repacks the local repository and performs other housekeeping tasks.

Repack a small project into single pack.::
+
------------
$ git gc <1>
------------
+
<1> pack all the objects reachable from the refs into one pack,
then remove the other packs.


Individual Developer (Standalone)[[Individual Developer (Standalone)]]
----------------------------------------------------------------------

@ -67,6 +22,8 @@ A standalone individual developer does not exchange patches with @@ -67,6 +22,8 @@ A standalone individual developer does not exchange patches with
other people, and works alone in a single repository, using the
following commands.

* linkgit:git-init[1] to create a new repository.

* linkgit:git-show-branch[1] to see where you are.

* linkgit:git-log[1] to see what happened.

Loading…
Cancel
Save