Jean-Noël Avila 77b2d29e91 doc: convert git-notes to new documentation format ...

- Switch the synopsis to a synopsis block which will automatically
  format placeholders in italics and keywords in monospace
- Use _<placeholder>_ instead of <placeholder> in the description
- Use `backticks` for keywords and more complex option
descriptions. The new rendering engine will apply synopsis rules to
these spans.

Signed-off-by: Jean-Noël Avila <jn.avila@free.fr>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

2025-01-10 15:19:52 -08:00

..

config

doc: convert git-notes to new documentation format

2025-01-10 15:19:52 -08:00

howto

meson: generate articles

2024-12-27 08:28:11 -08:00

includes

…

mergetools

mergetools: vimdiff: use correct tool's name when reading mergetool config

2024-02-19 08:45:14 -08:00

RelNotes

A bit more post Git 2.48-rc1

2025-01-01 09:21:15 -08:00

technical

meson: generate articles

2024-12-27 08:28:11 -08:00

.gitattributes

…

.gitignore

Documentation: wire up sanity checks for Meson

2024-12-27 08:28:12 -08:00

asciidoc.conf.in

Documentation: inline user-manual.conf

2024-12-27 08:28:10 -08:00

asciidoctor-extensions.rb.in

asciidoctor-extensions.rb.in: inject GIT_DATE

2024-12-20 17:34:35 -08:00

blame-options.txt

…

BreakingChanges.txt

Merge branch 'jc/breaking-changes-early-adopter-option'

2024-11-01 12:53:14 -04:00

build-docdep.perl

Documentation: allow sourcing generated includes from separate dir

2024-12-07 07:52:12 +09:00

cat-texi.perl

…

cmd-list.perl

Documentation: teach "cmd-list.perl" about out-of-tree builds

2024-12-07 07:52:12 +09:00

CodingGuidelines

Merge branch 'ps/build'

2024-12-15 17:54:33 -08:00

config.txt

Merge branch 'tb/pseudo-merge-reachability-bitmap'

2024-06-24 16:39:13 -07:00

date-formats.txt

Documentation: fix typos describing date format

2024-04-12 09:03:03 -07:00

DecisionMaking.txt

Documentation: fix typos

2024-09-23 12:47:36 -07:00

diff-format.txt

doc: git-diff: apply format changes to diff-format

2024-11-19 12:31:04 +09:00

diff-generate-patch.txt

doc: git-diff: apply format changes to diff-generate-patch

2024-11-19 12:31:05 +09:00

diff-options.txt

doc: git-diff: apply format changes to diff-options

2024-11-19 12:31:04 +09:00

doc-diff

…

docbook-xsl.css

…

docbook.xsl

…

docinfo-html.in

Doc: fix Asciidoctor css workaround

2024-07-23 11:02:52 -07:00

everyday.txto

…

fetch-options.txt

doc: correct misleading descriptions for --shallow-exclude

2024-11-04 22:53:23 -08:00

fix-texi.perl

…

fsck-msgids.txt

ref: add symlink ref content check for files backend

2024-11-21 08:21:34 +09:00

generate-mergetool-list.sh

Documentation: extract script to generate a list of mergetools

2024-12-07 07:52:13 +09:00

git-add.txt

doc: git-add.txt: convert to new style convention

2024-11-12 09:32:18 +09:00

git-am.txt

Merge branch 'jk/am-retry'

2024-06-17 15:55:56 -07:00

git-annotate.txt

…

git-apply.txt

apply: support --ours, --theirs, and --union for three-way merges

2024-09-09 10:07:24 -07:00

git-archimport.txt

…

git-archive.txt

archive: document that --add-virtual-file takes full path

2024-06-26 12:56:45 -07:00

git-bisect-lk2009.txt

…

git-bisect.txt

Merge branch 'jc/bisect-doc' into maint-2.43

2024-02-13 14:44:51 -08:00

git-blame.txt

…

git-branch.txt

…

git-bugreport.txt

bugreport.c: fix a crash in git bugreport with --no-suffix option

2024-03-16 09:31:42 -07:00

git-bundle.txt

Merge branch 'kh/doc-bundle-typofix'

2024-12-13 07:33:38 -08:00

git-cat-file.txt

docs: explain the order of output in the batched mode of git-cat-file(1)

2024-08-22 14:59:22 -07:00

git-check-attr.txt

…

git-check-ignore.txt

…

git-check-mailmap.txt

check-mailmap: add options for additional mailmap sources

2024-08-27 14:51:29 -07:00

git-check-ref-format.txt

…

git-checkout-index.txt

…

git-checkout.txt

checkout: refer to other-worktree branch, not ref

