[gdb] Add 'Concept Index' entry '&' for background execution

[gdb] Add 'Concept Index' entry '&' for background execution

[Tom de Vries]

Hi,

GDB's execution commands have a foreground and background variant: f.i.,
there's 'continue' and 'continue&', and both are listed individually in the
'Command, Variable, and Function Index'.  But the '&' is not listed in the
'Concept Index' as being connected with the concept background execution.

This patch adds an '&' in the 'Concept Index':
...
 * $_, $__, and value history:            Memory.             (line  119)
+* &:                                     Background Execution.
+                                                             (line   16)
 * --annotate:                            Mode Options.       (line  121)
...
pointing to this line in 'Background Execution':
...
   To specify background execution, add a '&' to the command.
...

Build on x86_64.

OK for trunk?

Thanks,
- Tom

[gdb] Add 'Concept Index' entry '&' for background execution

2018-06-11  Tom de Vries  <tdevries@suse.de>

	* gdb.texinfo (Background Execution): Add @cindex for '&'.

---
 gdb/doc/gdb.texinfo | 1 +
 1 file changed, 1 insertion(+)

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 2b56b5ab21..d5d5fce46c 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -6319,6 +6319,7 @@ a command prompt so that you can issue other commands while your program runs.
 If the target doesn't support async mode, @value{GDBN} issues an error
 message if you attempt to use the background execution commands.
 
+@cindex @code{&}
 To specify background execution, add a @code{&} to the command.  For example,
 the background form of the @code{continue} command is @code{continue&}, or
 just @code{c&}.  The execution commands that accept background execution

Re: [gdb] Add 'Concept Index' entry '&' for background execution

[Eli Zaretskii]

> Date: Thu, 14 Jun 2018 20:53:32 +0200
> From: Tom de Vries <tdevries@suse.de>
> 
> +@cindex @code{&}

Please use this instead:

  @cindex @code{&}, background execution of commands

This will allow users to understand more quickly what this entry is
about.

Thanks.