[Bug other/110329] New: [14 regression] build fails building documentation after r14-1949-g957ae904065917

[Bug other/110329] New: [14 regression] build fails building documentation after r14-1949-g957ae904065917

[seurer at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110329

            Bug ID: 110329
           Summary: [14 regression] build fails building documentation
                    after r14-1949-g957ae904065917
           Product: gcc
           Version: 14.0
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: other
          Assignee: unassigned at gcc dot gnu.org
          Reporter: seurer at gcc dot gnu.org
  Target Milestone: ---

g:957ae90406591739b68e95ad49a0232faeb74217, r14-1949-g957ae904065917 

I am only seeing this failure on an older power 7 machine.  Is something out of
date on it or maybe the patch is using some "new" feature?

make[2]: Entering directory `/home/seurer/gcc/git/build/gcc-test/gcc'
if [ xinfo = xinfo ]; then \
                makeinfo --split-size=5000000 --split-size=5000000 --no-split
-I . -I /home/seurer/gcc/git/gcc-test/gcc/doc \
                        -I /home/seurer/gcc/git/gcc-test/gcc/doc/include -o
doc/gccint.info /home/seurer/gcc/git/gcc-test/gcc/doc/gccint.texi; \
        fi
/home/seurer/gcc/git/gcc-test/gcc/doc//md.texi:840: Unknown command
`backslashchar'.
/home/seurer/gcc/git/gcc-test/gcc/doc//md.texi:840: Misplaced {.
/home/seurer/gcc/git/gcc-test/gcc/doc//md.texi:840: Misplaced }.
/home/seurer/gcc/git/gcc-test/gcc/doc//tm.texi:6446: warning: unlikely
character [ in @var.
/home/seurer/gcc/git/gcc-test/gcc/doc//tm.texi:6446: warning: unlikely
character ] in @var.
/home/seurer/gcc/git/gcc-test/gcc/doc//tm.texi:6446: warning: unlikely
character [ in @var.
/home/seurer/gcc/git/gcc-test/gcc/doc//tm.texi:6446: warning: unlikely
character ] in @var.
/home/seurer/gcc/git/gcc-test/gcc/doc//tm.texi:6446: warning: unlikely
character [ in @var.
/home/seurer/gcc/git/gcc-test/gcc/doc//tm.texi:6446: warning: unlikely
character ] in @var.
makeinfo: Removing output file `doc/gccint.info' due to errors; use --force to
preserve.
make[2]: *** [doc/gccint.info] Error 1
make[2]: Leaving directory `/home/seurer/gcc/git/build/gcc-test/gcc'
make[1]: *** [all-gcc] Error 2
make[1]: Leaving directory `/home/seurer/gcc/git/build/gcc-test'
make: *** [all] Error 2


ESC[33mcommit 957ae90406591739b68e95ad49a0232faeb74217ESC[m
Author: Tamar Christina <tamar.christina@arm.com>
Date:   Mon Jun 19 15:47:46 2023 +0100

    New compact syntax for insn and insn_split in Machine Descriptions.

[Bug other/110329] [14 regression] build fails building documentation after r14-1949-g957ae904065917

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110329

Andrew Pinski <pinskia at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|UNCONFIRMED                 |NEW
   Last reconfirmed|                            |2023-06-20
     Ever confirmed|0                           |1
           Keywords|                            |build
   Target Milestone|---                         |14.0

--- Comment #1 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
From
https://www.gnu.org/software/texinfo/manual/texinfo-html/Inserting-a-Backslash.html

```
Although ‘@backslashchar{}’ can be used nearly anywhere, there is no need for
it except in these unusual cases.
```


So if I read this correctly, `\` could be used here without any worries as it
is not inside a macro. It is only inside a macro where `\` would be an issue.

I suspect @backslashchar was only added for texinfo 7.0.

[Bug other/110329] [14 regression] build fails building documentation after r14-1949-g957ae904065917

[cvs-commit at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110329

--- Comment #2 from CVS Commits <cvs-commit at gcc dot gnu.org> ---
The master branch has been updated by Tamar Christina <tnfchris@gcc.gnu.org>:

https://gcc.gnu.org/g:b8b19729e65c79d5b9399591d19e8724b52347f9

commit r14-2011-gb8b19729e65c79d5b9399591d19e8724b52347f9
Author: Tamar Christina <tamar.christina@arm.com>
Date:   Wed Jun 21 10:34:54 2023 +0100

    docs: replace backslashchar [PR 110329].

    It seems like @blackslashchar{} is a relatively new addition
    to texinfo.  Other parts of the docs use @samp{\} so use it
    here too so older distros work.

    gcc/ChangeLog:

            PR other/110329
            * doc/md.texi: Replace backslashchar.

[Bug other/110329] [14 regression] build fails building documentation after r14-1949-g957ae904065917

[tnfchris at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110329

Tamar Christina <tnfchris at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |FIXED

--- Comment #3 from Tamar Christina <tnfchris at gcc dot gnu.org> ---
Fixed, thanks for the report!