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.8 KiB
Plaintext
65 lines
1.8 KiB
Plaintext
git-pack-redundant(1)
|
|
=====================
|
|
|
|
NAME
|
|
----
|
|
git-pack-redundant - Find redundant pack files
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git pack-redundant' [--verbose] [--alt-odb] (--all | <pack-filename>...)
|
|
|
|
WARNING
|
|
-------
|
|
`git pack-redundant` has been deprecated and is scheduled for removal in
|
|
a future version of Git. Because it can only remove entire duplicate
|
|
packs and not individual duplicate objects, it is generally not a useful
|
|
tool for reducing repository size. You are better off using `git gc` to
|
|
do so, which will put objects into a new pack, removing duplicates.
|
|
|
|
Running `pack-redundant` without the `--i-still-use-this` flag will fail
|
|
in this release. If you believe you have a use case for which
|
|
`pack-redundant` is better suited and oppose this removal, please
|
|
contact the Git mailing list at git@vger.kernel.org. More information
|
|
about the list is available at https://git-scm.com/community.
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This program computes which packs in your repository
|
|
are redundant. The output is suitable for piping to
|
|
`xargs rm` if you are in the root of the repository.
|
|
|
|
'git pack-redundant' accepts a list of objects on standard input. Any objects
|
|
given will be ignored when checking which packs are required. This makes the
|
|
following command useful when wanting to remove packs which contain unreachable
|
|
objects.
|
|
|
|
git fsck --full --unreachable | cut -d ' ' -f3 | \
|
|
git pack-redundant --all | xargs rm
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
|
|
--all::
|
|
Processes all packs. Any filenames on the command line are ignored.
|
|
|
|
--alt-odb::
|
|
Don't require objects present in packs from alternate object
|
|
database (odb) directories to be present in local packs.
|
|
|
|
--verbose::
|
|
Outputs some statistics to stderr. Has a small performance penalty.
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkgit:git-pack-objects[1]
|
|
linkgit:git-repack[1]
|
|
linkgit:git-prune-packed[1]
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|