consolidated register pages
authorfturovic <frank.turovich@nokia.com>
Thu, 12 Aug 2010 13:56:20 -0500
changeset 1817 4eae2726ff31
parent 1816 2a6a8cc0b9a1
child 1818 bb528d06abcd
consolidated register pages
core/com.nokia.carbide.cpp.doc.user/html/concepts/arm_registers.htm
core/com.nokia.carbide.cpp.doc.user/html/concepts/fpu_registers.htm
core/com.nokia.carbide.cpp.doc.user/html/concepts/general_registers.htm
core/com.nokia.carbide.cpp.doc.user/html/concepts/host_registers.htm
core/com.nokia.carbide.cpp.doc.user/html/concepts/registers.htm
core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/arm_registers.htm	Thu Aug 12 13:03:07 2010 -0500
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,39 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>ARM Registers</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body >
-<h2>ARM Registers</h2>
-<p>  Registers are the register contents of the central processing unit (CPU) of the targeted device. When debugging projects on a device, only the target device registers are visible, for example the ARM registers. The ARM microprocessor has 16 general-purpose registers. THUMB has eight general-purpose registers, R0-R7, and access to the high registers, R8-R15. Note that registers R0 through R3 hold the first four words of incoming arguments. The microprocessor constructs remaining arguments in the calling function's argument build area, which does not provide space into which R0 through R3 can be spilled.</p>
-<p>Three registers are best left for special uses. These are:</p>
-<ul>
-  <li>R13 for stack operations</li>
-  <li>R14 is the link register (it is used for storing return addresses in the construction of sub routines)</li>
-  <li>R15 is the program counter (PC)</li>
-</ul>
-<p>In most cases, the contents of all the registers can be modified. However,  when debugging applications on a target device with Application TRK, you cannot change the LR, SP, and CPSR registers.</p>
-<p class="note"><b>NOTE</b> When opening the Registers view, the list of available registers will vary depending upon the target devices being debugged. </p>
-<p align="center"><img src="images/ARM_registers.PNG" width="648" height="276" /></p>
-<p align="left" class="figure">Figure 1 - ARM Registers </p>
-<h5>Related concepts <b></b></h5>
-<ul>
-  <li><a href="registers.htm">Emulator  Registers </a></li>
-</ul>
-<h5>Related tasks</h5>
-<ul>
-      <li><a href="../tasks/registers/mem_reg_open_wnd.htm">Opening Register View</a></li>
-      <li><a href="../tasks/registers/mem_reg_changing.htm">Changing Register Values</a></li>
-</ul>
-    <h5>Related references <b></b></h5>
-<ul>
-  <li><a href="../reference/view_registers.htm">View  Registers</a></li>
-</ul>
-<div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/fpu_registers.htm	Thu Aug 12 13:03:07 2010 -0500
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,30 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>FPU Registers</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body >
-<h2>FPU Registers</h2>
-<p>The FPU Registers are the register contents of the floating-point unit (FPU) of the host computer. The exact listing of these registers depends on the host FPU and current build target.</p>
-<h5>Related concepts <b></b></h5>
-<ul>
-  <li><a href="general_registers.htm">General Registers</a></li>
-  <li><a href="host_registers.htm">Host-specific Registers</a> </li>
-</ul>
-    <h5>Related tasks <b></b></h5>
-    <ul>
-      <li><a href="../tasks/registers/mem_reg_open_wnd.htm">Opening Register View</a></li>
-      <li><a href="../tasks/registers/mem_reg_changing.htm">Changing Register Values</a></li>
-    </ul>
-    <h5>Related references <b></b></h5>
-<ul>
-  <li><a href="../reference/view_registers.htm">View  Registers</a></li>
-</ul>
-<div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/general_registers.htm	Thu Aug 12 13:03:07 2010 -0500
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,30 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>General Registers</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body >
-<h2>General Registers</h2>
-<p> The General Registers are the register contents of the central processing unit (CPU) of the host computer. The exact listing of these registers depends on the host CPU and current build target.</p>
-<h5>Related concepts <b></b></h5>
-<ul>
-  <li><a href="fpu_registers.htm">FPU Registers</a></li>
-  <li><a href="host_registers.htm">Host-specific Registers</a> </li>
-</ul>
-    <h5>Related tasks <b></b></h5>
-    <ul>
-      <li><a href="../tasks/registers/mem_reg_open_wnd.htm">Opening Register View</a></li>
-      <li><a href="../tasks/registers/mem_reg_changing.htm">Changing Register Values</a></li>
-    </ul>
-    <h5>Related references <b></b></h5>
-<ul>
-  <li><a href="../reference/view_registers.htm">View  Registers</a></li>
-</ul>
-<div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/host_registers.htm	Thu Aug 12 13:03:07 2010 -0500
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,30 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Host Registers</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body >
-<h2>Host-specific Registers</h2>
-<p>The Registers view also lists additional register contents for registers specific to the host. The exact listing of these registers depends on the host computer and current build target. </p>
-<h5>Related concepts <b></b></h5>
-<ul>
-  <li><a href="fpu_registers.htm">FPU Registers</a></li>
-  <li><a href="general_registers.htm">General Registers</a></li>
-</ul>
-    <h5>Related tasks <b></b></h5>
-    <ul>
-      <li><a href="../tasks/registers/mem_reg_open_wnd.htm">Opening Register View</a></li>
-      <li><a href="../tasks/registers/mem_reg_changing.htm">Changing Register Values</a></li>
-    </ul>
-    <h5>Related references <b></b></h5>
-<ul>
-  <li><a href="../reference/view_registers.htm">View  Registers</a></li>
-</ul>
-<div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/registers.htm	Thu Aug 12 13:03:07 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/registers.htm	Thu Aug 12 13:56:20 2010 -0500
@@ -9,7 +9,13 @@
 </head>
 <body >
 <h2>Registers</h2>
