mirrors/git - Incest Forge: Beyond sex. We incest.

mirrors/git

mirror of https://github.com/git/git.git synced 2024-11-18 06:54:55 +01:00

110 lines

2.7 KiB

Text

Raw Normal View History

Document git-check-attr Signed-off-by: James Bowes <jbowes@dangerouslyinc.com> Signed-off-by: Junio C Hamano <junkio@cox.net> 2007-04-15 03:27:20 +02:00			`git-check-attr(1)`
			`=================`

			`NAME`
			`----`
Remove the period after the git-check-attr summary The period at the end of the git-check-attr summary causes there to be two periods after the summary in the git(1) manual page. Signed-off-by: Matt Kraai <kraai@ftbfs.org> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2008-11-07 13:26:55 +01:00			`git-check-attr - Display gitattributes information`
Document git-check-attr Signed-off-by: James Bowes <jbowes@dangerouslyinc.com> Signed-off-by: Junio C Hamano <junkio@cox.net> 2007-04-15 03:27:20 +02:00

			`SYNOPSIS`
			`--------`
git-check-attr(1): use 'verse' for multi-line synopsis sections Signed-off-by: Jonas Fonseca <fonseca@diku.dk> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2008-10-15 09:11:52 +02:00			`[verse]`
git-check-attr: Add an --all option to show all attributes Add new usage patterns git check-attr [-a \| --all] [--] pathname... git check-attr --stdin [-a \| --all] < <list-of-paths> which display all attributes associated with the specified file(s). Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2011-08-04 06:36:30 +02:00			`'git check-attr' [-a \| --all \| attr...] [--] pathname...`
			`'git check-attr' --stdin [-z] [-a \| --all \| attr...] < <list-of-paths>`
Document git-check-attr Signed-off-by: James Bowes <jbowes@dangerouslyinc.com> Signed-off-by: Junio C Hamano <junkio@cox.net> 2007-04-15 03:27:20 +02:00
			`DESCRIPTION`
			`-----------`
Documentation: minor grammatical fixes in git-check-attr.txt Signed-off-by: David J. Mellor <dmellor@whistlingcat.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2009-03-23 02:00:16 +01:00			`For every pathname, this command will list if each attribute is 'unspecified',`
Document git-check-attr Signed-off-by: James Bowes <jbowes@dangerouslyinc.com> Signed-off-by: Junio C Hamano <junkio@cox.net> 2007-04-15 03:27:20 +02:00			`'set', or 'unset' as a gitattribute on that pathname.`

			`OPTIONS`
			`-------`
git-check-attr: Add an --all option to show all attributes Add new usage patterns git check-attr [-a \| --all] [--] pathname... git check-attr --stdin [-a \| --all] < <list-of-paths> which display all attributes associated with the specified file(s). Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2011-08-04 06:36:30 +02:00			`-a, --all::`
			`List all attributes that are associated with the specified`
			`paths. If this option is used, then 'unspecified' attributes`
			`will not be included in the output.`

Teach '--cached' option to check-attr This option causes check-attr to consider .gitattributes only from the index, ignoring .gitattributes from the working tree. This allows the command to be used in situations where a working tree does not exist. Signed-off-by: Jay Soffian <jaysoffian@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2011-09-22 23:44:20 +02:00			`--cached::`
			Consider `.gitattributes` in the index only, ignoring the working tree.

check-attr: Add --stdin option This allows multiple paths to be specified on stdin. Signed-off-by: Dmitry Potapov <dpotapov@gmail.com> Signed-off-by: Shawn O. Pearce <spearce@spearce.org> 2008-10-07 02:16:52 +02:00			`--stdin::`
			`Read file names from stdin instead of from the command-line.`

			`-z::`
Documentation: minor grammatical fixes in git-check-attr.txt Signed-off-by: David J. Mellor <dmellor@whistlingcat.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2009-03-23 02:00:16 +01:00			Only meaningful with `--stdin`; paths are separated with a
			`NUL character instead of a linefeed character.`
check-attr: Add --stdin option This allows multiple paths to be specified on stdin. Signed-off-by: Dmitry Potapov <dpotapov@gmail.com> Signed-off-by: Shawn O. Pearce <spearce@spearce.org> 2008-10-07 02:16:52 +02:00
Document git-check-attr Signed-off-by: James Bowes <jbowes@dangerouslyinc.com> Signed-off-by: Junio C Hamano <junkio@cox.net> 2007-04-15 03:27:20 +02:00			`\--::`
Documentation: minor grammatical fixes in git-check-attr.txt Signed-off-by: David J. Mellor <dmellor@whistlingcat.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2009-03-23 02:00:16 +01:00			`Interpret all preceding arguments as attributes and all following`
git-check-attr: Fix command-line handling to match docs According to the git-check-attr synopsis, if the '--stdin' option is used then no pathnames are expected on the command line. Change the behavior to match this description; namely, if '--stdin' is used but not '--', then treat all command-line arguments as attribute names. Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2011-08-04 06:36:32 +02:00			`arguments as path names.`

			If none of `--stdin`, `--all`, or `--` is used, the first argument
			`will be treated as an attribute and the rest of the arguments as`
			`pathnames.`
Document git-check-attr Signed-off-by: James Bowes <jbowes@dangerouslyinc.com> Signed-off-by: Junio C Hamano <junkio@cox.net> 2007-04-15 03:27:20 +02:00
git-check-attr(1): add output and example sections Plumbing tools should document what output can be expected. Signed-off-by: Jonas Fonseca <fonseca@diku.dk> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2008-10-15 09:10:58 +02:00			`OUTPUT`
			`------`

			`The output is of the form:`
			`<path> COLON SP <attribute> COLON SP <info> LF`

