binutils-gdb/gdb/doc
Artur Shepilko 0ca4866abe Fix makeinfo warnings in gdb.texinfo and python.texi docs
Building gdb-9.1 on a system that has an older version of makeinfo
(4.8) shows the following warnings:

-----------------
make[4]: Entering directory '/home/tester/gdb-9.1/build/gdb/doc'
makeinfo --split-size=5000000 --split-size=5000000   -I
../../../gdb/doc/../../readline/readline/doc -I ../../../gdb/doc/../mi
-I ../../../gdb/doc \
    -o gdb.info ../../../gdb/doc/gdb.texinfo
../../../gdb/doc/gdb.texinfo:21867: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21867: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21868: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21868: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21869: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21869: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21872: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21872: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21874: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21874: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21876: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21876: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21879: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21879: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21931: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21931: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21933: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21933: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21936: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21936: warning: unlikely character ] in @var.
../../../gdb/doc/gdb.texinfo:21939: warning: unlikely character [ in @var.
../../../gdb/doc/gdb.texinfo:21939: warning: unlikely character ] in @var.
../../../gdb/doc//python.texi:3297: warning: `.' or `,' must follow
@xref, not `A'.
make[4]: Leaving directory '/home/tester/gdb-9.1/build/gdb/doc'
-----------------

These are thrown by expressions like `@var{[host]}`, intended to
produce `[HOST]`.

In that context this should instead be changed to `[@var{host}]`, which
has the same effect but without the warnings.

As for the warning in `python.texi`, there's period missing at the end
of one `@xref{}` clause.  Added.

gdb/doc/ChangeLog:

2020-04-15  Artur Shepilko  <nomadbyte@gmail.com>

	* gdb.texinfo: Transform @var{[host]} to [@var{host}]; this
	clears makeinfo warnings.
	* python.texi: Add a missing period trailing an @xref{} clause;
	this clears a makeinfo warning.
2020-04-15 09:44:12 +02:00
..
.gitignore
a4rc.sed
agentexpr.texi Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
all-cfg.texi Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
annotate.texinfo Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
ChangeLog Fix makeinfo warnings in gdb.texinfo and python.texi docs 2020-04-15 09:44:12 +02:00
doxy-index.in Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
Doxyfile-base.in Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
Doxyfile-gdb-api.in Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
Doxyfile-gdb-xref.in Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
Doxyfile-gdbserver.in Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
fdl.texi
filter-for-doxygen
filter-params.pl
gdb.texinfo Fix makeinfo warnings in gdb.texinfo and python.texi docs 2020-04-15 09:44:12 +02:00
gpl.texi
guile.texi Multi-target: NEWS and user manual 2020-01-10 20:06:15 +00:00
lpsrc.sed
Makefile.in Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
psrc.sed
python.texi Fix makeinfo warnings in gdb.texinfo and python.texi docs 2020-04-15 09:44:12 +02:00
refcard.tex Update copyright year in gdbarch.sh doc/gdb.texinfo and doc/refcard.tex 2020-01-01 10:37:10 +04:00
stabs.texinfo Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
stack_frame.eps
stack_frame.pdf
stack_frame.png
stack_frame.svg
stack_frame.txt