-<p>  Registers are the register contents of the central processing unit (CPU) of the host computer or the targeted device. When debugging projects using the emulator, only the host computer x86 registers are visible in the <a href="../reference/view_registers.htm">Registers</a> view. When debugging projects on a device, only the target device registers are visible. </p>
+<p>Use the <a href="../reference/view_registers.htm">Registers</a> view to view the general and specific registers  central processing unit (CPU) of the host computer. The exact listing of these registers depends on the host CPU and current build target. </p>
+<ul>
+    <li><a href="#general">General registers</a></li>
+    <li><a href="#arm">ARM registers</a></li>
+</ul>
+<h2><a name="general"></a>General registers</h2>
+<p>Registers are the register contents of the central processing unit (CPU) of the host computer or the targeted device. When debugging projects using the emulator, only the host computer x86 registers are visible in the <a href="../reference/view_registers.htm">Registers</a> view. When debugging projects on a device, only the target device registers are visible. </p>
 <p>In most cases, the contents of all the registers can be modified. However,  when debugging applications on a target device with Application TRK, you cannot change the LR and SP registers.</p>
 <p align="center"><img src="images/view_registers.png" width="463" height="260"></p>
 <p class="figure">Figure 1. Registers view with possible register types</p>
@@ -22,6 +28,17 @@
   <li><b>host-specific</b>&#8212;additional register contents for registers specific to the host (for example ARM registers)</li>
 </ul>
 <p class="note"><b>NOTE</b> When opening the Registers view, the list of available registers will vary depending upon the target devices being debugged. </p>
+<h2 class="note"><a name="arm"></a>ARM registers</h2>
+<p>The ARM microprocessor has 16 general-purpose registers. THUMB has eight general-purpose registers, R0-R7, and access to the high registers, R8-R15. Note that registers R0 through R3 hold the first four words of incoming arguments. The microprocessor constructs remaining arguments in the calling function's argument build area, which does not provide space into which R0 through R3 can be spilled.</p>
+<p>Three registers are best left for special uses. These are:</p>
+<ul>
+    <li>R13 for stack operations</li>
+    <li>R14 is the link register (it is used for storing return addresses in the construction of sub routines)</li>
+    <li>R15 is the program counter (PC)</li>
+</ul>
+<p>In most cases, the contents of all the registers can be modified. However,  when debugging applications on a target device with Application TRK, you cannot change the LR, SP, and CPSR registers.</p>
+<p align="center"><img src="images/ARM_registers.PNG" alt="" width="648" height="276" /></p>
+<p align="left" class="figure">Figure 2 - ARM Registers </p>
 <h5>Other  references <b></b></h5>
     <ul>
   <li><a href="../reference/view_registers.htm">Registers</a> view</li>
--- a/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml	Thu Aug 12 13:03:07 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml	Thu Aug 12 13:56:20 2010 -0500
@@ -83,7 +83,6 @@
         <topic href="html/tasks/registers/mem_reg_data_views.htm" label="Changing Register Data Views"></topic>
         <topic label="Expanding Register Groups"			href="html/tasks/registers/mem_reg_viewing.htm" />
         <topic label="Changing Register Values"				href="html/tasks/registers/mem_reg_changing.htm" />
-        <topic label="ARM Registers"						href="html/concepts/arm_registers.htm" />
       </topic>
       <topic label="Remote Connections view"		href="html/reference/trk/view_remote_connection.htm" />
       <topic href="html/reference/view_sym_os_data_overview.htm" label="Symbian OS Data view"></topic>
@@ -282,7 +281,6 @@
       <topic href="html/tasks/projects/prj_debug_dlls.htm" label="Debugging DLLs"></topic>
       <topic href="html/tasks/processes/attach_debugger_to_process.htm" label="Attaching to a Symbian OS Process"></topic>
       <topic href="html/tasks/start/carbide_debugging.htm" label="Debugging a Symbian OS Program"></topic>
-      <topic href="html/concepts/arm_registers.htm" label="Registers"></topic>
       <topic href="html/reference/view_sym_os_data_overview.htm" label="Symbian OS Data View"></topic>
         
     
@@ -294,7 +292,6 @@
         <topic label="Using Soft Attach"	 href="html/tasks/debugger/soft_attach_debug.htm" />
       </topic>
       <topic label="Building a ROM Image File"            href="html/reference/ROM_build_settings.html" />
-      <topic label="ARM Registers" 						href="html/concepts/arm_registers.htm" />
       <topic label="Toggle HW Breakpoint"           		href="html/reference/menus/hardware_breakpoints.htm" />
     </topic>
     <topic href="html/debugger/breakpoints/breakpoints.htm" label="Breakpoints">