{"thread":{"id":"1235","subject":"[PATCH] Documentation: push-pull commands into a separate category.","startedAt":"2005-07-14T07:10:48Z","lastAt":"2005-07-14T07:10:48Z","messageCount":1,"participants":["Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"6119","messageId":"7vu0ixj213.fsf@assigned-by-dhcp.cox.net","threadId":"1235","inReplyTo":null,"subject":"[PATCH] Documentation: push-pull commands into a separate category.","fromName":"Junio C Hamano","fromEmail":"junkio@cox.net","sentAt":"2005-07-14T07:10:48Z","receivedAt":"2005-07-14T07:10:48Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"This splits push-pull related commands into a separate\ncategory.  I think a bigger overhaul of the main index is\nneeded, but have not got around to it.  Help is welcome.\n\nSigned-off-by: Junio C Hamano <junkio@cox.net>\n---\n\n Documentation/git.txt |   65 ++++++++++++++++++++++++++++++++-----------------\n 1 files changed, 42 insertions(+), 23 deletions(-)\n\n9ea24aa8739dc23074872679d493dfd6fb0e5321\ndiff --git a/Documentation/git.txt b/Documentation/git.txt\n--- a/Documentation/git.txt\n+++ b/Documentation/git.txt\n@@ -30,8 +30,9 @@ reflect recent changes.\n Commands Overview\n -----------------\n The git commands can helpfully be split into those that manipulate\n-the repository, the cache and the working fileset and those that\n-interrogate and compare them.\n+the repository, the cache and the working fileset, those that\n+interrogate and compare them, and those that moves objects and\n+references between repositories.\n \n There are also some ancilliary programs that can be viewed as useful\n aids for using the core commands but which are unlikely to be used by\n@@ -117,16 +118,6 @@ The interrogate commands may create file\n touch the working file set - but in general they don't\n \n \n-Ancilliary Commands\n--------------------\n-Manipulators:\n-\n-link:git-apply-patch-script.html[git-apply-patch-script]::\n-\tSample script to apply the diffs from git-diff-*\n-\n-link:git-convert-cache.html[git-convert-cache]::\n-\tConverts old-style GIT repository\n-\n link:git-clone-script.html[git-clone-script]::\n \tClones a repository into the current repository (user interface)\n \n@@ -134,18 +125,49 @@ link:git-clone-pack.html[git-clone-pack]\n \tClones a repository into the current repository (engine\n \tfor ssh and local transport)\n \n+link:git-pull-script.html[git-pull-script]::\n+\tPull from a repote repository via various protocols\n+\t(user interface).\n+\n link:git-http-pull.html[git-http-pull]::\n \tDownloads a remote GIT repository via HTTP\n \n link:git-local-pull.html[git-local-pull]::\n \tDuplicates another GIT repository on a local system\n \n+link:git-ssh-pull.html[git-ssh-pull]::\n+\tPulls from a remote repository over ssh connection\n+\n+link:git-send-pack.html[git-send-pack]::\n+\tPushes to a remote repository, intelligently.\n+\n+link:git-receive-pack.html[git-receive-pack]::\n+\tInvoked by 'git-send-pack' to receive what is pushed to it.\n+\n+link:git-clone-pack.html[git-clone-pack]::\n+\tClones from a remote repository.\n+\n+link:git-fetch-pack.html[git-fetch-pack]::\n+\tUpdates from a remote repository.\n+\n+link:git-upload-pack.html[git-upload-pack]::\n+\tInvoked by 'git-clone-pack' and 'git-fetch-pack' to push\n+\twhat are asked for.\n+\n+\n+Ancilliary Commands\n+-------------------\n+Manipulators:\n+\n+link:git-apply-patch-script.html[git-apply-patch-script]::\n+\tSample script to apply the diffs from git-diff-*\n+\n+link:git-convert-cache.html[git-convert-cache]::\n+\tConverts old-style GIT repository\n+\n link:git-merge-one-file-script.html[git-merge-one-file-script]::\n \tThe standard helper program to use with \"git-merge-cache\"\n \n-link:git-pull-script.html[git-pull-script]::\n-\tScript used by Linus to pull and merge a remote repository\n-\n link:git-prune-script.html[git-prune-script]::\n \tPrunes all unreachable objects from the object database\n \n@@ -155,8 +177,6 @@ link:git-resolve-script.html[git-resolve\n link:git-tag-script.html[git-tag-script]::\n \tAn example script to create a tag object signed with GPG\n \n-link:git-ssh-pull.html[git-ssh-pull]::\n-\tPulls from a remote repository over ssh connection\n \n Interogators:\n \n@@ -221,17 +241,16 @@ The git-core manipulates the following a\n \n  .git/\t       The base (overridden with $GIT_DIR)\n    objects/    The object base (overridden with $GIT_OBJECT_DIRECTORY)\n-     ??/       'First 2 chars of object' directories\n-\n-It can interrogate (but never updates) the following areas:\n+     ??/       'First 2 chars of object' directories.\n+     pack/     Packed archives.\n \n    refs/       Directories containing symbolic names for objects\n \t       (each file contains the hex SHA1 + newline)\n      heads/    Commits which are heads of various sorts\n      tags/     Tags, by the tag name (or some local renaming of it)\n-     snap/     ????\n-   ...         Everything else isn't shared\n-   HEAD        Symlink to refs/heads/<something>\n+     */        Any other subdirectory of refs/ can be used to store\n+\t       files similar to what are under refs/heads/.\n+   HEAD        Symlink to refs/heads/<current-branch-name>\n \n Higher level SCMs may provide and manage additional information in the\n GIT_DIR.\n"}]}