From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carl Worth Subject: [PATCH] Mention version 1.5.1 in tutorial and user-manual Date: Fri, 04 May 2007 11:27:10 -0700 Message-ID: <87wszola0x.wl%cworth@cworth.org> Mime-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka") Content-Type: multipart/signed; boundary="pgp-sign-Multipart_Fri_May__4_11:27:10_2007-1"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Cc: git@vger.kernel.org To: Junio C Hamano X-From: git-owner@vger.kernel.org Fri May 04 20:27:24 2007 Return-path: Envelope-to: gcvg-git@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1Hk2V0-0006Qr-OG for gcvg-git@gmane.org; Fri, 04 May 2007 20:27:23 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1031409AbXEDS1O (ORCPT ); Fri, 4 May 2007 14:27:14 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1031509AbXEDS1N (ORCPT ); Fri, 4 May 2007 14:27:13 -0400 Received: from theworths.org ([217.160.253.102]:34560 "EHLO theworths.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1031409AbXEDS1M (ORCPT ); Fri, 4 May 2007 14:27:12 -0400 Received: (qmail 32599 invoked from network); 4 May 2007 14:27:10 -0400 Received: from localhost (HELO raht.cworth.org) (127.0.0.1) by localhost with SMTP; 4 May 2007 14:27:10 -0400 User-Agent: Wanderlust/2.14.0 (Africa) Emacs/21.4 Mule/5.0 (SAKAKI) Sender: git-owner@vger.kernel.org Precedence: bulk X-Mailing-List: git@vger.kernel.org Archived-At: --pgp-sign-Multipart_Fri_May__4_11:27:10_2007-1 Content-Type: text/plain; charset=US-ASCII Most other documentation will frequently be read from an installation of git so will naturally be associated with the installed version. But these two documents in particular are often read from web pages while users are still exploring git. It's important to mention version 1.5.1 since these documents provide example commands that won't work with previous versions of git. --- This really tripped up a recent friend who tried to go through the tutorial on the web page while following along with a 1.4 version of git, and got very confused. There's definitely a bunch more that could be done here, (include a paragraph explaining which version of git is necessary, mention where to go to upgrade git, call out particular commands that require specific versions of git, dynamically generate the version that gets stuck into the documentation, etc.). But I just went with the most minimal think I could think of to solve the problem -Carl Documentation/tutorial.txt | 4 ++-- Documentation/user-manual.txt | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/tutorial.txt b/Documentation/tutorial.txt index e978562..99efce4 100644 --- a/Documentation/tutorial.txt +++ b/Documentation/tutorial.txt @@ -1,5 +1,5 @@ -A tutorial introduction to git -============================== +A tutorial introduction to git (for version 1.5.1 or newer) +=========================================================== This tutorial explains how to import a new project into git, make changes to it, and share changes with other developers. diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index 9c4c41d..dff438f 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -1,5 +1,5 @@ -Git User's Manual -_________________ +Git User's Manual (for version 1.5.1 or newer) +______________________________________________ This manual is designed to be readable by someone with basic unix command-line skills, but no previous knowledge of git. -- 1.5.1.1.g6aead --pgp-sign-Multipart_Fri_May__4_11:27:10_2007-1 Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (GNU/Linux) iD8DBQBGO3r+6JDdNq8qSWgRArZuAKCZTF0UmDJg/LWOmOepRJFSrnlIUwCfWHZc jNw13JdbC5WRnpK1FA5rphs= =VSK9 -----END PGP SIGNATURE----- --pgp-sign-Multipart_Fri_May__4_11:27:10_2007-1--