automake
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: minor docs alteration


From: Karl Berry
Subject: Re: minor docs alteration
Date: Sun, 26 Jan 2020 19:08:38 -0700

Hi Jefferson,

Thanks for this suggestion from May 2018 (oops).

    Date: Thu, 31 May 2018 22:44:45 +0000
    From: Jefferson Carpenter
    To: address@hidden
    Subject: minor docs alteration

    -The build tree is rooted in the directory in which @file{configure}
    +The build tree is rooted in the directory from which @file{configure}

I just pushed several wording changes along these lines, hoping to
clarify the build tree location even more ... --best, karl.

index 4b26677..9f4acf6 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -860,13 +860,14 @@ Manual}, for more information about this feature.
 @cindex trees, source vs.@: build
 
 The GNU Build System distinguishes two trees: the source tree, and
-the build tree.
+the build tree.  These are two directories that may be the same, or
+different.
 
-The source tree is rooted in the directory containing
-@file{configure}.  It contains all the sources files (those that are
+The source tree is rooted in the directory containing the
+@file{configure} script.  It contains all the source files (those that are
 distributed), and may be arranged using several subdirectories.
 
-The build tree is rooted in the directory in which @file{configure}
+The build tree is rooted in the current directory at the time @file{configure}
 was run, and is populated with all object files, programs, libraries,
 and other derived files built from the sources (and hence not
 distributed).  The build tree usually has the same subdirectory layout
@@ -880,8 +881,8 @@ installation example (@pxref{Basic Installation}).
 
 A common request from users is that they want to confine all derived
 files to a single directory, to keep their source directories
-uncluttered.  Here is how we could run @file{configure} to build
-everything in a subdirectory called @file{build/}.
+uncluttered.  Here is how we could run @file{configure} to create
+everything in a build tree (that is, subdirectory) called @file{build/}.
 
 @example
 ~ % @kbd{tar zxf ~/amhello-1.0.tar.gz}



reply via email to

[Prev in Thread] Current Thread [Next in Thread]