1f010d6bdf
We presently use the ".txt" extension for our AsciiDoc files. While not wrong, most editors do not associate this extension with AsciiDoc, meaning that contributors don't get automatic editor functionality that could be useful, such as syntax highlighting and prose linting. It is much more common to use the ".adoc" extension for AsciiDoc files, since this helps editors automatically detect files and also allows various forges to provide rich (HTML-like) rendering. Let's do that here, renaming all of the files and updating the includes where relevant. Adjust the various build scripts and makefiles to use the new extension as well. Note that this should not result in any user-visible changes to the documentation. Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
65 lines
1.5 KiB
Plaintext
65 lines
1.5 KiB
Plaintext
git-check-mailmap(1)
|
|
====================
|
|
|
|
NAME
|
|
----
|
|
git-check-mailmap - Show canonical names and email addresses of contacts
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git check-mailmap' [<options>] <contact>...
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
For each ``Name $$<user@host>$$'', ``$$<user@host>$$'', or ``$$user@host$$''
|
|
from the command-line or standard input (when using `--stdin`), look up the
|
|
person's canonical name and email address (see "Mapping Authors" below). If
|
|
found, print them; otherwise print the input as-is.
|
|
|
|
|
|
OPTIONS
|
|
-------
|
|
--stdin::
|
|
Read contacts, one per line, from the standard input after exhausting
|
|
contacts provided on the command-line.
|
|
|
|
--mailmap-file=<file>::
|
|
In addition to any configured mailmap files, read the specified
|
|
mailmap file. Entries in this file take precedence over entries in
|
|
either the default mailmap file or any configured mailmap file.
|
|
|
|
--mailmap-blob=<blob>::
|
|
Like `--mailmap-file`, but consider the value as a reference to a
|
|
blob in the repository. If both `--mailmap-file` and
|
|
`--mailmap-blob` are specified, entries in `--mailmap-file` will
|
|
take precedence.
|
|
|
|
OUTPUT
|
|
------
|
|
|
|
For each contact, a single line is output, terminated by a newline. If the
|
|
name is provided or known to the 'mailmap', ``Name $$<user@host>$$'' is
|
|
printed; otherwise only ``$$<user@host>$$'' is printed.
|
|
|
|
|
|
CONFIGURATION
|
|
-------------
|
|
|
|
See `mailmap.file` and `mailmap.blob` in linkgit:git-config[1] for how
|
|
to specify a custom `.mailmap` target file or object.
|
|
|
|
|
|
MAPPING AUTHORS
|
|
---------------
|
|
|
|
See linkgit:gitmailmap[5].
|
|
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|