git-lfs/docs/man/git-lfs-dedup.adoc
brian m. carlson 5c2ca772fb
docs/man: fix titles of AsciiDoc man pages
When pandoc did our conversion to AsciiDoc, it was not aware that we
were working with manual pages.  Automatic handling of manual pages with
Asciidoctor requires that the title of the manual page be a top-level,
not a second-level, title, and that the name section be explicitly
specified.

Let's fix our manual pages to meet that standard automatically with the
following shell command.  This has the pleasant side effect of also
normalizing whether we use one or two dashes between the name and the
description to a single dash, which is what the Git manual pages use.

  ruby -pi -e '$_.gsub!(/^(=+)=( \S)/, "\\1\\2")' \
  -e '$_.gsub!(/^= (\S+)(\(\d\)) -+ (.*)$/, "= \\1\\2\n\n== NAME\n\n\\1 - \\3")' \
  *.adoc
2022-06-23 16:25:13 +00:00

29 lines
764 B
Plaintext

= git-lfs-dedup(1)
== NAME
git-lfs-dedup - Deduplicate Git LFS files
== SYNOPSIS
`git lfs dedup`
== DESCRIPTION
Deduplicates storage by re-creating working tree files as clones of the
files in the Git LFS storage directory using the operating system's
copy-on-write file creation functionality.
If the operating system or file system don't support copy-on-write file
creation, this command exits unsuccessfully.
This command will also exit without success if any Git LFS extensions
are configured, as these will typically be used to alter the file
contents before they are written to the Git LFS storage directory, and
therefore the working tree files should not be copy-on-write clones of
the LFS object files.
== SEE ALSO
Part of the git-lfs(1) suite.