[patch] Update "Downloading the source" docs (Was: Components no longer exist)

[patch] Update "Downloading the source" docs (Was: Components no longer exist)

[Jonathan Wakely]

[-- Attachment #1: Type: text/plain, Size: 794 bytes --]

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.

[-- Attachment #2: patch.txt --]
[-- Type: text/plain, Size: 2470 bytes --]

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.

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

Re: [patch] Update "Downloading the source" docs (Was: Components no longer exist)

[Richard Biener]

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.

Re: [patch] Update "Downloading the source" docs (Was: Components no longer exist)

[Jonathan Wakely]

[-- Attachment #1: Type: text/plain, Size: 592 bytes --]

On 18 January 2013 09:50, Richard Biener wrote:
>> 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, I've committed the attached version.

I also fixed all Uros's changelogs for 2013 which all say 2012 :-)
Uros, I only fixed gcc/ChangeLog so you might want to check other changelogs.

[-- Attachment #2: patch.txt --]
[-- Type: text/plain, Size: 2247 bytes --]

commit 6fe4893a2c8b4ebb1fbf84f0afc145412c5167b6
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.

diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index 35564ea..8419ca2 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -528,26 +528,18 @@ 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
-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.
+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).
 
 If you also intend to build binutils (either to upgrade an existing
 installation or for use in place of the corresponding tools of your