Directory gcc/common not documented

Message ID
State New
Headers show

Commit Message

Joseph Myers July 30, 2012, 9:47 p.m.
On Mon, 23 Jul 2012, Steven Bosscher wrote:

> In revision 175064 you introduced a new subdirectory: gcc/common.
> This directory is not documented in sourcebuild.texi. Can you please
> add documentation for it?

I've applied this patch to document this directory.  Tested with "make 
info" and "make pdf".  The longer version of what I think should go there 
is in <> (and 
messages linked from there), but the shorter version here seems more 
likely to stay accurate over time.


Index: doc/sourcebuild.texi
--- doc/sourcebuild.texi	(revision 189987)
+++ doc/sourcebuild.texi	(working copy)
@@ -176,6 +176,12 @@ 
 Anatomy of a Language Front End}, for details of the files in these
+@item common
+Source files shared between the compiler drivers (such as
+@command{gcc}) and the compilers proper (such as @file{cc1}).  If an
+architecture defines target hooks shared between those places, it also
+has a subdirectory in @file{common/config}.  @xref{Target Structure}.
 @item config
 Configuration files for supported architectures and operating
 systems.  @xref{Back End, , Anatomy of a Target Back End}, for
Index: ChangeLog
--- ChangeLog	(revision 189987)
+++ ChangeLog	(working copy)
@@ -1,3 +1,8 @@ 
+2012-07-30  Joseph Myers  <>
+	* doc/sourcebuild.texi (Subdirectories): Document common
+	subdirectory.
 2012-07-30  John David Anglin  <>
 	PR middle-end/53823