[Bug web/65699] New: online docs lacks version that it documents

[Bug web/65699] New: online docs lacks version that it documents

[goswin-v-b at web dot de]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65699

            Bug ID: 65699
           Summary: online docs lacks version that it documents
           Product: gcc
           Version: unknown
               URL: https://gcc.gnu.org/onlinedocs/gccint/
            Status: UNCONFIRMED
          Severity: enhancement
          Priority: P3
         Component: web
          Assignee: unassigned at gcc dot gnu.org
          Reporter: goswin-v-b at web dot de
                CC: goswin-v-b at web dot de

The online docs do not mention what version of the compiler they document. When
something doesn't work as documented this makes it hard to see if that
something is no longer valid in the local version or describes something not
yet present in the local version.

[Bug web/65699] online docs lacks version that it documents

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65699

--- Comment #1 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
That link is always the trunk.

[Bug web/65699] online docs lacks version that it documents

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65699

--- Comment #2 from Jonathan Wakely <redi at gcc dot gnu.org> ---
(In reply to Goswin von Brederlow from comment #0)
> The online docs do not mention what version of the compiler they document.

The latest one.

> When something doesn't work as documented this makes it hard to see if that
> something is no longer valid in the local version

Impossible, since the online ones are for the latest sources.

> or describes something not
> yet present in the local version.

Adding a version number to the onlinedocs/gccint pages won't change that.

The internals docs for the local version are in the local sources, so use them
not the online ones.

I don't see anything that can be usefully done here.

[Bug web/65699] online docs lacks version that it documents

[manu at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65699

Manuel López-Ibáñez <manu at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |manu at gcc dot gnu.org

--- Comment #3 from Manuel López-Ibáñez <manu at gcc dot gnu.org> ---
Note that we also store gccint for previous versions:

https://gcc.gnu.org/onlinedocs/gcc-4.9.2/gccint/

but we do not link to them from 

https://gcc.gnu.org/onlinedocs


In addition, perhaps we could simply add:

This file documents the internals of the GNU compilers (GCC version $VERSION).

at the top of the index.html file?
>From gcc-bugs-return-483034-listarch-gcc-bugs=gcc.gnu.org@gcc.gnu.org Wed Apr 08 17:34:40 2015
Return-Path: <gcc-bugs-return-483034-listarch-gcc-bugs=gcc.gnu.org@gcc.gnu.org>
Delivered-To: listarch-gcc-bugs@gcc.gnu.org
Received: (qmail 78777 invoked by alias); 8 Apr 2015 17:34:39 -0000
Mailing-List: contact gcc-bugs-help@gcc.gnu.org; run by ezmlm
Precedence: bulk
List-Id: <gcc-bugs.gcc.gnu.org>
List-Archive: <http://gcc.gnu.org/ml/gcc-bugs/>
List-Post: <mailto:gcc-bugs@gcc.gnu.org>
List-Help: <mailto:gcc-bugs-help@gcc.gnu.org>
Sender: gcc-bugs-owner@gcc.gnu.org
Delivered-To: mailing list gcc-bugs@gcc.gnu.org
Received: (qmail 78705 invoked by uid 48); 8 Apr 2015 17:34:36 -0000
From: "amacleod at redhat dot com" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug target/65697] __atomic memory barriers not strong enough for __sync builtins
Date: Wed, 08 Apr 2015 17:34:00 -0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: changed
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: gcc
X-Bugzilla-Component: target
X-Bugzilla-Version: 5.0
X-Bugzilla-Keywords: wrong-code
X-Bugzilla-Severity: normal
X-Bugzilla-Who: amacleod at redhat dot com
X-Bugzilla-Status: UNCONFIRMED
X-Bugzilla-Priority: P3
X-Bugzilla-Assigned-To: unassigned at gcc dot gnu.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags:
X-Bugzilla-Changed-Fields: cc
Message-ID: <bug-65697-4-jvAemWPETF@http.gcc.gnu.org/bugzilla/>
In-Reply-To: <bug-65697-4@http.gcc.gnu.org/bugzilla/>
References: <bug-65697-4@http.gcc.gnu.org/bugzilla/>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 7bit
X-Bugzilla-URL: http://gcc.gnu.org/bugzilla/
Auto-Submitted: auto-generated
MIME-Version: 1.0
X-SW-Source: 2015-04/txt/msg00586.txt.bz2
Content-length: 603

https://gcc.gnu.org/bugzilla/show_bug.cgi?ide697

Andrew Macleod <amacleod at redhat dot com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |amacleod at redhat dot com

--- Comment #3 from Andrew Macleod <amacleod at redhat dot com> ---
Note that atomic MEMMODEL_SEQ_CST is the original implementation of __sync.  It
was expanded to allow other memory models and the name was changed... but under
the covers it still implemented the same as it was before.

[Bug web/65699] online docs lacks version that it documents

[goswin-v-b at web dot de]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65699

--- Comment #4 from Goswin von Brederlow <goswin-v-b at web dot de> ---
Yes, a simple statement like that was exactly what I had in mind.

[Bug web/65699] online docs lacks version that it documents

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65699

Andrew Pinski <pinskia at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|UNCONFIRMED                 |RESOLVED
   Target Milestone|---                         |13.0
         Resolution|---                         |FIXED

--- Comment #5 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
This is fixed with the move over to spinx.

[Bug web/65699] online docs lacks version that it documents

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65699

Andrew Pinski <pinskia at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|RESOLVED                    |NEW
   Last reconfirmed|                            |2022-11-15
         Resolution|FIXED                       |---
     Ever confirmed|0                           |1

--- Comment #6 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
Sphinx generated manual was reverted for now so reopen this.

[Bug web/65699] online docs lacks version that it documents

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65699

Andrew Pinski <pinskia at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Target Milestone|13.0                        |---