[PATCH 4/4] Fix PR breakpoints/16494: add dprintf-style "agent-call"(doc)

[PATCH 4/4] Fix PR breakpoints/16494: add dprintf-style "agent-call"(doc)

[Hui Zhu]

This patch is for doc.

Thanks,
Hui

2014-03-04  Hui Zhu  <hui@codesourcery.com>

	PR breakpoint/16494
	* gdb.texinfo (Dynamic Printf): Add "agent-call".
	(qSupported): Add "DprintfAgentCall".

--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -4803,9 +4803,17 @@ Have the remote debugging agent (such as
  the output itself.  This style is only available for agents that
  support running commands on the target.
  
+@item agent-call
+@kindex dprintf-style agent-call
+Have the remote debugging agent (such as @code{gdbserver}) handle
+the output itself by calling a function in your program (normally
+@code{printf}).  This style is only available for agents that
+support running commands and dprintf agent call on the target.
+
  @item set dprintf-function @var{function}
-Set the function to call if the dprintf style is @code{call}.  By
-default its value is @code{printf}.  You may set it to any expression.
+Set the function to call if the dprintf style is @code{call} or
+@code{agent-call}.  By default its value is @code{printf}.  You may
+set it to any expression.
  that @value{GDBN} can evaluate to a function, as per the @code{call}
  command.
  
@@ -4842,7 +4850,7 @@ the variable settings.
  @kindex set disconnected-dprintf
  Choose whether @code{dprintf} commands should continue to run if
  @value{GDBN} has disconnected from the target.  This only applies
-if the @code{dprintf-style} is @code{agent}.
+if the @code{dprintf-style} is @code{agent} or @code{agent-call}.
  
  @item show disconnected-dprintf off
  @kindex show disconnected-dprintf
@@ -35344,6 +35352,11 @@ These are the currently defined stub fea
  @tab @samp{-}
  @tab No
  
+@item @samp{DprintfAgentCall}
+@tab No
+@tab @samp{-}
+@tab No
+
  @end multitable
  
  These are the currently defined stub features, in more detail:
@@ -35511,6 +35524,10 @@ See @ref{Bytecode Descriptions} for deta
  The remote stub supports running a breakpoint's command list itself,
  rather than reporting the hit to @value{GDBN}.
  
+@item DprintfAgentCall
+@cindex dprintf agent call, in remote protocol
+The remote stub supports dprintf agent call.
+
  @item Qbtrace:off
  The remote stub understands the @samp{Qbtrace:off} packet.
  

Re: [PATCH 4/4] Fix PR breakpoints/16494: add dprintf-style "agent-call"(doc)

[Eli Zaretskii]

> Date: Wed, 5 Mar 2014 00:30:18 +0800
> From: Hui Zhu <hui_zhu@mentor.com>
> 
> This patch is for doc.
> 
> Thanks,
> Hui
> 
> 2014-03-04  Hui Zhu  <hui@codesourcery.com>
> 
> 	PR breakpoint/16494
> 	* gdb.texinfo (Dynamic Printf): Add "agent-call".
> 	(qSupported): Add "DprintfAgentCall".

This is OK, thanks.