From: Phil Muldoon <pmuldoon@redhat.com>
Date: Tue, 21 Feb 2017 21:32:56 +0000 (-0800)
Subject: Add argument compilation documentation.
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=c726c528836913cd5c1b14d9a38d43e6bf283af5;p=thirdparty%2Fbinutils-gdb.git

Add argument compilation documentation.

This expands on the already existing comments and gives a more thorough explanation of the source of the arguments used in the final argument string.
---

diff --git a/gdb/compile/compile.c b/gdb/compile/compile.c
index fb4e6d9b42c..8d57cc98084 100644
--- a/gdb/compile/compile.c
+++ b/gdb/compile/compile.c
@@ -399,9 +399,25 @@ filter_args (int *argcp, char **argv)
   *destv = NULL;
 }
 
-/* Produce final vector of GCC compilation options.  First element is target
-   size ("-m64", "-m32" etc.), optionally followed by DW_AT_producer options
-   and then compile-args string GDB variable.  */
+/* Produce final vector of GCC compilation options.
+
+   The first element of the combined argument vector are arguments
+   relating to the target size ("-m64", "-m32" etc.). These are
+   sourced from the inferior's architecture.
+
+   The second element of the combined argument vector are arguments
+   stored in the inferior DW_AT_producer section.  If these are stored
+   in the inferior (there is no guarantee that they are), they are
+   added to the vector.
+
+   The third element of the combined argument vector are argument
+   supplied by the language implementation provided by
+   compile-{lang}-support. These contain language specific arguments.
+
+   The final element of the combined argument vector are arguments
+   supplied by the "set compiler-args" command. These are always
+   appended last so as to override any of the arguments automatically
+   generated above.  */
 
 static void
 get_args (const struct compile_instance *compiler, struct gdbarch *gdbarch,