git-lfs/docs/man/git-lfs-env.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

18 lines
203 B
Plaintext

= git-lfs-env(1)
== NAME
git-lfs-env - Display the Git LFS environment
== SYNOPSIS
`git lfs env`
== DESCRIPTION
Display the current Git LFS environment.
== SEE ALSO
Part of the git-lfs(1) suite.