Re: [PATCH][wwwdocs] Improve arm and aarch64-related info in readings.html

2016-06-02 Thread Kyrill Tkachov


On 28/05/16 21:04, Gerald Pfeifer wrote:

Hi Kyrill,

On Thu, 19 May 2016, Kyrill Tkachov wrote:

I noticed that we have a readings.html page that has pointers to
documentation of various backends that GCC supports. The info on arm
seems a bit out of date and somewhat confusing, and there is no entry
for aarch64. This patch tries to address that.

I see you have not applied this yet.  In case you were waiting
for any further approvals beyond James': (a) His is sufficient
for doc and web pages around AArch64, and (b) I agree, too. :-)


I have committed the attached patch.

Thanks for the feedback.
Kyrill


Gerald


Index: htdocs/readings.html
===
RCS file: /cvs/gcc/wwwdocs/htdocs/readings.html,v
retrieving revision 1.251
diff -U 3 -r1.251 readings.html
--- htdocs/readings.html	29 May 2016 10:16:01 -	1.251
+++ htdocs/readings.html	2 Jun 2016 09:28:32 -
@@ -59,6 +59,12 @@
 
 
 
+ AArch64
+  The 64-bit execution state introduced in the ARMv8-A architecture profile.
+  http://infocenter.arm.com/help/index.jsp;>
+	ARM Documentation
+ 
+
  alpha
Manufacturer: Compaq (DEC)
http://www.tru64unix.compaq.com/docs/base_doc/DOCUMENTATION/V51A_HTML/ARH9MBTE/TITLE.HTM;>Calling
@@ -81,12 +87,12 @@
   http://www.synopsys.com/IP/PROCESSORIP/ARCPROCESSORS/Pages/default.aspx;>ARC Documentation
  
 
- arm (armv2, thumb)
-  Manufacturer: Various, by license from ARM
+ ARM
+  Manufacturer: Various, by license from ARM.
   CPUs include: ARM7 and ARM7T series (eg. ARM7TDMI), ARM9 and StrongARM
   http://infocenter.arm.com/help/index.jsp;>ARM Documentation
  
- 
+
  AVR
   Manufacturer: Atmel
   http://www.atmel.com/products/microcontrollers/avr/;>AVR Documentation


Re: [PATCH][wwwdocs] Improve arm and aarch64-related info in readings.html

2016-05-31 Thread Kyrill Tkachov

Hi Gerald,

On 28/05/16 21:04, Gerald Pfeifer wrote:

Hi Kyrill,

On Thu, 19 May 2016, Kyrill Tkachov wrote:

I noticed that we have a readings.html page that has pointers to
documentation of various backends that GCC supports. The info on arm
seems a bit out of date and somewhat confusing, and there is no entry
for aarch64. This patch tries to address that.

I see you have not applied this yet.  In case you were waiting
for any further approvals beyond James': (a) His is sufficient
for doc and web pages around AArch64, and (b) I agree, too. :-)


I was going to apply it (with James's suggestions) but I got
sidetracked by other things. I'll do it today.

Thanks,
Kyrill


Gerald




Re: [PATCH][wwwdocs] Improve arm and aarch64-related info in readings.html

2016-05-28 Thread Gerald Pfeifer
Hi Kyrill,

On Thu, 19 May 2016, Kyrill Tkachov wrote:
> I noticed that we have a readings.html page that has pointers to 
> documentation of various backends that GCC supports. The info on arm 
> seems a bit out of date and somewhat confusing, and there is no entry 
> for aarch64. This patch tries to address that.

I see you have not applied this yet.  In case you were waiting
for any further approvals beyond James': (a) His is sufficient
for doc and web pages around AArch64, and (b) I agree, too. :-)

Gerald


Re: [PATCH][wwwdocs] Improve arm and aarch64-related info in readings.html

