Patchwork Update "Downloading the source" docs (Was: Components no longer exist)

login
register
mail settings
Submitter Jonathan Wakely
Date Jan. 17, 2013, 11:01 p.m.
Message ID <CAH6eHdS8N8_s=nGotCF8-6=ipsc_5snP_by1RNmd9Jk7Zqa=YA@mail.gmail.com>
Download mbox | patch
Permalink /patch/213405/
State New
Headers show

Comments

Jonathan Wakely - Jan. 17, 2013, 11:01 p.m.
On 17 January 2013 15:48, Michael Witten wrote:
> The documentation here:
>
>   http://gcc.gnu.org/install/download.html
>
> says:
>
>   It is possible to download a full distribution or
>   specific components... If you choose to download
>   specific components, you must download the core
>   GCC distribution plus any language specific
>   distributions you wish to use.
>
> However, from what I can tell, this hasn't been the
> case since the release of 4.7.0; there is only a
> monolithic distribution of source (no separate
> components).
>
> Either the components need to be added, or the
> documentation needs to be updated.

Fixed by this patch, OK for trunk and 4.7?

        * doc/install.texi (Downloading the Source): Update references to
        downloading separate components.
commit 257297257a1becce5ea11c2d3fd1c330d275cc05
Author: Jonathan Wakely <jwakely.gcc@gmail.com>
Date:   Thu Jan 17 22:13:46 2013 +0000

    	* doc/install.texi (Downloading the Source): Update references to
    	downloading separate components.
Richard Guenther - Jan. 18, 2013, 9:50 a.m.
On Fri, Jan 18, 2013 at 12:01 AM, Jonathan Wakely <jwakely.gcc@gmail.com> wrote:
> On 17 January 2013 15:48, Michael Witten wrote:
>> The documentation here:
>>
>>   http://gcc.gnu.org/install/download.html
>>
>> says:
>>
>>   It is possible to download a full distribution or
>>   specific components... If you choose to download
>>   specific components, you must download the core
>>   GCC distribution plus any language specific
>>   distributions you wish to use.
>>
>> However, from what I can tell, this hasn't been the
>> case since the release of 4.7.0; there is only a
>> monolithic distribution of source (no separate
>> components).
>>
>> Either the components need to be added, or the
>> documentation needs to be updated.
>
> Fixed by this patch, OK for trunk and 4.7?

I don't think mentioning what old GCC versions did is necessary, thus, ok
without

+Since GCC 4.7 it is only possible to download the full source distribution,
+not specific components.
+In GCC 3.0 and later versions, the GNU compiler
 testsuites are also included in the full distribution.

Thanks,
Richard.

>         * doc/install.texi (Downloading the Source): Update references to
>         downloading separate components.

Patch

diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index 35564ea..a5861c8 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -528,27 +528,23 @@  the executables named @command{cantlr}, @command{runantlr} or
 
 GCC is distributed via @uref{http://gcc.gnu.org/svn.html,,SVN} and FTP
 tarballs compressed with @command{gzip} or
-@command{bzip2}.  It is possible to download a full distribution or specific
-components.
+@command{bzip2}.
 
 Please refer to the @uref{http://gcc.gnu.org/releases.html,,releases web page}
 for information on how to obtain GCC@.
 
-The full distribution includes the C, C++, Objective-C, Fortran, Java,
-and Ada (in the case of GCC 3.1 and later) compilers.  The full
-distribution also includes runtime libraries for C++, Objective-C,
-Fortran, and Java.  In GCC 3.0 and later versions, the GNU compiler
+The source distribution includes the C, C++, Objective-C, Fortran, Java,
+and Ada (in the case of GCC 3.1 and later) compilers, as well as
+runtime libraries for C++, Objective-C, Fortran, and Java.
+For previous versions these were downloadable as separate components such
+as the core GCC distribution, which included the C language front end and
+shared components, and language-specific distributions including the
+language front end and the language runtime (where appropriate).
+Since GCC 4.7 it is only possible to download the full source distribution,
+not specific components.
+In GCC 3.0 and later versions, the GNU compiler
 testsuites are also included in the full distribution.
 
-If you choose to download specific components, you must download the core
-GCC distribution plus any language specific distributions you wish to
-use.  The core distribution includes the C language front end as well as the
-shared components.  Each language has a tarball which includes the language
-front end as well as the language runtime (when appropriate).
-
-Unpack the core distribution as well as any language specific
-distributions in the same directory.
-
 If you also intend to build binutils (either to upgrade an existing
 installation or for use in place of the corresponding tools of your
 OS), unpack the binutils distribution either in the same directory or