Proposed doc update for Explicit Reg Vars 2/3

[David Wohlferd]

Patch 2/3 is the update for the Global Register Variables page (attached).

Reviewing this patch is going to be difficult.

It's a lot easier to review a patch that just has a few lines of text 
being added.  However, this leads to 'chunky' docs with a bunch of 
disjointed paragraphs (which is what this page has now). Eventually, 
someone needs to take the whole thing, and rearrange, reformat and 
reorganize it.  Which is what this patch does.

So there isn't any new content (except the part recently removed from 
asm labels about statics), just the old content rephrased and 
reformatted.  There is, however, some decidedly unhelpful text that got 
removed (paraphrasing):

- There are unsourced, unsubstantiated reports that on some platforms, 
certain things might or might not work.
- Eventually the compiler may work differently than it does now.

Argh!  Who thinks this stuff is helpful?  And while it was painful, I 
kept in the part that says "when specifying register names, make sure 
they are really register names."

As for the review, perhaps reading the html is easier than reading the 
patch?

Here's the current text: 
https://gcc.gnu.org/onlinedocs/gcc/Global-Reg-Vars.html
And here's the new: 
http://limegreensocks.com/gcc/Global-Register-Variables.html

dw
-------------- next part --------------
A non-text attachment was scrubbed...
Name: exp2.patch
Type: text/x-patch
Size: 8365 bytes
Desc: not available
URL: <https://gcc.gnu.org/pipermail/gcc/attachments/20151012/3d858fea/attachment.bin>