2024-10-10 13:09:13 -07:00

git-cherry-pick.txt

cherry-pick: add --empty for more robust redundant commit handling

2024-03-25 16:45:41 -07:00

git-cherry.txt

…

git-citool.txt

…

git-clean.txt

clean: further clean-up of implementation around "--force"

2024-03-04 14:05:13 -08:00

git-clone.txt

Merge branch 'bc/allow-upload-pack-from-other-people'

2024-12-10 10:04:55 +09:00

git-column.txt

…

git-commit-graph.txt

…

git-commit-tree.txt

…

git-commit.txt

doc: remove dangling closing parenthesis

2024-07-22 17:32:36 -07:00

git-config.txt

git-config.1: remove value from positional args in unset usage

2024-10-08 23:35:45 -07:00

git-count-objects.txt

…

git-credential-cache--daemon.txt

…

git-credential-cache.txt

…

git-credential-store.txt

…

git-credential.txt

credential: add method for querying capabilities

2024-04-16 22:39:08 -07:00

git-cvsexportcommit.txt

…

git-cvsimport.txt

…

git-cvsserver.txt

…

git-daemon.txt

…

git-describe.txt

…

git-diagnose.txt

…

git-diff-files.txt

…

git-diff-index.txt

…

git-diff-tree.txt

Merge branch 'jc/grammo-fixes' into maint-2.46

2024-09-12 11:02:19 -07:00

git-diff.txt

doc: git-diff: apply new documentation guidelines

2024-11-19 12:31:04 +09:00

git-difftool.txt

Merge branch 'ps/difftool-dir-diff-exit-code' into HEAD

2024-03-01 14:38:54 -08:00

git-fast-export.txt

doc: end sentences with full-stop

2024-02-20 15:03:13 -08:00

git-fast-import.txt

Merge branch 'xx/rfc2822-date-format-in-doc'

2024-04-23 11:52:40 -07:00

git-fetch-pack.txt

doc: correct misleading descriptions for --shallow-exclude

2024-11-04 22:53:23 -08:00

git-fetch.txt

…

git-filter-branch.txt

…

git-fmt-merge-msg.txt

…

git-for-each-ref.txt

for-each-ref: add 'is-base' token

2024-08-14 10:10:06 -07:00

git-for-each-repo.txt

for-each-repo: optionally keep going on an error

2024-04-24 10:46:03 -07:00

git-format-patch.txt

global: Fix duplicate word typos

2024-10-21 16:05:04 -04:00

git-fsck-objects.txt

…

git-fsck.txt

…

git-fsmonitor--daemon.txt

…

git-gc.txt

builtin/gc: add a --detach flag

2024-08-16 09:46:25 -07:00

git-get-tar-commit-id.txt

…

git-grep.txt

grep docs: describe --no-index further and improve formatting a bit

2024-03-25 14:00:03 -07:00

git-gui.txt

SubmittingPatches: welcome the new maintainer of git-gui part

2024-05-11 14:31:30 -07:00

git-hash-object.txt

…

git-help.txt

…

git-hook.txt

…

git-http-backend.txt

…

git-http-fetch.txt

…

git-http-push.txt

…

git-imap-send.txt

…

git-index-pack.txt

index-pack: teach --promisor to forbid pack name

2024-11-20 10:37:56 +09:00

git-init-db.txt

…

git-init.txt

doc: apply synopsis simplification on git-clone and git-init

2024-09-24 10:20:26 -07:00

git-instaweb.txt

…

git-interpret-trailers.txt

doc: fix some placeholders formating

2024-03-16 10:04:53 -07:00

git-log.txt

…

git-ls-files.txt

doc: fix hex code escapes in git-ls-files

2024-07-26 10:53:21 -07:00

git-ls-remote.txt

transport.c:🤝 make use of server options from remote

2024-10-08 10:22:08 -07:00

git-ls-tree.txt

…

git-mailinfo.txt

…

git-mailsplit.txt

…

git-maintenance.txt

doc: add a note about staggering of maintenance

2024-10-03 11:23:09 -07:00

git-merge-base.txt

…

git-merge-file.txt

…

git-merge-index.txt

…

git-merge-one-file.txt

…

git-merge-tree.txt

doc: merge-tree: improve example script

2024-10-09 10:40:42 -07:00

git-merge.txt

Merge branch 'ml/doc-merge-updates' into maint-2.43

2024-02-08 16:22:10 -08:00

git-mergetool--lib.txt

…

git-mergetool.txt

…

git-mktag.txt

…

git-mktree.txt

…

git-multi-pack-index.txt

midx: implement support for writing incremental MIDX chains

2024-08-06 12:01:39 -07:00

