Patchwork Directory gcc/common not documented

login
register
mail settings
Submitter Joseph S. Myers
Date July 30, 2012, 9:47 p.m.
Message ID <Pine.LNX.4.64.1207302145060.13404@digraph.polyomino.org.uk>
Download mbox | patch
Permalink /patch/174104/
State New
Headers show

Comments

Joseph S. 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 <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.

Patch

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  <joseph@codesourcery.com>
+
+	* doc/sourcebuild.texi (Subdirectories): Document common
+	subdirectory.
+
 2012-07-30  John David Anglin  <dave.anglin@nrc-cnrc.gc.ca>
 
 	PR middle-end/53823