* cli/cli-cmds.c (_initialize_cli_cmds): Clarify argument to

	disassemble command.

	doc/
	* gdb.texinfo (Machine Code): Clarify argument to disassemble
	command.

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 50e54453ae23c8bb47fb90e80d51dacbee56dae0..25b0c27c9dcb818ab33337cc38d9fb3090fbee2a 100644 (file)
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,8 @@
+2013-02-07  Doug Evans  <dje@google.com>
+
+       * cli/cli-cmds.c (_initialize_cli_cmds): Clarify argument to
+       disassemble command.
+
 2013-02-07  Marcus Shawcroft  <marcus.shawcroft@arm.com>
 
        * aarch64-linux-tdep.c (aarch64_linux_init_abi): Call

diff --git a/gdb/cli/cli-cmds.c b/gdb/cli/cli-cmds.c
index d9bf80f97aa9767fc69f35f5f413f73f1526f817..680cf992de9887e0609c638374c3da39e9f0ec5f 100644 (file)
--- a/gdb/cli/cli-cmds.c
+++ b/gdb/cli/cli-cmds.c
@@ -1843,7 +1843,12 @@ With a /m modifier, source lines are included (if available).\n\
 With a /r modifier, raw instructions in hex are included.\n\
 With a single argument, the function surrounding that address is dumped.\n\
 Two arguments (separated by a comma) are taken as a range of memory to dump,\n\
-  in the form of \"start,end\", or \"start,+length\"."));
+  in the form of \"start,end\", or \"start,+length\".\n\
+\n\
+Note that the address is interpreted as an expression, not as a location\n\
+like in the \"break\" command.\n\
+So, for example, if you want to disassemble function bar in file foo.c\n\
+you must type \"disassemble 'foo.c'::bar\" and not \"disassemble foo.c:bar\"."));
   set_cmd_completer (c, location_completer);
   if (xdb_commands)
     add_com_alias ("va", "disassemble", class_xdb, 0);

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 7f5665a5634777c5b4bf0b28c03ea837b5d9c809..7c163116e5845778fffe241c4152c38125e099c7 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2013-02-07  Doug Evans  <dje@google.com>
+
+       * gdb.texinfo (Machine Code): Clarify argument to disassemble
+       command.
+
 2013-02-06  Yao Qi  <yao@codesourcery.com>
 
        * gdb.texinfo (GDB/MI Async Records): Document new MI

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 2b954156642f5938f695fc43b7bbf8bc5e419b56..e3f336ea7e1f5aa7f7db23a47bb57a2eb6091657 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -7373,6 +7373,11 @@ Dump of assembler code from 0x400281 to 0x40028b:
 End of assembler dump.
 @end smallexample
 
+Addresses cannot be specified as a linespec (@pxref{Specify Location}).
+So, for example, if you want to disassemble function @code{bar}
+in file @file{foo.c}, you must type @samp{disassemble 'foo.c'::bar}
+and not @samp{disassemble foo.c:bar}.
+
 Some architectures have more than one commonly-used set of instruction
 mnemonics or other syntax.