git-mv.txt

…

git-name-rev.txt

…

git-notes.txt

doc: convert git-notes to new documentation format

2025-01-10 15:19:52 -08:00

git-p4.txt

…

git-pack-objects.txt

…

git-pack-redundant.txt

…

git-pack-refs.txt

builtin/pack-refs: introduce new "--auto" flag

2024-03-25 09:54:07 -07:00

git-patch-id.txt

…

git-prune-packed.txt

…

git-prune.txt

…

git-pull.txt

doc: format alternatives in synopsis

2024-03-16 10:04:45 -07:00

git-push.txt

…

git-quiltimport.txt

…

git-range-diff.txt

range-diff: introduce the convenience option --remerge-diff

2024-12-16 08:45:48 -08:00

git-read-tree.txt

…

git-rebase.txt

Merge branch 'jc/doc-rebase-fuzz-vs-offset-fix' into maint-2.46

2024-08-16 12:50:55 -07:00

git-receive-pack.txt

…

git-reflog.txt

builtin/reflog: introduce subcommand to list reflogs

2024-02-21 09:58:07 -08:00

git-refs.txt

refs: add support for migrating reflogs

2024-12-16 09:45:34 -08:00

git-remote-ext.txt

…

git-remote-fd.txt

…

git-remote-helpers.txto

…

git-remote.txt

git-remote.txt: fix typo

2024-02-21 10:02:55 -08:00

git-repack.txt

…

git-replace.txt

…

git-replay.txt

Documentation: fix linkgit reference

2024-04-15 11:02:43 -07:00

git-request-pull.txt

…

git-rerere.txt

…

git-reset.txt

…

git-restore.txt

…

git-rev-list.txt

…

git-rev-parse.txt

Merge branch 'jc/rev-parse-fatal-doc' into maint-2.45

2024-06-28 15:53:14 -07:00

git-revert.txt

…

git-rm.txt

…

git-send-email.txt

send-email: document --mailmap and associated configuration

2024-09-25 08:58:38 -07:00

git-send-pack.txt

…

git-sh-i18n--envsubst.txt

…

git-sh-i18n.txt

…

git-sh-setup.txt

…

git-shell.txt

…

git-shortlog.txt

…

git-show-branch.txt

Merge branch 'ri/doc-show-branch-fix'

2024-07-15 10:11:43 -07:00

git-show-index.txt

…

git-show-ref.txt

show-ref: introduce --branches and deprecate --heads

2024-06-04 15:07:08 -07:00

git-show.txt

…

git-sparse-checkout.txt

…

git-stage.txt

…

git-stash.txt

…

git-status.txt

Merge branch 'jc/show-untracked-false'

2024-03-28 14:13:50 -07:00

git-stripspace.txt

…

git-submodule.txt

builtin/submodule: allow "add" to use different ref storage format

2024-08-08 09:22:21 -07:00

git-svn.txt

git-svn: mention svn:global-ignores in help+docs

2024-08-14 15:10:24 -07:00

git-switch.txt

…

git-symbolic-ref.txt

Documentation: mutually link update-ref and symbolic-ref

2024-10-21 16:49:31 -04:00

git-tag.txt

builtin/tag: add --trailer option

2024-05-07 10:06:03 -07:00

git-tools.txt

…

git-unpack-file.txt

…

git-unpack-objects.txt

…

git-update-index.txt

documentation: git-update-index: add --show-index-version to synopsis

2024-05-13 16:57:17 -07:00

git-update-ref.txt

Merge branch 'kh/doc-update-ref-grammofix'

2024-12-13 07:33:39 -08:00

git-update-server-info.txt

…

git-upload-archive.txt

…

git-upload-pack.txt

Sync with 2.42.2

2024-04-19 12:38:50 +02:00

git-var.txt

…

git-verify-commit.txt

…

git-verify-pack.txt

…

git-verify-tag.txt

…

git-version.txt

…

git-web--browse.txt

…

git-whatchanged.txt

…

git-worktree.txt

worktree: add relative cli/config options to repair command

2024-12-02 09:36:17 +09:00

git-write-tree.txt

…

git.txt

Merge branch 'mh/doc-windows-home-env'

2024-12-19 10:58:32 -08:00

gitattributes.txt

Merge branch 'ss/doc-eol-attr-fix'

2024-07-08 14:53:08 -07:00

gitcli.txt

doc: option value may be separate for valid reasons

2024-11-25 14:20:15 +09:00

gitcore-tutorial.txt

…

gitcredentials.txt

doc: option value may be separate for valid reasons

2024-11-25 14:20:15 +09:00

gitcvs-migration.txt

…

gitdiffcore.txt

…

giteveryday.txt

