This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: Proposed doc update for Explicit Reg Vars 1/3
- From: Jeff Law <law at redhat dot com>
- To: David Wohlferd <dw at LimeGreenSocks dot com>, Segher Boessenkool <segher at kernel dot crashing dot org>
- Cc: "gcc at gcc dot gnu dot org" <gcc at gcc dot gnu dot org>, Sandra Loosemore <sandra at codesourcery dot com>
- Date: Wed, 21 Oct 2015 00:03:27 -0600
- Subject: Re: Proposed doc update for Explicit Reg Vars 1/3
- Authentication-results: sourceware.org; auth=none
- References: <561C2EDB dot 8020400 at LimeGreenSocks dot com> <20151019212428 dot GP17756 at gate dot crashing dot org> <5627113B dot 70908 at LimeGreenSocks dot com>
On 10/20/2015 10:14 PM, David Wohlferd wrote:
Abot the patches themselves... Hard to review again, sigh...
I know, and I'm sorry.
I just can't see any way to completely re-org the text without the patch
becoming a nightmare. I was hoping the html links would make that
easier, but I guess not. On the plus side, Explicit reg vars is the
last section I plan to do this to. I appreciate you taking the time.
I think the html links helped.
I did keep a small amount of intro on the the menu page. If you feel
there's more that we should keep, I'm certainly willing to re-visit
this. Perhaps after we resolve the local/global stuff so we know what
we really want to say.
Jeff has already checked in the patch for this menu page
I think what's left is fine. About all we really want to do is vector
folks to one of the two pages. One could argue that we should just drop
the intro page and pull up the local/global subpages a level. But if we
do that, then we're going to have a harder time vectoring the reader to
the right place.
(but not the
Local or Global subpages), so you can see what I've left here on the gcc
website
Right. I wanted to see final consensus, particularly on the Local page
and what we're ready to commit to there. I think the global page was
close, but may have needed one more minor iteration.
Lastly, if some external website is linking to "Explicit Reg Vars", what
do we want to have happen now that we have renamed that to "Explicit
Register Variables"? Should the link just fail? I've added the @anchor
so it doesn't, but I'm not sure that's the standard for gcc. Who should
I be asking?
Not sure if there's really a policy for external links into the
documentation. Leaving an @anchor seems like the nice/wise thing to do.
Jeff