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 <http://gcc.gnu.org/ml/gcc-patches/2011-05/msg01779.html> (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
 directories.
 
+@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  <jos...@codesourcery.com>
+
+       * doc/sourcebuild.texi (Subdirectories): Document common
+       subdirectory.
+
 2012-07-30  John David Anglin  <dave.ang...@nrc-cnrc.gc.ca>
 
        PR middle-end/53823

-- 
Joseph S. Myers
jos...@codesourcery.com

Reply via email to