Karthik Nayak 1bb38e5a6a ref-filter: add support for %(contents:lines=X) ...

In 'tag.c' we can print N lines from the annotation of the tag using
the '-n<num>' option. Copy code from 'tag.c' to 'ref-filter' and
modify it to support appending of N lines from the annotation of tags
to the given strbuf.

Implement %(contents:lines=X) where X lines of the given object are
obtained.

While we're at it, remove unused "contents:<suboption>" atoms from
the `valid_atom` array.

Add documentation and test for the same.

Mentored-by: Christian Couder <christian.couder@gmail.com>
Mentored-by: Matthieu Moy <matthieu.moy@grenoble-inp.fr>
Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

2015-09-17 10:02:48 -07:00

..

howto

command-list.txt: add the common groups block

2015-05-21 13:03:37 -07:00

RelNotes

Sync with maint

2015-08-03 11:20:07 -07:00

technical

Merge branch 'pt/pull-builtin'

2015-08-03 11:01:17 -07:00

.gitattributes

…

.gitignore

…

asciidoc.conf

…

blame-options.txt

Sync with 2.3.8

2015-05-11 14:39:28 -07:00

build-docdep.perl

…

cat-texi.perl

Documentation: Strip texinfo anchors to avoid duplicates

2013-04-03 16:14:19 -07:00

cmd-list.perl

command-list: prepare machinery for upcoming "common groups" section

2015-05-21 13:03:37 -07:00

CodingGuidelines

Merge branch 'jg/cguide-we-cannot-count' into maint

2015-04-21 12:12:19 -07:00

config.txt

Merge branch 'gr/rebase-i-drop-warn'

2015-08-03 11:01:22 -07:00

date-formats.txt

Correct word usage of "timezone" in "Documentation" directory

2013-11-12 10:47:17 -08:00

diff-config.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

diff-format.txt

diff-format doc: a score can follow M for rewrite

2015-01-28 22:22:03 -08:00

diff-generate-patch.txt

