git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Documentation doesn't build anymore on old asciidoc due to i18n series

From
Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date
May 28, 2011, 11:40 UTC
Message-ID
<BANLkTikjfyxAzLu2e5aJFVhgKq8UBiJAQw@mail.gmail.com>

I can submit a patch for this later, just thought I'd note it and solicit feedback on the best solution to this.

On my Debian box with asciidoc 8.6.4 Git builds just fine from master.
But on a Centos 5.5 box with asciidoc 8.2.5 I get:
    rm -f git-sh-i18n--envsubst.html+ git-sh-i18n--envsubst.html && \
            asciidoc -b xhtml11 -d manpage -f asciidoc.conf \
                     -a asciidoc7compatible -a no-inline-literal -a
git-asciidoc-no-roff -agit_version=1.7.5.3.367.ga9930 -o
git-sh-i18n--envsubst.html+ git-sh-i18n--envsubst.txt && \
            mv git-sh-i18n--envsubst.html+ git-sh-i18n--envsubst.html
    ERROR: git-sh-i18n--envsubst.txt: line 9: second section must be
named SYNOPSIS
    make[1]: *** [git-sh-i18n--envsubst.html] Error 1

The solution is obvious: just add a SYNOPSIS section for consistency. I'll do that later, unless we want to provide some option (which old asciidoc may or may not support) to not have a SYNOPSIS there, which we arguably can just omit for purely internal tooling like this.

I'll submit patches soon for adding a SYNOPSIS unless we want to go that route.

Next: Ævar Arnfjörð Bjarmason
Message 1 of 3 in “Documentation doesn't build anymore on old asciidoc due to i18n series”
  1. Ævar Arnfjörð BjarmasonMay 28, 2011
  2. git-sh-i18n--envsubst: add SYNOPSIS section to the documentationÆvar Arnfjörð Bjarmason, May 29, 2011
  3. Junio C HamanoMay 30, 2011

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.