From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?UTF-8?q?Nguy=E1=BB=85n=20Th=C3=A1i=20Ng=E1=BB=8Dc=20Duy?= Subject: [PATCH 07/19] glossary: define pathspec Date: Mon, 13 Dec 2010 16:46:44 +0700 Message-ID: <1292233616-27692-8-git-send-email-pclouds@gmail.com> References: <1292233616-27692-1-git-send-email-pclouds@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: QUOTED-PRINTABLE Cc: Junio C Hamano , Jonathan Nieder , =?UTF-8?q?Nguy=E1=BB=85n=20Th=C3=A1i=20Ng=E1=BB=8Dc=20Duy?= To: git@vger.kernel.org X-From: git-owner@vger.kernel.org Mon Dec 13 10:49:02 2010 Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PS51g-0004rO-MP for gcvg-git-2@lo.gmane.org; Mon, 13 Dec 2010 10:49:01 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752109Ab0LMJst convert rfc822-to-quoted-printable (ORCPT ); Mon, 13 Dec 2010 04:48:49 -0500 Received: from mail-iw0-f170.google.com ([209.85.214.170]:37332 "EHLO mail-iw0-f170.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751819Ab0LMJss (ORCPT ); Mon, 13 Dec 2010 04:48:48 -0500 Received: by iwn6 with SMTP id 6so8884031iwn.1 for ; Mon, 13 Dec 2010 01:48:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:received:from:to:cc:subject :date:message-id:x-mailer:in-reply-to:references:mime-version :content-type:content-transfer-encoding; bh=D1VgooDBmaAwvI5I1anHVbsWhk9GdwZpTHBi0T71DmY=; b=sg4ipU38Dn31l9C2RsWugZmOiaDNhaQ2xtTeRGbjpP5rn+JMXxXh+LsdWIkc4xo05o ij79ELow1xDsKmstd4NfIJbBGJEP4AG556RYawhmOK3JM0oDzbQHn91lFmfNHVmcrH+r w9xlsIwG7pqnKFpel9JqmaqzzzjlksVpAUISA= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:cc:subject:date:message-id:x-mailer:in-reply-to:references :mime-version:content-type:content-transfer-encoding; b=MxS8AMEE3+0yTdK5JXWiF4xvKUnARP9Z+U459X/Z+HolCFE/KKpEgbs8icpkPfvLXk XcAiL6mv04OU7hR1Ch3za318iL9kgbbiJzMgdgm9Mb0CEzOheVFOKpLFTCvmVMRWdtx7 BwtmhNo0tm9AdogrFbORY9BWRAFR2FJ4/S8Is= Received: by 10.231.173.67 with SMTP id o3mr1635160ibz.29.1292233728342; Mon, 13 Dec 2010 01:48:48 -0800 (PST) Received: from pclouds@gmail.com ([115.73.222.178]) by mx.google.com with ESMTPS id z4sm6050775ibg.1.2010.12.13.01.48.44 (version=TLSv1/SSLv3 cipher=RC4-MD5); Mon, 13 Dec 2010 01:48:47 -0800 (PST) Received: by pclouds@gmail.com (sSMTP sendmail emulation); Mon, 13 Dec 2010 16:47:54 +0700 X-Mailer: git-send-email 1.7.3.3.476.g10a82 In-Reply-To: <1292233616-27692-1-git-send-email-pclouds@gmail.com> Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: =46rom: Jonathan Nieder Signed-off-by: Nguy=E1=BB=85n Th=C3=A1i Ng=E1=BB=8Dc Duy --- Documentation/glossary-content.txt | 23 +++++++++++++++++++++++ 1 files changed, 23 insertions(+), 0 deletions(-) diff --git a/Documentation/glossary-content.txt b/Documentation/glossar= y-content.txt index 1f029f8..4ed2a28 100644 --- a/Documentation/glossary-content.txt +++ b/Documentation/glossary-content.txt @@ -273,6 +273,29 @@ This commit is referred to as a "merge commit", or= sometimes just a <>, to assist in efficiently accessing the contents of= a pack. =20 +[[def_pathspec]]pathspec:: + Pattern used to specify paths. ++ +Pathspecs are used on the command line of "git ls-files", "git +ls-tree", "git grep", "git checkout", and many other commands to +limit the scope of operations to some subset of the tree or +worktree. See the documentation of each command for whether +paths are relative to the current directory or toplevel. The +pathspec syntax is as follows: + +* any path matches itself +* the pathspec up to the last slash represents a + directory prefix. The scope of that pathspec is + limited to that subtree. +* the rest of the pathspec is a pattern for the remainder + of the pathname. Paths relative to the directory + prefix will be matched against that pattern using fnmatch(3); + in particular, '*' and '?' _can_ match directory separators. ++ +For example, Documentation/*.jpg will match all .jpg files +in the Documentation subtree, +including Documentation/chapter_1/figure_1.jpg. + [[def_parent]]parent:: A <> contains a (possibly empty) lis= t of the logical predecessor(s) in the line of development, i.e. its --=20 1.7.3.3.476.g10a82