Re: [PATCH] MI Doco

[Nick Roberts <nickrob@snap.net.nz>]

 > > Clearly, some things don't work, but I don't know how to express
 > > exactly what they are.
 > 
 > How about showing examples of what doesn't work?

I'm not keen on giving examples which don't work in the manual but I can
expand it a bit (I've now used @anchor for -interpreter-exec):

  @cindex compatibility, @sc{gdb/mi} and CLI
  @cindex @sc{gdb/mi}, compatibility with CLI

  For the developers convenience CLI commands can be entered directly,
  but there may be some unexpected behaviour.  For example, commands
  that query the user will behave as if the user replied yes, breakpoint
  command lists are not executed and some CLI commands, such as @code{if},
  @code{when} and @code{define}, prompt for further input with @samp{>},
  which is not valid MI output.

  This feature may be removed at some stage in the future and it is
  recommended that front ends use the @code{-interpreter-exec} command
  (@pxref{-interpreter-exec}).


-- 
Nick                                           http://www.inet.net.nz/~nickrob