git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
* [PATCH 0/2] Update linux-2.6.git location and repo size
@ 2013-06-19  1:55 W. Trevor King
  2013-06-19  1:55 ` [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git' W. Trevor King
  2013-06-19  1:55 ` [PATCH 2/2] user-manual: Update download size for Git and the kernel W. Trevor King
  0 siblings, 2 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-19  1:55 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano, W. Trevor King

From: "W. Trevor King" <wking@tremily.us>

Bring the docs back up to date with the real world ;).  Patches are
against the current gitster/maint.  The commit messages may be to
chatty, so let me know if you'd like a trimmed down version.

W. Trevor King (2):
  Documentation: Update 'linux-2.6.git' -> 'linux.git'
  user-manual: Update download size for Git and the kernel

 Documentation/git-clone.txt       |  2 +-
 Documentation/git-fast-export.txt |  2 +-
 Documentation/user-manual.txt     | 10 +++++-----
 t/perf/README                     |  2 +-
 4 files changed, 8 insertions(+), 8 deletions(-)

-- 
1.8.3

^ permalink raw reply	[flat|nested] 18+ messages in thread

* [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git'
  2013-06-19  1:55 [PATCH 0/2] Update linux-2.6.git location and repo size W. Trevor King
@ 2013-06-19  1:55 ` W. Trevor King
  2013-06-19  5:05   ` David Aguilar
  2013-06-19 17:07   ` [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git' Junio C Hamano
  2013-06-19  1:55 ` [PATCH 2/2] user-manual: Update download size for Git and the kernel W. Trevor King
  1 sibling, 2 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-19  1:55 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano, W. Trevor King

From: "W. Trevor King" <wking@tremily.us>

The 3.x tree has been out for a while now.  The -2.6 repository name
survived the initial release [1], but kernel.org now only lists
'linux.git' (for aegl as well as torvalds) [2].

[1]: http://article.gmane.org/gmane.linux.kernel/1147422
  On 2011-05-30 01:47:57 GMT, Linus Torvalds wrote:
  > ... yes, that means that my git tree is still called
  > "linux-2.6.git" on kernel.org.
[2]: http://git.kernel.org/cgit/

Signed-off-by: W. Trevor King <wking@tremily.us>
---
 Documentation/git-clone.txt       | 2 +-
 Documentation/git-fast-export.txt | 2 +-
 Documentation/user-manual.txt     | 6 +++---
 t/perf/README                     | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt
index a0727d7..8e5260f 100644
--- a/Documentation/git-clone.txt
+++ b/Documentation/git-clone.txt
@@ -274,7 +274,7 @@ $ git clone --bare -l /home/proj/.git /pub/scm/proj.git
 * Create a repository on the kernel.org machine that borrows from Linus:
 +
 ------------
-$ git clone --bare -l -s /pub/scm/.../torvalds/linux-2.6.git \
+$ git clone --bare -l -s /pub/scm/.../torvalds/linux.git \
     /pub/scm/.../me/subsys-2.6.git
 ------------
 
diff --git a/Documentation/git-fast-export.txt b/Documentation/git-fast-export.txt
index efb0380..85f1f30 100644
--- a/Documentation/git-fast-export.txt
+++ b/Documentation/git-fast-export.txt
@@ -141,7 +141,7 @@ Limitations
 -----------
 
 Since 'git fast-import' cannot tag trees, you will not be
-able to export the linux-2.6.git repository completely, as it contains
+able to export the linux.git repository completely, as it contains
 a tag referencing a tree instead of a commit.
 
 GIT
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index e831cc2..cd9941a 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -60,7 +60,7 @@ project in mind, here are some interesting examples:
 	# Git itself (approx. 10MB download):
 $ git clone git://git.kernel.org/pub/scm/git/git.git
 	# the Linux kernel (approx. 150MB download):
-$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
+$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
 ------------------------------------------------
 
 The initial clone may be time-consuming for a large project, but you
@@ -2156,7 +2156,7 @@ To set this up, first create your work tree by cloning Linus's public
 tree:
 
 -------------------------------------------------
-$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git work
+$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git work
 $ cd work
 -------------------------------------------------
 
@@ -2198,7 +2198,7 @@ make it easy to push both branches to your public tree.  (See
 -------------------------------------------------
 $ cat >> .git/config <<EOF
 [remote "mytree"]
-	url =  master.kernel.org:/pub/scm/linux/kernel/git/aegl/linux-2.6.git
+	url =  master.kernel.org:/pub/scm/linux/kernel/git/aegl/linux.git
 	push = release
 	push = test
 EOF
diff --git a/t/perf/README b/t/perf/README
index c552f56..8848c14 100644
--- a/t/perf/README
+++ b/t/perf/README
@@ -66,7 +66,7 @@ You can set the following variables (also in your config.mak):
     GIT_PERF_LARGE_REPO
 	Repositories to copy for the performance tests.  The normal
 	repo should be at least git.git size.  The large repo should
-	probably be about linux-2.6.git size for optimal results.
+	probably be about linux.git size for optimal results.
 	Both default to the git.git you are running from.
 
 You can also pass the options taken by ordinary git tests; the most
-- 
1.8.3

^ permalink raw reply related	[flat|nested] 18+ messages in thread

* [PATCH 2/2] user-manual: Update download size for Git and the kernel
  2013-06-19  1:55 [PATCH 0/2] Update linux-2.6.git location and repo size W. Trevor King
  2013-06-19  1:55 ` [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git' W. Trevor King
@ 2013-06-19  1:55 ` W. Trevor King
  2013-06-19 17:07   ` Junio C Hamano
  2013-06-22 12:40   ` W. Trevor King
  1 sibling, 2 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-19  1:55 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano, W. Trevor King

From: "W. Trevor King" <wking@tremily.us>

They've grown since d19fbc3 (Documentation: add git user's manual,
2007-01-07) when the stats were initially added.  I've rounded
download sizes up to the nearest power of ten MiB to decrease the
precision and give a bit of growing room.  Exact sizes:

  $ git clone git://git.kernel.org/pub/scm/git/git.git
  Initialized empty Git repository in /tmp/git/.git/
  remote: Counting objects: 156872, done.
  remote: Compressing objects: 100% (40826/40826), done.
  remote: Total 156872 (delta 115322), reused 155492 (delta 114094)
  Receiving objects: 100% (156872/156872), 37.29 MiB | 7.54 MiB/s, done.
  Resolving deltas: 100% (115322/115322), done.

  $ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
  Initialized empty Git repository in /tmp/linux/.git/
  remote: Counting objects: 3057404, done.
  remote: Compressing objects: 100% (474769/474769), done.
  Receiving objects: 100% (3057404/3057404), 634.33 MiB | 27.95 MiB/s, done.
  remote: Total 3057404 (delta 2570385), reused 3040910 (delta 2554408)
  Resolving deltas: 100% (2570385/2570385), done.
  Checking out files: 100% (43012/43012), done.

Signed-off-by: W. Trevor King <wking@tremily.us>
---
 Documentation/user-manual.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index cd9941a..ffc4e1c 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -57,9 +57,9 @@ download a copy of an existing repository.  If you don't already have a
 project in mind, here are some interesting examples:
 
 ------------------------------------------------
-	# Git itself (approx. 10MB download):
+	# Git itself (approx. 40MB download):
 $ git clone git://git.kernel.org/pub/scm/git/git.git
-	# the Linux kernel (approx. 150MB download):
+	# the Linux kernel (approx. 640MB download):
 $ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
 ------------------------------------------------
 
-- 
1.8.3

^ permalink raw reply related	[flat|nested] 18+ messages in thread

* Re: [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git'
  2013-06-19  1:55 ` [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git' W. Trevor King
@ 2013-06-19  5:05   ` David Aguilar
  2013-06-19 11:48     ` W. Trevor King
  2013-06-19 17:07   ` [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git' Junio C Hamano
  1 sibling, 1 reply; 18+ messages in thread
From: David Aguilar @ 2013-06-19  5:05 UTC (permalink / raw)
  To: W. Trevor King; +Cc: Git, Junio C Hamano

On Tue, Jun 18, 2013 at 6:55 PM, W. Trevor King <wking@tremily.us> wrote:
> From: "W. Trevor King" <wking@tremily.us>
>
> The 3.x tree has been out for a while now.  The -2.6 repository name
> survived the initial release [1], but kernel.org now only lists
> 'linux.git' (for aegl as well as torvalds) [2].
>
> [1]: http://article.gmane.org/gmane.linux.kernel/1147422
>   On 2011-05-30 01:47:57 GMT, Linus Torvalds wrote:
>   > ... yes, that means that my git tree is still called
>   > "linux-2.6.git" on kernel.org.
> [2]: http://git.kernel.org/cgit/
>
> Signed-off-by: W. Trevor King <wking@tremily.us>
> ---
>  Documentation/git-clone.txt       | 2 +-
>  Documentation/git-fast-export.txt | 2 +-
>  Documentation/user-manual.txt     | 6 +++---
>  t/perf/README                     | 2 +-
>  4 files changed, 6 insertions(+), 6 deletions(-)
>
> diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt
> index a0727d7..8e5260f 100644
> --- a/Documentation/git-clone.txt
> +++ b/Documentation/git-clone.txt
> @@ -274,7 +274,7 @@ $ git clone --bare -l /home/proj/.git /pub/scm/proj.git
>  * Create a repository on the kernel.org machine that borrows from Linus:
>  +
>  ------------
> -$ git clone --bare -l -s /pub/scm/.../torvalds/linux-2.6.git \
> +$ git clone --bare -l -s /pub/scm/.../torvalds/linux.git \
>      /pub/scm/.../me/subsys-2.6.git

Perhaps subsys.git instead of subsys-2.6.git too?
--
David

^ permalink raw reply	[flat|nested] 18+ messages in thread

* Re: [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git'
  2013-06-19  5:05   ` David Aguilar
@ 2013-06-19 11:48     ` W. Trevor King
  2013-06-19 19:47       ` W. Trevor King
  0 siblings, 1 reply; 18+ messages in thread
From: W. Trevor King @ 2013-06-19 11:48 UTC (permalink / raw)
  To: David Aguilar; +Cc: Git, Junio C Hamano

[-- Attachment #1: Type: text/plain, Size: 814 bytes --]

On Tue, Jun 18, 2013 at 10:05:50PM -0700, David Aguilar wrote:
> On Tue, Jun 18, 2013 at 6:55 PM, W. Trevor King <wking@tremily.us> wrote:
> > -$ git clone --bare -l -s /pub/scm/.../torvalds/linux-2.6.git \
> > +$ git clone --bare -l -s /pub/scm/.../torvalds/linux.git \
> >      /pub/scm/.../me/subsys-2.6.git
> 
> Perhaps subsys.git instead of subsys-2.6.git too?

Good point.  `git grep -- -2.6.git` also turns up a few references to
git://linux-nfs.org/pub/nfs-2.6.git, but I can't figure out where that
has gone.  It looks like the NFS folks only have personal repositories
anymore [1].

Cheers,
Trevor

[1]: http://git.linux-nfs.org/

-- 
This email may be signed or encrypted with GnuPG (http://www.gnupg.org).
For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

^ permalink raw reply	[flat|nested] 18+ messages in thread

* Re: [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git'
  2013-06-19  1:55 ` [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git' W. Trevor King
  2013-06-19  5:05   ` David Aguilar
@ 2013-06-19 17:07   ` Junio C Hamano
  1 sibling, 0 replies; 18+ messages in thread
From: Junio C Hamano @ 2013-06-19 17:07 UTC (permalink / raw)
  To: W. Trevor King; +Cc: Git

"W. Trevor King" <wking@tremily.us> writes:

> diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt
> index a0727d7..8e5260f 100644
> --- a/Documentation/git-clone.txt
> +++ b/Documentation/git-clone.txt
> @@ -274,7 +274,7 @@ $ git clone --bare -l /home/proj/.git /pub/scm/proj.git
>  * Create a repository on the kernel.org machine that borrows from Linus:
>  +
>  ------------
> -$ git clone --bare -l -s /pub/scm/.../torvalds/linux-2.6.git \
> +$ git clone --bare -l -s /pub/scm/.../torvalds/linux.git \
>      /pub/scm/.../me/subsys-2.6.git
>  ------------

Aside from s|subsys-2.6|subsys| David already mentioned, I think
it is a lot saner to remove this particular example.  Nobody runs
shell on k.org machines these days, and local borrowing "-l -s" is
already shown in another example.

Also you seem to have missed another "linux-2.6 my2.6" clone in the
first example.

Will not apply in this form; expecting a reroll.

Thanks.

^ permalink raw reply	[flat|nested] 18+ messages in thread

* Re: [PATCH 2/2] user-manual: Update download size for Git and the kernel
  2013-06-19  1:55 ` [PATCH 2/2] user-manual: Update download size for Git and the kernel W. Trevor King
@ 2013-06-19 17:07   ` Junio C Hamano
  2013-06-22 12:40   ` W. Trevor King
  1 sibling, 0 replies; 18+ messages in thread
From: Junio C Hamano @ 2013-06-19 17:07 UTC (permalink / raw)
  To: W. Trevor King; +Cc: Git

Thanks, will queue.

^ permalink raw reply	[flat|nested] 18+ messages in thread

* Re: [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git'
  2013-06-19 11:48     ` W. Trevor King
@ 2013-06-19 19:47       ` W. Trevor King
  2013-06-19 21:37         ` Junio C Hamano
  0 siblings, 1 reply; 18+ messages in thread
From: W. Trevor King @ 2013-06-19 19:47 UTC (permalink / raw)
  To: David Aguilar, Junio C Hamano; +Cc: Git

[-- Attachment #1: Type: text/plain, Size: 2232 bytes --]

On Wed, Jun 19, 2013 at 10:07:24AM -0700, Junio C Hamano wrote:
> "W. Trevor King" <wking@tremily.us> writes:
> 
> > diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt
> > index a0727d7..8e5260f 100644
> > --- a/Documentation/git-clone.txt
> > +++ b/Documentation/git-clone.txt
> > @@ -274,7 +274,7 @@ $ git clone --bare -l /home/proj/.git /pub/scm/proj.git
> >  * Create a repository on the kernel.org machine that borrows from Linus:
> >  +
> >  ------------
> > -$ git clone --bare -l -s /pub/scm/.../torvalds/linux-2.6.git \
> > +$ git clone --bare -l -s /pub/scm/.../torvalds/linux.git \
> >      /pub/scm/.../me/subsys-2.6.git
> >  ------------
> 
> Aside from s|subsys-2.6|subsys| David already mentioned, I think
> it is a lot saner to remove this particular example.  Nobody runs
> shell on k.org machines these days, and local borrowing "-l -s" is
> already shown in another example.
> 
> Also you seem to have missed another "linux-2.6 my2.6" clone in the
> first example.

Between the nfs-2.6 examples I mentioned earlier, the my2.6 clone
here, and the:

  $ git clone --reference my2.6 \
    git://git.kernel.org/pub/scm/.../linux-2.7 \
    my2.7

example listed later in git-clone.txt, I think we're trying to push
linux.git examples too far ;).  However, I can't think of a simple
example for --reference that doesn't drag in a longer discussion to
motivate shared object repositories.  I'll hunt through the rest of
the docs looking for other examples I can reuse.

I think any doc rewrites should be outside the scope of this patch,
which should just replace references to linux-2.6.git with linux.git
(as it does).  Further cleanups to remove references to the NFS and
my2.{6,7} stuff and replace them with alternative examples can come as
follow-up patches in v2 of this series.  Does that sound reasonable?

Should the size updates from 2/2 (user-manual: Update download size
for Git and the kernel) go into the reroll, or have they been picked
up in a separate branch?

Cheers,
Trevor

-- 
This email may be signed or encrypted with GnuPG (http://www.gnupg.org).
For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

^ permalink raw reply	[flat|nested] 18+ messages in thread

* Re: [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git'
  2013-06-19 19:47       ` W. Trevor King
@ 2013-06-19 21:37         ` Junio C Hamano
  2013-06-22 14:46           ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
  0 siblings, 1 reply; 18+ messages in thread
From: Junio C Hamano @ 2013-06-19 21:37 UTC (permalink / raw)
  To: W. Trevor King; +Cc: David Aguilar, Git

"W. Trevor King" <wking@tremily.us> writes:

> I think any doc rewrites should be outside the scope of this patch,
> which should just replace references to linux-2.6.git with linux.git
> (as it does).  

OK.

> Should the size updates from 2/2 (user-manual: Update download size
> for Git and the kernel) go into the reroll, or have they been picked
> up in a separate branch?

I think 2/2 is fine.  Here is what I'll queue.

diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index e831cc2..1cbf5af 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -57,10 +57,10 @@ download a copy of an existing repository.  If you don't already have a
 project in mind, here are some interesting examples:
 
 ------------------------------------------------
-	# Git itself (approx. 10MB download):
+	# Git itself (approx. 40MB download):
 $ git clone git://git.kernel.org/pub/scm/git/git.git
-	# the Linux kernel (approx. 150MB download):
-$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
+	# the Linux kernel (approx. 640MB download):
+$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
 ------------------------------------------------
 
 The initial clone may be time-consuming for a large project, but you

^ permalink raw reply related	[flat|nested] 18+ messages in thread

* Re: [PATCH 2/2] user-manual: Update download size for Git and the kernel
  2013-06-19  1:55 ` [PATCH 2/2] user-manual: Update download size for Git and the kernel W. Trevor King
  2013-06-19 17:07   ` Junio C Hamano
@ 2013-06-22 12:40   ` W. Trevor King
  1 sibling, 0 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-22 12:40 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano

[-- Attachment #1: Type: text/plain, Size: 642 bytes --]

On Tue, Jun 18, 2013 at 09:55:22PM -0400, W. Trevor King wrote:
> They've grown since d19fbc3 (Documentation: add git user's manual,
> 2007-01-07) when the stats were initially added.  I've rounded
> download sizes up to the nearest power of ten MiB to decrease the
> precision and give a bit of growing room.  Exact sizes:

Oops, I meant “multiple of ten MiB” not “power of ten MiB” :p.  Not
that this wording is likely to cause major confusion ;).

Cheers,
Trevor

-- 
This email may be signed or encrypted with GnuPG (http://www.gnupg.org).
For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

^ permalink raw reply	[flat|nested] 18+ messages in thread

* [PATCH v2 0/4] Update linux-2.6.git location and related examples
  2013-06-19 21:37         ` Junio C Hamano
@ 2013-06-22 14:46           ` W. Trevor King
  2013-06-22 14:46             ` [PATCH v2 1/4] doc/clone: Remove the '--bare -l -s' example W. Trevor King
                               ` (4 more replies)
  0 siblings, 5 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-22 14:46 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano, David Aguilar, W. Trevor King

From: "W. Trevor King" <wking@tremily.us>

David and Junio mentioned that I'd missed a few 2.6 references in my
initial pass.  Here's a second attempt that does some deeper reworking
of the effected sections.  Each deeper rewrite gets its own patch and
motivation, with the final patch making all the superficial changes
that were not fixed in the earlier patches.

I've dropped the download size update (2/2 in v1), which Junio has
queued separately.  I also rebased the series on maint-1.8.2, since
that's where the size update landed.  I only touch low-churn areas
though, so this series should apply to any recent branch.

W. Trevor King (4):
  doc/clone: Remove the '--bare -l -s' example
  doc/clone: Pick more compelling paths for the --reference example
  Documentation: Update the NFS remote examples to use the staging repo
  Documentation: Update 'linux-2.6.git' -> 'linux.git'

 Documentation/git-clone.txt          | 19 ++++++-------------
 Documentation/git-fast-export.txt    |  2 +-
 Documentation/git-remote.txt         | 25 ++++++++++++++++---------
 Documentation/technical/racy-git.txt |  6 +++---
 Documentation/user-manual.txt        | 34 ++++++++++++++++++++--------------
 t/perf/README                        |  2 +-
 6 files changed, 47 insertions(+), 41 deletions(-)

-- 
1.8.3

^ permalink raw reply	[flat|nested] 18+ messages in thread

* [PATCH v2 1/4] doc/clone: Remove the '--bare -l -s' example
  2013-06-22 14:46           ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
@ 2013-06-22 14:46             ` W. Trevor King
  2013-06-22 14:46             ` [PATCH v2 2/4] doc/clone: Pick more compelling paths for the --reference example W. Trevor King
                               ` (3 subsequent siblings)
  4 siblings, 0 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-22 14:46 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano, David Aguilar, W. Trevor King

From: "W. Trevor King" <wking@tremily.us>

There are other examples in git-clone.txt demonstrating both '--bare'
and '-l -s'.

Signed-off-by: W. Trevor King <wking@tremily.us>
---
 Documentation/git-clone.txt | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt
index 5c16e31..cec6fc1 100644
--- a/Documentation/git-clone.txt
+++ b/Documentation/git-clone.txt
@@ -271,13 +271,6 @@ $ git clone --bare -l /home/proj/.git /pub/scm/proj.git
 ------------
 
 
-* Create a repository on the kernel.org machine that borrows from Linus:
-+
-------------
-$ git clone --bare -l -s /pub/scm/.../torvalds/linux-2.6.git \
-    /pub/scm/.../me/subsys-2.6.git
-------------
-
 GIT
 ---
 Part of the linkgit:git[1] suite
-- 
1.8.3

^ permalink raw reply related	[flat|nested] 18+ messages in thread

* [PATCH v2 2/4] doc/clone: Pick more compelling paths for the --reference example
  2013-06-22 14:46           ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
  2013-06-22 14:46             ` [PATCH v2 1/4] doc/clone: Remove the '--bare -l -s' example W. Trevor King
@ 2013-06-22 14:46             ` W. Trevor King
  2013-06-22 14:46             ` [PATCH v2 3/4] Documentation: Update the NFS remote examples to use the staging repo W. Trevor King
                               ` (2 subsequent siblings)
  4 siblings, 0 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-22 14:46 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano, David Aguilar, W. Trevor King

From: "W. Trevor King" <wking@tremily.us>

There may be times when using one of your local repositories as a
reference for a new clone make sense, but the implied version-bump in
the old example isn't one of them.  I think a more intuitive example
is multi-user system with a central reference clone, and the new paths
hint at this use case.

Signed-off-by: W. Trevor King <wking@tremily.us>
---
 Documentation/git-clone.txt | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt
index cec6fc1..bf05ada 100644
--- a/Documentation/git-clone.txt
+++ b/Documentation/git-clone.txt
@@ -257,10 +257,10 @@ $ git show-branch
 * Clone from upstream while borrowing from an existing local directory:
 +
 ------------
-$ git clone --reference my2.6 \
-	git://git.kernel.org/pub/scm/.../linux-2.7 \
-	my2.7
-$ cd my2.7
+$ git clone --reference /git/linux.git \
+	git://git.kernel.org/pub/scm/.../linux.git \
+	my-linux
+$ cd my-linux
 ------------
 
 
-- 
1.8.3

^ permalink raw reply related	[flat|nested] 18+ messages in thread

* [PATCH v2 3/4] Documentation: Update the NFS remote examples to use the staging repo
  2013-06-22 14:46           ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
  2013-06-22 14:46             ` [PATCH v2 1/4] doc/clone: Remove the '--bare -l -s' example W. Trevor King
  2013-06-22 14:46             ` [PATCH v2 2/4] doc/clone: Pick more compelling paths for the --reference example W. Trevor King
@ 2013-06-22 14:46             ` W. Trevor King
  2013-06-22 14:46             ` [PATCH v2 4/4] Documentation: Update 'linux-2.6.git' -> 'linux.git' W. Trevor King
  2013-06-30  1:05             ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
  4 siblings, 0 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-22 14:46 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano, David Aguilar, W. Trevor King

From: "W. Trevor King" <wking@tremily.us>

linux-nfs.org seems to have restructured their repository layout since
8391c60 (git-remote.txt: fix example url, 2007-11-02), and Bruce's
repo is now at git://git.linux-nfs.org/projects/bfields/linux.git.
Bruce also has a more richer internal branch structure (master,
everything, for-3.1, ...), so updating the existing example to use his
current repo may be confusing.

To simplify, I've replaced the NFS repo with Greg's staging repo.
I've also updated the output of the surrounding commands to match the
output of a current run through.

Signed-off-by: W. Trevor King <wking@tremily.us>
---
 Documentation/git-remote.txt  | 25 ++++++++++++++++---------
 Documentation/user-manual.txt | 26 ++++++++++++++++----------
 2 files changed, 32 insertions(+), 19 deletions(-)

diff --git a/Documentation/git-remote.txt b/Documentation/git-remote.txt
index 7a6f354..d007163 100644
--- a/Documentation/git-remote.txt
+++ b/Documentation/git-remote.txt
@@ -187,18 +187,25 @@ Examples
 $ git remote
 origin
 $ git branch -r
-origin/master
-$ git remote add linux-nfs git://linux-nfs.org/pub/linux/nfs-2.6.git
+  origin/HEAD -> origin/master
+  origin/master
+$ git remote add staging git://git.kernel.org/.../gregkh/staging.git
 $ git remote
-linux-nfs
 origin
-$ git fetch
-* refs/remotes/linux-nfs/master: storing branch 'master' ...
-  commit: bf81b46
+staging
+$ git fetch staging
+...
+From git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/staging
+ * [new branch]      master     -> staging/master
+ * [new branch]      staging-linus -> staging/staging-linus
+ * [new branch]      staging-next -> staging/staging-next
 $ git branch -r
-origin/master
-linux-nfs/master
-$ git checkout -b nfs linux-nfs/master
+  origin/HEAD -> origin/master
+  origin/master
+  staging/master
+  staging/staging-linus
+  staging/staging-next
+$ git checkout -b staging staging/master
 ...
 ------------
 
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index e831cc2..4283d8f 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -431,19 +431,25 @@ You can also track branches from repositories other than the one you
 cloned from, using linkgit:git-remote[1]:
 
 -------------------------------------------------
-$ git remote add linux-nfs git://linux-nfs.org/pub/nfs-2.6.git
-$ git fetch linux-nfs
-* refs/remotes/linux-nfs/master: storing branch 'master' ...
-  commit: bf81b46
+$ git remote add staging git://git.kernel.org/.../gregkh/staging.git
+$ git fetch staging
+...
+From git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/staging
+ * [new branch]      master     -> staging/master
+ * [new branch]      staging-linus -> staging/staging-linus
+ * [new branch]      staging-next -> staging/staging-next
 -------------------------------------------------
 
 New remote-tracking branches will be stored under the shorthand name
-that you gave `git remote add`, in this case `linux-nfs`:
+that you gave `git remote add`, in this case `staging`:
 
 -------------------------------------------------
 $ git branch -r
-linux-nfs/master
-origin/master
+  origin/HEAD -> origin/master
+  origin/master
+  staging/master
+  staging/staging-linus
+  staging/staging-next
 -------------------------------------------------
 
 If you run `git fetch <remote>` later, the remote-tracking branches
@@ -455,9 +461,9 @@ a new stanza:
 -------------------------------------------------
 $ cat .git/config
 ...
-[remote "linux-nfs"]
-	url = git://linux-nfs.org/pub/nfs-2.6.git
-	fetch = +refs/heads/*:refs/remotes/linux-nfs/*
+[remote "staging"]
+	url = git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/staging.git
+	fetch = +refs/heads/*:refs/remotes/staging/*
 ...
 -------------------------------------------------
 
-- 
1.8.3

^ permalink raw reply related	[flat|nested] 18+ messages in thread

* [PATCH v2 4/4] Documentation: Update 'linux-2.6.git' -> 'linux.git'
  2013-06-22 14:46           ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
                               ` (2 preceding siblings ...)
  2013-06-22 14:46             ` [PATCH v2 3/4] Documentation: Update the NFS remote examples to use the staging repo W. Trevor King
@ 2013-06-22 14:46             ` W. Trevor King
  2013-06-30  1:05             ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
  4 siblings, 0 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-22 14:46 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano, David Aguilar, W. Trevor King

From: "W. Trevor King" <wking@tremily.us>

The 3.x tree has been out for a while now.  The -2.6 repository name
survived the initial release [1], but kernel.org now only lists
'linux.git' (for aegl as well as torvalds) [2].

[1]: http://article.gmane.org/gmane.linux.kernel/1147422
  On 2011-05-30 01:47:57 GMT, Linus Torvalds wrote:
  > ... yes, that means that my git tree is still called
  > "linux-2.6.git" on kernel.org.
[2]: http://git.kernel.org/cgit/

Signed-off-by: W. Trevor King <wking@tremily.us>
---
 Documentation/git-clone.txt          | 4 ++--
 Documentation/git-fast-export.txt    | 2 +-
 Documentation/technical/racy-git.txt | 6 +++---
 Documentation/user-manual.txt        | 8 ++++----
 t/perf/README                        | 2 +-
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt
index bf05ada..98b139c 100644
--- a/Documentation/git-clone.txt
+++ b/Documentation/git-clone.txt
@@ -239,8 +239,8 @@ Examples
 * Clone from upstream:
 +
 ------------
-$ git clone git://git.kernel.org/pub/scm/.../linux-2.6 my2.6
-$ cd my2.6
+$ git clone git://git.kernel.org/pub/scm/.../linux.git my-linux
+$ cd my-linux
 $ make
 ------------
 
diff --git a/Documentation/git-fast-export.txt b/Documentation/git-fast-export.txt
index d6487e1..0314da3 100644
--- a/Documentation/git-fast-export.txt
+++ b/Documentation/git-fast-export.txt
@@ -137,7 +137,7 @@ Limitations
 -----------
 
 Since 'git fast-import' cannot tag trees, you will not be
-able to export the linux-2.6.git repository completely, as it contains
+able to export the linux.git repository completely, as it contains
 a tag referencing a tree instead of a commit.
 
 GIT
diff --git a/Documentation/technical/racy-git.txt b/Documentation/technical/racy-git.txt
index 6dc82ca..f716d6d 100644
--- a/Documentation/technical/racy-git.txt
+++ b/Documentation/technical/racy-git.txt
@@ -135,9 +135,9 @@ them, and give the same timestamp to the index file:
   $ git ls-files | git update-index --stdin
   $ touch -r .datestamp .git/index
 
-This will make all index entries racily clean.  The linux-2.6
-project, for example, there are over 20,000 files in the working
-tree.  On my Athlon 64 X2 3800+, after the above:
+This will make all index entries racily clean.  The linux project, for
+example, there are over 20,000 files in the working tree.  On my
+Athlon 64 X2 3800+, after the above:
 
   $ /usr/bin/time git diff-files
   1.68user 0.54system 0:02.22elapsed 100%CPU (0avgtext+0avgdata 0maxresident)k
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index 4283d8f..a13de93 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -66,8 +66,8 @@ $ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
 The initial clone may be time-consuming for a large project, but you
 will only need to clone once.
 
-The clone command creates a new directory named after the project (`git`
-or `linux-2.6` in the examples above).  After you cd into this
+The clone command creates a new directory named after the project
+(`git` or `linux` in the examples above).  After you cd into this
 directory, you will see that it contains a copy of the project files,
 called the <<def_working_tree,working tree>>, together with a special
 top-level directory named `.git`, which contains all the information
@@ -2162,7 +2162,7 @@ To set this up, first create your work tree by cloning Linus's public
 tree:
 
 -------------------------------------------------
-$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git work
+$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git work
 $ cd work
 -------------------------------------------------
 
@@ -2204,7 +2204,7 @@ make it easy to push both branches to your public tree.  (See
 -------------------------------------------------
 $ cat >> .git/config <<EOF
 [remote "mytree"]
-	url =  master.kernel.org:/pub/scm/linux/kernel/git/aegl/linux-2.6.git
+	url =  master.kernel.org:/pub/scm/linux/kernel/git/aegl/linux.git
 	push = release
 	push = test
 EOF
diff --git a/t/perf/README b/t/perf/README
index c552f56..8848c14 100644
--- a/t/perf/README
+++ b/t/perf/README
@@ -66,7 +66,7 @@ You can set the following variables (also in your config.mak):
     GIT_PERF_LARGE_REPO
 	Repositories to copy for the performance tests.  The normal
 	repo should be at least git.git size.  The large repo should
-	probably be about linux-2.6.git size for optimal results.
+	probably be about linux.git size for optimal results.
 	Both default to the git.git you are running from.
 
 You can also pass the options taken by ordinary git tests; the most
-- 
1.8.3

^ permalink raw reply related	[flat|nested] 18+ messages in thread

* Re: [PATCH v2 0/4] Update linux-2.6.git location and related examples
  2013-06-22 14:46           ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
                               ` (3 preceding siblings ...)
  2013-06-22 14:46             ` [PATCH v2 4/4] Documentation: Update 'linux-2.6.git' -> 'linux.git' W. Trevor King
@ 2013-06-30  1:05             ` W. Trevor King
  2013-06-30  1:44               ` Junio C Hamano
  4 siblings, 1 reply; 18+ messages in thread
From: W. Trevor King @ 2013-06-30  1:05 UTC (permalink / raw)
  To: Git; +Cc: Junio C Hamano, David Aguilar

[-- Attachment #1: Type: text/plain, Size: 322 bytes --]

On Sat, Jun 22, 2013 at 10:46:23AM -0400, W. Trevor King wrote:
> David and Junio mentioned that I'd missed a few 2.6 references in my
> initial pass.  Here's a second attempt that does some deeper
> reworking of the effected sections.

No comments after a week, so I'm giving this patch series a bump ;).

Thanks,
Trevor

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

^ permalink raw reply	[flat|nested] 18+ messages in thread

* Re: [PATCH v2 0/4] Update linux-2.6.git location and related examples
  2013-06-30  1:05             ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
@ 2013-06-30  1:44               ` Junio C Hamano
  2013-06-30 10:48                 ` W. Trevor King
  0 siblings, 1 reply; 18+ messages in thread
From: Junio C Hamano @ 2013-06-30  1:44 UTC (permalink / raw)
  To: W. Trevor King; +Cc: Git, David Aguilar

"W. Trevor King" <wking@tremily.us> writes:

> On Sat, Jun 22, 2013 at 10:46:23AM -0400, W. Trevor King wrote:
>> David and Junio mentioned that I'd missed a few 2.6 references in my
>> initial pass.  Here's a second attempt that does some deeper
>> reworking of the effected sections.
>
> No comments after a week, so I'm giving this patch series a bump ;).

Hmph, didn't I queue them on 'pu' already?

^ permalink raw reply	[flat|nested] 18+ messages in thread

* Re: [PATCH v2 0/4] Update linux-2.6.git location and related examples
  2013-06-30  1:44               ` Junio C Hamano
@ 2013-06-30 10:48                 ` W. Trevor King
  0 siblings, 0 replies; 18+ messages in thread
From: W. Trevor King @ 2013-06-30 10:48 UTC (permalink / raw)
  To: Junio C Hamano; +Cc: Git, David Aguilar

[-- Attachment #1: Type: text/plain, Size: 783 bytes --]

On Sat, Jun 29, 2013 at 06:44:34PM -0700, Junio C Hamano wrote:
> "W. Trevor King" <wking@tremily.us> writes:
> 
> > On Sat, Jun 22, 2013 at 10:46:23AM -0400, W. Trevor King wrote:
> >> David and Junio mentioned that I'd missed a few 2.6 references in my
> >> initial pass.  Here's a second attempt that does some deeper
> >> reworking of the effected sections.
> >
> > No comments after a week, so I'm giving this patch series a bump ;).
> 
> Hmph, didn't I queue them on 'pu' already?

Oops, that would be my first time having a patch series queued without
comment ;).  Sorry for the noise.

Thanks,
Trevor

-- 
This email may be signed or encrypted with GnuPG (http://www.gnupg.org).
For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

^ permalink raw reply	[flat|nested] 18+ messages in thread

end of thread, other threads:[~2013-06-30 10:48 UTC | newest]

Thread overview: 18+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2013-06-19  1:55 [PATCH 0/2] Update linux-2.6.git location and repo size W. Trevor King
2013-06-19  1:55 ` [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git' W. Trevor King
2013-06-19  5:05   ` David Aguilar
2013-06-19 11:48     ` W. Trevor King
2013-06-19 19:47       ` W. Trevor King
2013-06-19 21:37         ` Junio C Hamano
2013-06-22 14:46           ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
2013-06-22 14:46             ` [PATCH v2 1/4] doc/clone: Remove the '--bare -l -s' example W. Trevor King
2013-06-22 14:46             ` [PATCH v2 2/4] doc/clone: Pick more compelling paths for the --reference example W. Trevor King
2013-06-22 14:46             ` [PATCH v2 3/4] Documentation: Update the NFS remote examples to use the staging repo W. Trevor King
2013-06-22 14:46             ` [PATCH v2 4/4] Documentation: Update 'linux-2.6.git' -> 'linux.git' W. Trevor King
2013-06-30  1:05             ` [PATCH v2 0/4] Update linux-2.6.git location and related examples W. Trevor King
2013-06-30  1:44               ` Junio C Hamano
2013-06-30 10:48                 ` W. Trevor King
2013-06-19 17:07   ` [PATCH 1/2] Documentation: Update 'linux-2.6.git' -> 'linux.git' Junio C Hamano
2013-06-19  1:55 ` [PATCH 2/2] user-manual: Update download size for Git and the kernel W. Trevor King
2013-06-19 17:07   ` Junio C Hamano
2013-06-22 12:40   ` W. Trevor King

Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).