…

gitfaq.txt

gitfaq: add entry about syncing working trees

2024-07-09 21:24:42 -07:00

gitformat-bundle.txt

…

gitformat-chunk.txt

…

gitformat-commit-graph.txt

Documentation: fix typos

2024-09-23 12:47:36 -07:00

gitformat-index.txt

…

gitformat-pack.txt

…

gitformat-signature.txt

…

gitglossary.txt

…

githooks.txt

Merge branch 'jt/doc-post-receive-hook-update' into maint-2.46

2024-08-16 12:50:53 -07:00

gitignore.txt

…

gitk.txt

…

gitmailmap.txt

…

gitmodules.txt

…

gitnamespaces.txt

…

gitpacking.txt

Documentation/gitpacking: make sample configs listing blocks

2024-07-17 08:48:30 -07:00

gitprotocol-capabilities.txt

…

gitprotocol-common.txt

…

gitprotocol-http.txt

Merge branch 'js/update-urls-in-doc-and-comment' into maint-2.43

2024-02-08 16:22:01 -08:00

gitprotocol-pack.txt

…

gitprotocol-v2.txt

Merge branch 'xx/protocol-v2-doc-markup-fix' into maint-2.47

2024-11-25 12:29:47 +09:00

gitremote-helpers.txt

Merge branch 'jk/remote-helper-object-format-option-fix'

2024-04-03 10:56:18 -07:00

gitrepository-layout.txt

doc: consolidate extensions in git-config documentation

2024-10-22 12:49:32 -04:00

gitrevisions.txt

…

gitsubmodules.txt

…

gittutorial-2.txt

…

gittutorial.txt

Merge branch 'jc/grammo-fixes' into maint-2.46

2024-09-12 11:02:19 -07:00

gitweb.conf.txt

Merge branch 'js/update-urls-in-doc-and-comment' into maint-2.43

2024-02-08 16:22:01 -08:00

gitweb.txt

Documentation: fix typos

2024-09-23 12:47:36 -07:00

gitworkflows.txt

…

glossary-content.txt

Documentation/glossary: describe "trailer"

2024-11-18 09:41:24 +09:00

i18n.txt

…

install-doc-quick.sh

…

install-webdoc.sh

…

line-range-format.txt

…

line-range-options.txt

…

lint-fsck-msgids.perl

…

lint-gitlink.perl

…

lint-man-end-blurb.perl

…

lint-man-section-order.perl

…

lint-manpages.sh

Documentation/lint-manpages: bubble up errors

2024-06-06 08:20:51 -07:00

Makefile

Documentation: wire up sanity checks for Meson

2024-12-27 08:28:12 -08:00

manpage-bold-literal.xsl

…

manpage-normal.xsl

…

manpage.xsl

…

merge-options.txt

…

merge-strategies.txt

…

meson.build

Documentation: wire up sanity checks for Meson

2024-12-27 08:28:12 -08:00

MyFirstContribution.txt

MyFirstContribution: mention contrib/contacts/git-contacts

2024-04-18 14:55:09 -07:00

MyFirstObjectWalk.txt

MyFirstObjectWalk: add stderr to pipe processing

2024-03-27 09:24:35 -07:00

object-format-disclaimer.txt

…

pretty-formats.txt

Merge branch 'bl/doc-key-val-sep-fix'

2024-03-25 16:16:35 -07:00

pretty-options.txt

…

pull-fetch-param.txt

doc: clarify <src> in refspec syntax

2024-10-09 16:59:01 -07:00

ref-reachability-filters.txt

…

ref-storage-format.txt

refs: introduce reftable backend

2024-02-07 08:28:37 -08:00

rerere-options.txt

…

rev-list-description.txt

…

rev-list-options.txt

Merge branch 'kk/doc-ancestry-path'

2024-12-13 07:33:46 -08:00

ReviewingGuidelines.txt

ReviewingGuidelines: encourage positive reviews more

2024-07-25 08:50:09 -07:00

revisions.txt

…

scalar.txt

scalar: add --no-tags option to 'scalar clone'

2024-09-06 14:13:48 -07:00

sequencer.txt

…

signoff-option.txt

…

SubmittingPatches

Merge branch 'as/gitk-git-gui-repo-update'

2024-12-28 10:11:42 -08:00

texi.xsl

…

ToolsForGit.txt

…

trace2-target-values.txt

…

transfer-data-leaks.txt

…

urls-remotes.txt

…

urls.txt

doc: apply synopsis simplification on git-clone and git-init

2024-09-24 10:20:26 -07:00

user-manual.txt

Documentation/user-manual.txt: example for generating object hashes

2024-03-12 13:32:11 -07:00