2016-05-23 Thread James Greenhalgh
On Thu, May 19, 2016 at 04:27:31PM +0100, Kyrill Tkachov wrote:
> Hi all,
> 
> I noticed that we have a readings.html page that has pointers to
> documentation of various backends that GCC supports.  The info on arm seems a
> bit out of date and somewhat confusing, and there is no entry for aarch64.
> This patch tries to address that.
> 
> The arm entry is updated to not mention armv2(?) and thumb and an aarch64
> entry is added with a link to the ARM documentation.
> 
> Ok to commit?

The AArch64 part looks fine to me, but a paragraph introducing what is
meant by AArch64 ("the 64-bit execution state introduced in the ARMv8-A
architecture profile" - or similar) would be a useful addition. Just
sending our users straight to the full repository of information provided
by ARM may give them too wide a set of readings :).

Thanks,
James

> ? readings.html~
> Index: readings.html
> ===
> RCS file: /cvs/gcc/wwwdocs/htdocs/readings.html,v
> retrieving revision 1.242
> diff -U 3 -r1.242 readings.html
> --- readings.html 14 Nov 2015 23:40:21 -  1.242
> +++ readings.html 15 Feb 2016 13:29:03 -
> @@ -59,6 +59,11 @@
>  
>  
>  
> + AArch64
> +  http://infocenter.arm.com/help/index.jsp;>
> + ARM Documentation
> + 
> +
>   alpha
> Manufacturer: Compaq (DEC)
>  href="http://www.tru64unix.compaq.com/docs/base_doc/DOCUMENTATION/V51A_HTML/ARH9MBTE/TITLE.HTM;>Calling
> @@ -81,12 +86,12 @@
> href="http://www.synopsys.com/IP/PROCESSORIP/ARCPROCESSORS/Pages/default.aspx;>ARC
>  Documentation
>   
>  
> - arm (armv2, thumb)
> -  Manufacturer: Various, by license from ARM
> + ARM
> +  Manufacturer: Various, by license from ARM.
>CPUs include: ARM7 and ARM7T series (eg. ARM7TDMI), ARM9 and 
> StrongARM
>http://infocenter.arm.com/help/index.jsp;>ARM 
> Documentation
>   
> - 
> +
>   AVR
>Manufacturer: Atmel
>http://www.atmel.com/products/microcontrollers/avr/;>AVR 
> Documentation



[PATCH][wwwdocs] Improve arm and aarch64-related info in readings.html

2016-05-19 Thread Kyrill Tkachov

Hi all,

I noticed that we have a readings.html page that has pointers to documentation 
of various backends that GCC supports.
The info on arm seems a bit out of date and somewhat confusing, and there is no 
entry for aarch64.
This patch tries to address that.

The arm entry is updated to not mention armv2(?) and thumb and an aarch64 entry 
is added with
a link to the ARM documentation.

Ok to commit?

Thanks,
Kyrill
? readings.html~
Index: readings.html
===
RCS file: /cvs/gcc/wwwdocs/htdocs/readings.html,v
retrieving revision 1.242
diff -U 3 -r1.242 readings.html
--- readings.html	14 Nov 2015 23:40:21 -	1.242
+++ readings.html	15 Feb 2016 13:29:03 -
@@ -59,6 +59,11 @@
 
 
 
+ AArch64
+  http://infocenter.arm.com/help/index.jsp;>
+	ARM Documentation
+ 
+
  alpha
Manufacturer: Compaq (DEC)
http://www.tru64unix.compaq.com/docs/base_doc/DOCUMENTATION/V51A_HTML/ARH9MBTE/TITLE.HTM;>Calling
@@ -81,12 +86,12 @@
   http://www.synopsys.com/IP/PROCESSORIP/ARCPROCESSORS/Pages/default.aspx;>ARC Documentation
  
 
- arm (armv2, thumb)
-  Manufacturer: Various, by license from ARM
+ ARM
+  Manufacturer: Various, by license from ARM.
   CPUs include: ARM7 and ARM7T series (eg. ARM7TDMI), ARM9 and StrongARM
   http://infocenter.arm.com/help/index.jsp;>ARM Documentation
  
- 
+
  AVR
   Manufacturer: Atmel
   http://www.atmel.com/products/microcontrollers/avr/;>AVR Documentation