doc: fix misrendering due to `single quote'

2015-05-12 22:13:39 -07:00

diff-options.txt

Merge branch 'mm/log-format-raw-doc' into maint

2015-06-16 14:33:43 -07:00

docbook-xsl.css

…

docbook.xsl

…

everyday.txto

doc: add 'everyday' to 'git help'

2014-10-10 16:02:26 -07:00

fetch-options.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

fix-texi.perl

…

fmt-merge-msg-config.txt

Documentation: include 'merge.branchdesc' for merge and config as well

2015-05-28 12:38:46 -07:00

git-add.txt

Merge branch 'jk/asciidoc-markup-fix' into maint

2015-06-05 12:00:19 -07:00

git-am.txt

Revert "git-am: add am.threeWay config variable"

2015-07-24 10:55:24 -07:00

git-annotate.txt

…

git-apply.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-archimport.txt

…

git-archive.txt

docs: clarify remote restrictions for git-upload-archive

2014-02-28 09:55:35 -08:00

git-bisect-lk2009.txt

Documentation: typofixes

2014-11-04 13:14:44 -08:00

git-bisect.txt

Documentation: use "command-line" when used as a compound adjective, and fix other minor grammatical issues

2014-05-21 13:57:10 -07:00

git-blame.txt

blame: add blame.showEmail configuration

2015-06-01 15:50:43 -07:00

git-branch.txt

Merge branch 'mm/branch-doc-updates' into maint

2015-07-27 12:21:46 -07:00

git-bundle.txt

…

git-cat-file.txt

cat-file: sort and de-dup output of --batch-all-objects

2015-06-26 09:24:42 -07:00

git-check-attr.txt

Merge branch 'jc/check-x-z'

2013-09-04 12:23:25 -07:00

git-check-ignore.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-check-mailmap.txt

builtin: add git-check-mailmap command

2013-07-13 10:19:37 -07:00

git-check-ref-format.txt

refs: loosen restriction on wildcard "*" refspecs

2015-07-27 09:21:31 -07:00

git-checkout-index.txt

…

git-checkout.txt

Merge branch 'se/doc-checkout-ours-theirs'

2015-08-03 11:01:25 -07:00

git-cherry-pick.txt

cherry-pick: fix docs describing handling of empty commits

2015-03-30 21:49:51 -07:00

git-cherry.txt

Documentation: revamp git-cherry(1)

2013-11-27 12:16:49 -08:00

git-citool.txt

…

git-clean.txt

Merge branch 'mr/doc-clean-f-f' into maint

2015-03-13 22:56:12 -07:00

git-clone.txt

clone: --dissociate option to mark that reference is only temporary

2014-10-15 14:34:45 -07:00

git-column.txt

doc: remote author/documentation sections from more pages

2014-01-27 08:34:34 -08:00

git-commit-tree.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-commit.txt

Merge branch 'mc/commit-doc-grammofix' into maint

2015-06-16 14:33:49 -07:00

git-config.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-count-objects.txt

Documentation: fix misuses of "nor"

2014-03-31 15:16:22 -07:00

git-credential-cache--daemon.txt

credential-cache: close stderr in daemon process

2014-09-16 11:11:58 -07:00

git-credential-cache.txt

…

git-credential-store.txt

git-credential-store: support XDG_CONFIG_HOME

2015-03-24 08:08:02 -07:00

git-credential.txt

Documentation: make AsciiDoc links always point to HTML files

2013-09-06 14:49:06 -07:00

git-cvsexportcommit.txt

…

git-cvsimport.txt

Documentation: typofixes

2014-11-04 13:14:44 -08:00

git-cvsserver.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-daemon.txt

Documentation: use "command-line" when used as a compound adjective, and fix other minor grammatical issues

2014-05-21 13:57:10 -07:00

git-describe.txt

Documentation/describe: improve one-line summary

2015-06-16 13:19:34 -07:00

git-diff-files.txt

…

git-diff-index.txt

Documentation/diff-index: mention two modes of operation

2013-05-20 15:50:44 -07:00

git-diff-tree.txt

…

git-diff.txt

Documentation: fix misuses of "nor"

2014-03-31 15:16:22 -07:00

git-difftool.txt

difftool: add support for --trust-exit-code

2014-10-28 10:36:57 -07:00

git-fast-export.txt

doc: convert \--option to --option

2015-05-12 22:14:46 -07:00

git-fast-import.txt

Merge branch 'mh/fast-import-get-mark'

2015-08-03 11:01:23 -07:00

git-fetch-pack.txt

doc: convert \--option to --option

2015-05-12 22:14:46 -07:00

git-fetch.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-filter-branch.txt

Documentation: typofixes

2014-11-04 13:14:44 -08:00

git-fmt-merge-msg.txt

Documentation: include 'merge.branchdesc' for merge and config as well

2015-05-28 12:38:46 -07:00

git-for-each-ref.txt

ref-filter: add support for %(contents:lines=X)

2015-09-17 10:02:48 -07:00

git-format-patch.txt

Merge branch 'fk/doc-format-patch-vn' into maint

2015-07-15 11:41:22 -07:00

git-fsck-objects.txt

…

git-fsck.txt

fsck: introduce git fsck --connectivity-only

2015-06-23 14:27:37 -07:00

git-gc.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-get-tar-commit-id.txt

…

git-grep.txt

grep: add grep.fullName config variable

2014-03-20 12:38:00 -07:00

git-gui.txt

…

git-hash-object.txt

git-hash-object.txt: document --literally option

2015-05-04 14:19:23 -07:00

git-help.txt

Documentation: use "command-line" when used as a compound adjective, and fix other minor grammatical issues

2014-05-21 13:57:10 -07:00

git-http-backend.txt

Merge branch 'jk/http-backend-deadlock' into maint

2015-06-16 14:33:45 -07:00

git-http-fetch.txt

…

git-http-push.txt

…

git-imap-send.txt

imap-send: use cURL automatically when NO_OPENSSL defined

2015-03-10 15:19:05 -07:00

git-index-pack.txt

clone: open a shortcut for connectivity check

2013-05-28 08:07:20 -07:00

git-init-db.txt

…

git-init.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-instaweb.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-interpret-trailers.txt

Documentation: typofixes

2014-11-04 13:14:44 -08:00

git-log.txt

log: add "log.follow" configuration variable

2015-07-09 10:24:23 -07:00

git-ls-files.txt

Documentation: use "command-line" when used as a compound adjective, and fix other minor grammatical issues

2014-05-21 13:57:10 -07:00

git-ls-remote.txt

ls-remote doc: don't encourage use of branches-file

2013-06-23 00:33:58 -07:00

git-ls-tree.txt

…

git-mailinfo.txt

git-mailinfo: add --message-id

2014-11-25 15:24:55 -08:00

git-mailsplit.txt

…

git-merge-base.txt

merge-base: teach "--fork-point" mode

2013-10-29 13:06:08 -07:00

git-merge-file.txt

Documentation/git-merge-file: document option "--diff3"

2013-08-09 14:19:59 -07:00

git-merge-index.txt

The name of the hash function is "SHA-1", not "SHA1"

2013-04-15 11:08:37 -07:00

git-merge-one-file.txt

…

git-merge-tree.txt

use 'tree-ish' instead of 'treeish'

2013-09-04 15:02:56 -07:00

git-merge.txt

Merge branch 'jc/merge'

2015-05-19 13:17:57 -07:00

git-mergetool--lib.txt

…

git-mergetool.txt

mergetool: document the default for --[no-]prompt

2014-04-24 11:29:05 -07:00

git-mktag.txt

…

git-mktree.txt

…

git-mv.txt

mv: better document side effects when moving a submodule

2014-01-07 14:33:04 -08:00

git-name-rev.txt

use 'commit-ish' instead of 'committish'

2013-09-04 15:03:03 -07:00

git-notes.txt

builtin/notes: add --allow-empty, to allow storing empty notes

2014-11-12 11:00:11 -08:00

git-p4.txt

git-p4: use -m when running p4 changes

2015-04-20 12:36:00 -07:00

git-pack-objects.txt

doc: convert \--option to --option

2015-05-12 22:14:46 -07:00

git-pack-redundant.txt

…

git-pack-refs.txt

Documentation: remove --prune from pack-refs examples

2013-07-18 16:23:46 -07:00

git-parse-remote.txt

…

git-patch-id.txt

patch-id: make it stable against hunk reordering

2014-06-10 13:09:24 -07:00

git-prune-packed.txt

Documentation: adjust document title underlining

2014-10-13 13:35:18 -07:00

git-prune.txt

worktree: new place for "git prune --worktrees"

2015-06-29 08:48:44 -07:00

git-pull.txt

pull: handle git-fetch's options as well

2015-06-02 13:36:22 -07:00

git-push.txt

Merge branch 'jk/asciidoc-markup-fix' into maint

2015-06-05 12:00:19 -07:00

git-quiltimport.txt

Documentation: adjust document title underlining

2014-10-13 13:35:18 -07:00

git-read-tree.txt

Documentation: use "command-line" when used as a compound adjective, and fix other minor grammatical issues

2014-05-21 13:57:10 -07:00

git-rebase.txt

Merge branch 'gr/rebase-i-drop-warn'

2015-08-03 11:01:22 -07:00

git-receive-pack.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-reflog.txt

git-reflog: add exists command

2015-07-21 14:08:14 -07:00

git-relink.txt

…

git-remote-ext.txt

doc: add some crossrefs between manual pages

2014-11-11 14:47:04 -08:00

git-remote-fd.txt

doc: add some crossrefs between manual pages

2014-11-11 14:47:04 -08:00

git-remote-helpers.txto

…

git-remote-testgit.txt

…

git-remote.txt

Merge branch 'mg/doc-remote-tags-or-not' into maint

2015-03-13 22:56:05 -07:00

git-repack.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-replace.txt

Merge branch 'cc/replace-graft'

2014-07-27 15:14:18 -07:00

git-request-pull.txt

request-pull: documentation updates

2014-03-13 14:22:20 -07:00

git-rerere.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

git-reset.txt

Merge branch 'jl/nor-or-nand-and'

2014-04-08 12:00:28 -07:00

git-rev-list.txt

rev-list: add --count to usage guide

2015-07-01 09:29:11 -07:00

git-rev-parse.txt

rev-parse --parseopt: allow [*=?!] in argument hints

2015-07-15 10:30:54 -07:00

git-revert.txt

parse-options: multi-word argh should use dash to separate words

2014-03-24 10:43:34 -07:00

git-rm.txt

rm: better document side effects when removing a submodule

2014-01-07 14:34:06 -08:00

git-send-email.txt

Merge branch 'rl/send-email-aliases'

2015-08-03 11:01:15 -07:00

git-send-pack.txt

Merge branch 'jk/asciidoc-markup-fix' into maint

2015-06-05 12:00:19 -07:00

git-sh-i18n--envsubst.txt

…

git-sh-i18n.txt

…

git-sh-setup.txt

Merge branch 'jc/reflog-doc'

2013-10-18 13:50:12 -07:00

git-shell.txt

shell doc: remove stray "+" in example

2014-05-08 10:26:26 -07:00

git-shortlog.txt

git-shortlog.txt: make SYNOPSIS match log, update OPTIONS

2013-04-21 23:11:02 -07:00

git-show-branch.txt

Documentation: fix misuses of "nor"

2014-03-31 15:16:22 -07:00

git-show-index.txt

The name of the hash function is "SHA-1", not "SHA1"

2013-04-15 11:08:37 -07:00

git-show-ref.txt

Documentation: fix misuses of "nor"

2014-03-31 15:16:22 -07:00

git-show.txt

doc: convert \--option to --option

2015-05-12 22:14:46 -07:00

git-stage.txt

Documentation: adjust document title underlining

2014-10-13 13:35:18 -07:00

git-stash.txt

stash doc: mention short form -k in save description

2014-02-24 09:13:30 -08:00

git-status.txt

Merge branch 'nd/untracked-cache'

2015-05-26 13:24:46 -07:00

git-stripspace.txt

Merge branch 'jk/stripspace-asciidoctor-fix' into maint

2015-06-05 12:00:21 -07:00

git-submodule.txt

submodule doc: reorder introductory paragraphs

2015-05-28 15:18:11 -07:00

git-svn.txt

doc: put example URLs and emails inside literal backticks

2015-05-12 22:14:46 -07:00

git-symbolic-ref.txt

…

git-tag.txt

Merge branch 'dt/refs-backend-preamble'

2015-08-03 11:01:29 -07:00

git-tools.txt

Documentation/git-tools: retire manually-maintained list

2015-07-28 13:21:59 -07:00

git-unpack-file.txt

…

git-unpack-objects.txt

doc: fix inconsistent spelling of "packfile"

2015-05-22 09:00:17 -07:00

git-update-index.txt

update-index: test the system before enabling untracked cache

2015-03-12 13:45:18 -07:00

git-update-ref.txt

update-ref and tag: add --create-reflog arg

2015-07-21 14:08:35 -07:00

git-update-server-info.txt

…

git-upload-archive.txt

add uploadarchive.allowUnreachable option

2014-02-28 09:55:37 -08:00

git-upload-pack.txt

…

git-var.txt

…

git-verify-commit.txt

verify-commit: add option to print raw gpg status information

2015-06-22 14:20:47 -07:00

git-verify-pack.txt

git-verify-pack.txt: fix inconsistent spelling of "packfile"

2015-05-17 11:24:57 -07:00

git-verify-tag.txt

verify-tag: add option to print raw gpg status information

2015-06-22 14:20:47 -07:00

git-web--browse.txt

Documentation: use "command-line" when used as a compound adjective, and fix other minor grammatical issues

2014-05-21 13:57:10 -07:00

git-whatchanged.txt

whatchanged: document its historical nature

2013-08-13 09:01:54 -07:00

git-worktree.txt

worktree: caution that this is still experimental

2015-07-16 15:59:48 -07:00

git-write-tree.txt

…

git.txt

Sync with maint

2015-08-03 11:20:07 -07:00

gitattributes.txt

userdiff: add support for Fountain documents

2015-07-23 14:44:51 -07:00

gitcli.txt

Documentation: use "command-line" when used as a compound adjective, and fix other minor grammatical issues

2014-05-21 13:57:10 -07:00

gitcore-tutorial.txt

Merge branch 'ja/tutorial-asciidoctor-fix' into maint

2015-06-05 12:00:22 -07:00

gitcredentials.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

gitcvs-migration.txt

doc: add 'everyday' to 'git help'

2014-10-10 16:02:26 -07:00

gitdiffcore.txt

doc: convert \--option to --option

2015-05-12 22:14:46 -07:00

giteveryday.txt

doc: add 'everyday' to 'git help'

2014-10-10 16:02:26 -07:00

gitglossary.txt

doc: add 'everyday' to 'git help'

2014-10-10 16:02:26 -07:00

githooks.txt

receive-pack: support push-to-checkout hook

2015-01-08 14:28:43 -08:00

gitignore.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00

gitk.txt

Documentation: change -L:<regex> to -L:<funcname>

2015-04-20 11:05:50 -07:00

gitmodules.txt

submodule: improve documentation of update subcommand

2015-03-02 14:59:55 -08:00

gitnamespaces.txt

…

gitremote-helpers.txt

doc: drop backslash quoting of some curly braces

2015-05-12 22:14:46 -07:00

gitrepository-layout.txt

git-common-dir: make "modules/" per-working-directory directory

2014-12-01 11:00:19 -08:00

gitrevisions.txt

…

gittutorial-2.txt

Merge branch 'sn/tutorial-status-output-example'

2014-11-19 13:47:59 -08:00

gittutorial.txt

Merge branch 'sn/tutorial-status-output-example'

2014-11-19 13:47:59 -08:00

gitweb.conf.txt

Merge branch 'tf/gitweb-typofix'

2015-07-21 12:45:27 -07:00

gitweb.txt

Documentation: fix documentation AsciiDoc links for external urls

2014-02-20 14:14:58 -08:00

gitworkflows.txt

…

glossary-content.txt

glossary: add "remote", "submodule", "superproject"

2015-05-29 13:36:47 -07:00

howto-index.sh

howto-index.sh: use the $( ... ) construct for command substitution

2014-04-17 11:14:57 -07:00

i18n.txt

Documentation/i18n.txt: clarify character encoding support

2015-07-01 14:55:53 -07:00

install-doc-quick.sh

…

install-webdoc.sh

install-webdoc.sh: use the $( ... ) construct for command substitution

2014-04-17 11:14:58 -07:00

line-range-format.txt

Documentation: change -L:<regex> to -L:<funcname>

2015-04-20 11:05:50 -07:00

mailmap.txt

…

Makefile

Documentation: fix version numbering

2015-01-22 13:44:14 -08:00

manpage-1.72.xsl

…

manpage-base-url.xsl.in

…

manpage-base.xsl

…

manpage-bold-literal.xsl

…

manpage-normal.xsl

…

manpage-quote-apos.xsl

…

manpage-suppress-sp.xsl

…

merge-config.txt

Merge branch 'sg/merge-summary-config' into maint

2015-06-25 11:02:17 -07:00

merge-options.txt

Documentation: fix misuses of "nor"

2014-03-31 15:16:22 -07:00

merge-strategies.txt

Merge branch 'rr/doc-merge-strategies' into maint

2014-04-03 13:39:03 -07:00

pretty-formats.txt

Merge branch 'mm/log-format-raw-doc' into maint

2015-06-16 14:33:43 -07:00

pretty-options.txt

Merge branch 'jk/pretty-encoding-doc' into maint

2015-07-27 12:21:48 -07:00

pull-fetch-param.txt

docs: Explain the purpose of fetch's and pull's <refspec> parameter.

2014-06-12 09:59:13 -07:00

rev-list-options.txt

introduce "format" date-mode

2015-06-29 11:39:10 -07:00

revisions.txt

sha1_name: implement @{push} shorthand

2015-05-22 09:33:08 -07:00

sequencer.txt

…

SubmittingPatches

Merge branch 'jc/submitting-patches-mention-send-email' into maint

2015-03-28 09:33:10 -07:00

urls-remotes.txt

…

urls.txt

Merge branch 'ft/doc-git-transport' into maint

2013-07-21 22:51:24 -07:00

user-manual.conf

…

user-manual.txt

*config.txt: stick to camelCase naming convention

2015-03-13 22:13:46 -07:00