{"thread":{"id":"851","subject":"[PATCH] Document git-ssh-pull and git-ssh-push","startedAt":"2005-06-07T02:30:39Z","lastAt":"2005-06-07T02:30:39Z","messageCount":1,"participants":["Daniel Barkalow"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"4662","messageId":"Pine.LNX.4.21.0506062221261.30848-100000@iabervon.org","threadId":"851","inReplyTo":null,"subject":"[PATCH] Document git-ssh-pull and git-ssh-push","fromName":"Daniel Barkalow","fromEmail":"barkalow@iabervon.org","sentAt":"2005-06-07T02:30:39Z","receivedAt":"2005-06-07T02:30:39Z","isPatch":true,"sender":{"key":"barkalow@iabervon.org","avatar":"https://avatars.githubusercontent.com/u/55364219?v=4"},"body":"This fixes the documentation for git-ssh-push, as called by users (if you\nrun git-ssh-pull or git-ssh-push on one machine, the other runs on the\nother machine, and they transfer data in the specified direction).\n\nThis also adds documentation for the -w option and for using filenames for\nthe commit-id (which does what you'd want: uses the source side's value,\nnot the value already on the target, even if you're running it on the\ntarget).\n\nIt also credits me with the programs and the documentation for\ngit-ssh-push.\n\nSomeone who knows asciidoc should make sure I didn't mess up the\nformatting. I'm only sure of the ascii part.\n\nSigned-off-by: Daniel Barkalow <barkalow@iabervon.org>\nIndex: Documentation/git-ssh-pull.txt\n===================================================================\n--- 8ba05dbc5815b0bc731a93d8353d36ba633d14c4/Documentation/git-ssh-pull.txt  (mode:100644 sha1:a0dade00af24d136eba436987eef083cb7cbc75e)\n+++ e5b8562b2821b0d4d4f5bccb2af256f437fa7b63/Documentation/git-ssh-pull.txt  (mode:100644 sha1:3397fba8382955f232356efa5e8c6ae13e992433)\n@@ -10,15 +10,21 @@\n \n SYNOPSIS\n --------\n-'git-ssh-pull' [-c] [-t] [-a] [-d] [-v] [--recover] commit-id url\n+'git-ssh-pull' [-c] [-t] [-a] [-d] [-v] [-w filename] [--recover] commit-id url\n \n DESCRIPTION\n -----------\n-Pulls from a remote repository over ssh connection, invoking git-ssh-push\n-on the other end.\n+Pulls from a remote repository over ssh connection, invoking\n+git-ssh-push on the other end. It functions identically to\n+git-ssh-push, aside from which end you run it on.\n+\n \n OPTIONS\n -------\n+commit-id::\n+        Either the hash or the filename under [URL]/refs/ to\n+        pull.\n+\n -c::\n \tGet the commit objects.\n -t::\n@@ -34,11 +40,14 @@\n \tusual, to recover after earlier pull that was interrupted.\n -v::\n \tReport what is downloaded.\n+-w::\n+        Writes the commit-id into the filename under $GIT_DIR/refs/ on\n+        the local end after the transfer is complete.\n \n \n Author\n ------\n-Written by Linus Torvalds <torvalds@osdl.org>\n+Written by Daniel Barkalow <barkalow@iabervon.org>\n \n Documentation\n --------------\nIndex: Documentation/git-ssh-push.txt\n===================================================================\n--- 8ba05dbc5815b0bc731a93d8353d36ba633d14c4/Documentation/git-ssh-push.txt  (mode:100644 sha1:4fe850869722d9aa5aaa5f6bb7f66a92592419eb)\n+++ e5b8562b2821b0d4d4f5bccb2af256f437fa7b63/Documentation/git-ssh-push.txt  (mode:100644 sha1:c55ce7dd6f7308f5057218a8ea412ac490844cb3)\n@@ -1,28 +1,53 @@\n git-ssh-push(1)\n ===============\n-v0.1, May 2005\n+v0.1, Jun 2005\n \n NAME\n ----\n-git-ssh-push - Helper \"server-side\" program used by git-ssh-pull\n+git-ssh-push - Pushes to a remote repository over ssh connection\n \n \n SYNOPSIS\n --------\n-'git-ssh-push'\n+'git-ssh-push' [-c] [-t] [-a] [-d] [-v] [-w filename] [--recover] commit-id url\n \n DESCRIPTION\n -----------\n-Helper \"server-side\" program used by git-ssh-pull.\n-\n+Pushes from a remote repository over ssh connection, invoking\n+git-ssh-pull on the other end. It functions identically to\n+git-ssh-pull, aside from which end you run it on.\n+\n+OPTIONS\n+-------\n+commit-id::\n+        Either the hash or the filename under $GIT_DIR/refs/ to push.\n+\n+-c::\n+        Get the commit objects.\n+-t::\n+        Get tree associated with the requested commit object.\n+-a::\n+        Get all the objects.\n+-d::\n+        Do not check for delta base objects (use this option\n+        only when you know the local repository is not\n+        deltified).\n+--recover::\n+        Check dependency of deltified object more carefully than\n+        usual, to recover after earlier push that was interrupted.\n+-v::\n+        Report what is uploaded.\n+-w::\n+        Writes the commit-id into the filename under [URL]/refs/ on\n+        the remote end after the transfer is complete.\n \n Author\n ------\n-Written by Linus Torvalds <torvalds@osdl.org>\n+Written by Daniel Barkalow <barkalow@iabervon.org>\n \n Documentation\n --------------\n-Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.\n+Documentation by Daniel Barkalow\n \n GIT\n ---\n\n"}]}