From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jonathan Nieder Subject: Documentation: user-manual: "git commit -a" doesn't motivate .gitignore Date: Wed, 6 Aug 2008 16:22:00 -0500 (CDT) Message-ID: Mime-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII To: git@vger.kernel.org X-From: git-owner@vger.kernel.org Wed Aug 06 23:23:42 2008 Return-path: Envelope-to: gcvg-git-2@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1KQqTe-00015K-Rt for gcvg-git-2@gmane.org; Wed, 06 Aug 2008 23:23:27 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1759161AbYHFVWH (ORCPT ); Wed, 6 Aug 2008 17:22:07 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1762992AbYHFVWH (ORCPT ); Wed, 6 Aug 2008 17:22:07 -0400 Received: from smtp01.uchicago.edu ([128.135.12.77]:44421 "EHLO smtp01.uchicago.edu" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753161AbYHFVWF (ORCPT ); Wed, 6 Aug 2008 17:22:05 -0400 Received: from harper.uchicago.edu (harper.uchicago.edu [128.135.12.7]) by smtp01.uchicago.edu (8.13.8/8.13.8) with ESMTP id m76LM07D017234 for ; Wed, 6 Aug 2008 16:22:02 -0500 Received: from localhost (jrnieder@localhost) by harper.uchicago.edu (8.12.10/8.12.10) with ESMTP id m76LM0XA019644 for ; Wed, 6 Aug 2008 16:22:00 -0500 (CDT) X-Authentication-Warning: harper.uchicago.edu: jrnieder owned process doing -bs Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: "git commit -a" ignores untracked files and follows all tracked files, regardless of whether they are listed in .gitignore. So don't use it to motivate gitignore. Signed-off-by: Jonathan Nieder --- I noticed this while reading through the git-scm book, which looks very good. If I am missing something, I would be very happy to know. Maybe the sort of person that wants to track the exact contents of the working tree would prefer "git commit -a -i ." over "git commit -a"? Documentation/user-manual.txt | 4 ++-- 1 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index 43f4e39..f421689 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -1128,8 +1128,8 @@ This typically includes files generated by a build process or temporary backup files made by your editor. Of course, 'not' tracking files with git is just a matter of 'not' calling "`git-add`" on them. But it quickly becomes annoying to have these untracked files lying around; e.g. they make -"`git add .`" and "`git commit -a`" practically useless, and they keep -showing up in the output of "`git status`". +"`git add .`" practically useless, and they keep showing up in the output of +"`git status`". You can tell git to ignore certain files by creating a file called .gitignore in the top level of your working directory, with contents such as: -- 1.6.0.rc1.228.ge730