# [PATCH 0/2] Finishing touches for pull "-w ref"

3 messages from 2005-06-23 to 2005-06-23. Participants: Junio C Hamano.
Thread: https://gitlist.dev/t/1014

## Junio C Hamano, 2005-06-23 23:18

Subject: [PATCH 0/2] Finishing touches for pull "-w ref"
Message-ID: <7vfyv8fyqn.fsf@assigned-by-dhcp.cox.net>
URL: https://gitlist.dev/e/7vfyv8fyqn.fsf%40assigned-by-dhcp.cox.net

```
I'll be sending these two patches to add finishing touches to
"-w ref" support.

    [PATCH 1/2] Add a bit of developer documentation to pull.h
    [PATCH 2/2] http-pull: documentation updates.


```

## Junio C Hamano, 2005-06-23 23:23

Subject: [PATCH 1/2] Add a bit of developer documentation to pull.h
Message-ID: <7vy890ejz3.fsf@assigned-by-dhcp.cox.net>
URL: https://gitlist.dev/e/7vy890ejz3.fsf%40assigned-by-dhcp.cox.net
In-Reply-To: <7vfyv8fyqn.fsf@assigned-by-dhcp.cox.net>

```
Describe what to implement in fetch() and fetch_ref() for
pull backend writers a bit better.

Signed-off-by: Junio C Hamano <junkio@cox.net>
---

 pull.h |   21 +++++++++++++++------
 1 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/pull.h b/pull.h
--- a/pull.h
+++ b/pull.h
@@ -1,24 +1,33 @@
 #ifndef PULL_H
 #define PULL_H
 
-/** To be provided by the particular implementation. **/
+/*
+ * Fetch object given SHA1 from the remote, and store it locally under
+ * GIT_OBJECT_DIRECTORY.  Return 0 on success, -1 on failure.  To be
+ * provided by the particular implementation.
+ */
 extern int fetch(unsigned char *sha1);
 
+/*
+ * Fetch ref (relative to $GIT_DIR/refs) from the remote, and store
+ * the 20-byte SHA1 in sha1.  Return 0 on success, -1 on failure.  To
+ * be provided by the particular implementation.
+ */
 extern int fetch_ref(char *ref, unsigned char *sha1);
 
-/** If set, the ref filename to write the target value to. **/
+/* If set, the ref filename to write the target value to. */
 extern const char *write_ref;
 
-/** If set, the hash that the current value of write_ref must be. **/
+/* If set, the hash that the current value of write_ref must be. */
 extern const unsigned char *current_ref;
 
-/** Set to fetch the target tree. */
+/* Set to fetch the target tree. */
 extern int get_tree;
 
-/** Set to fetch the commit history. */
+/* Set to fetch the commit history. */
 extern int get_history;
 
-/** Set to fetch the trees in the commit history. **/
+/* Set to fetch the trees in the commit history. */
 extern int get_all;
 
 /* Set to zero to skip the check for delta object base;
------------


```

## Junio C Hamano, 2005-06-23 23:23

Subject: [PATCH 2/2] http-pull: documentation updates.
Message-ID: <7vslz8ejxv.fsf@assigned-by-dhcp.cox.net>
URL: https://gitlist.dev/e/7vslz8ejxv.fsf%40assigned-by-dhcp.cox.net
In-Reply-To: <7vfyv8fyqn.fsf@assigned-by-dhcp.cox.net>

```
Describe -w option.

Signed-off-by: Junio C Hamano <junkio@cox.net>
---

 Documentation/git-http-pull.txt |    6 ++++--
 1 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/Documentation/git-http-pull.txt b/Documentation/git-http-pull.txt
--- a/Documentation/git-http-pull.txt
+++ b/Documentation/git-http-pull.txt
@@ -9,7 +9,7 @@ git-http-pull - Downloads a remote GIT r
 
 SYNOPSIS
 --------
-'git-http-pull' [-c] [-t] [-a] [-v] [-d] [--recover] commit-id url
+'git-http-pull' [-c] [-t] [-a] [-d] [-v] [-w filename] [--recover] commit-id url
 
 DESCRIPTION
 -----------
@@ -30,7 +30,9 @@ Downloads a remote GIT repository via HT
 	usual, to recover after earlier pull that was interrupted.
 -v::
 	Report what is downloaded.
-
+-w::
+        Writes the commit-id into the filename under $GIT_DIR/refs/ on
+        the local end after the transfer is complete.
 
 Author
 ------
------------


```