Documentation: minor grammatical fixes in git-check-attr.txt Signed-off-by: David J. Mellor <dmellor@whistlingcat.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2009-03-23 02:00:16 +01:00			`<path> is the path of a file being queried, <attribute> is an attribute`
git-check-attr(1): add output and example sections Plumbing tools should document what output can be expected. Signed-off-by: Jonas Fonseca <fonseca@diku.dk> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2008-10-15 09:10:58 +02:00			`being queried and <info> can be either:`

			`'unspecified';; when the attribute is not defined for the path.`
Documentation: minor grammatical fixes in git-check-attr.txt Signed-off-by: David J. Mellor <dmellor@whistlingcat.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2009-03-23 02:00:16 +01:00			`'unset';; when the attribute is defined as false.`
			`'set';; when the attribute is defined as true.`
git-check-attr(1): add output and example sections Plumbing tools should document what output can be expected. Signed-off-by: Jonas Fonseca <fonseca@diku.dk> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2008-10-15 09:10:58 +02:00			`<value>;; when a value has been assigned to the attribute.`

			`EXAMPLES`
			`--------`

			`In the examples, the following '.gitattributes' file is used:`
			`---------------`
			`*.java diff=java -crlf myAttr`
			`NoMyAttr.java !myAttr`
			`README caveat=unspecified`
			`---------------`

			`* Listing a single attribute:`
			`---------------`
			`$ git check-attr diff org/example/MyClass.java`
			`org/example/MyClass.java: diff: java`
			`---------------`

			`* Listing multiple attributes for a file:`
			`---------------`
			`$ git check-attr crlf diff myAttr -- org/example/MyClass.java`
			`org/example/MyClass.java: crlf: unset`
			`org/example/MyClass.java: diff: java`
			`org/example/MyClass.java: myAttr: set`
			`---------------`

git-check-attr: Add an --all option to show all attributes Add new usage patterns git check-attr [-a \| --all] [--] pathname... git check-attr --stdin [-a \| --all] < <list-of-paths> which display all attributes associated with the specified file(s). Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2011-08-04 06:36:30 +02:00			`* Listing all attributes for a file:`
			`---------------`
			`$ git check-attr --all -- org/example/MyClass.java`
			`org/example/MyClass.java: diff: java`
			`org/example/MyClass.java: myAttr: set`
			`---------------`

Documentation: minor grammatical fixes in git-check-attr.txt Signed-off-by: David J. Mellor <dmellor@whistlingcat.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2009-03-23 02:00:16 +01:00			`* Listing an attribute for multiple files:`
git-check-attr(1): add output and example sections Plumbing tools should document what output can be expected. Signed-off-by: Jonas Fonseca <fonseca@diku.dk> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2008-10-15 09:10:58 +02:00			`---------------`
			`$ git check-attr myAttr -- org/example/MyClass.java org/example/NoMyAttr.java`
			`org/example/MyClass.java: myAttr: set`
			`org/example/NoMyAttr.java: myAttr: unspecified`
			`---------------`

			`* Not all values are equally unambiguous:`
			`---------------`
			`$ git check-attr caveat README`
			`README: caveat: unspecified`
			`---------------`
Document git-check-attr Signed-off-by: James Bowes <jbowes@dangerouslyinc.com> Signed-off-by: Junio C Hamano <junkio@cox.net> 2007-04-15 03:27:20 +02:00
Documentation: describe 'union' low-level merge driver Signed-off-by: Junio C Hamano <gitster@pobox.com> 2007-12-23 08:14:59 +01:00			`SEE ALSO`
			`--------`
Documentation: rename gitlink macro to linkgit Between AsciiDoc 8.2.2 and 8.2.3, the following change was made to the stock Asciidoc configuration: @@ -149,7 +153,10 @@ # Inline macros. # Backslash prefix required for escape processing. # (?s) re flag for line spanning. -(?su)[\\]?(?P<name>\w(\w\|-)?):(?P<target>\S?)(\[(?P<attrlist>.?)\])= + +# Explicit so they can be nested. +(?su)[\\]?(?P<name>(http\|https\|ftp\|file\|mailto\|callto\|image\|link)):(?P<target>\S?)(\[(?P<attrlist>.?)\])= + # Anchor: [[[id]]]. Bibliographic anchor. (?su)[\\]?\[\[\[(?P<attrlist>[\w][\w-]?)\]\]\]=anchor3 # Anchor: [[id,xreflabel]] This default regex now matches explicit values, and unfortunately in this case gitlink was being matched by just 'link', causing the wrong inline macro template to be applied. By renaming the macro, we can avoid being matched by the wrong regex. Signed-off-by: Dan McGee <dpmcgee@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2007-12-29 07:20:38 +01:00			`linkgit:gitattributes[5].`
Documentation: describe 'union' low-level merge driver Signed-off-by: Junio C Hamano <gitster@pobox.com> 2007-12-23 08:14:59 +01:00
Document git-check-attr Signed-off-by: James Bowes <jbowes@dangerouslyinc.com> Signed-off-by: Junio C Hamano <junkio@cox.net> 2007-04-15 03:27:20 +02:00			`GIT`
			`---`
documentation: move git(7) to git(1) As the "git" man page describes the "git" command at the end-user level, it seems better to move it to man section 1. Signed-off-by: Christian Couder <chriscool@tuxfamily.org> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2008-06-06 09:07:32 +02:00			`Part of the linkgit:git[1] suite`