
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>
31 lines
753 B
Plaintext
31 lines
753 B
Plaintext
git-get-tar-commit-id(1)
|
|
========================
|
|
|
|
NAME
|
|
----
|
|
git-get-tar-commit-id - Extract commit ID from an archive created using git-archive
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git get-tar-commit-id'
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
Read a tar archive created by 'git archive' from the standard input
|
|
and extract the commit ID stored in it. It reads only the first
|
|
1024 bytes of input, thus its runtime is not influenced by the size
|
|
of the tar archive very much.
|
|
|
|
If no commit ID is found, 'git get-tar-commit-id' quietly exits with a
|
|
return code of 1. This can happen if the archive had not been created
|
|
using 'git archive' or if the first parameter of 'git archive' had been
|
|
a tree ID instead of a commit ID or tag.
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|