This is an automated email from Gerrit.

Tim Newsome ([email protected]) just uploaded a new patch set to Gerrit, which 
you can find at http://openocd.zylin.com/4250

-- gerrit

commit 5b9a2769b772a8b43be814959c48e3ee7477e8c7
Author: Tim Newsome <[email protected]>
Date:   Sun Oct 8 12:03:25 2017 -0700

    Document `struct reg` fields.
    
    Change-Id: I286316079e2e4d4f09427a4ffbecadb48c5dc9d9
    Signed-off-by: Tim Newsome <[email protected]>

diff --git a/src/target/register.h b/src/target/register.h
index d3b2c31..dc18e9a 100644
--- a/src/target/register.h
+++ b/src/target/register.h
@@ -114,17 +114,32 @@ struct reg_data_type {
 };
 
 struct reg {
+       /* Canonical name of the register. */
        const char *name;
+       /* Number that gdb uses to access this register. */
        uint32_t number;
+       /* TODO. This should probably be const. */
        struct reg_feature *feature;
+       /* TODO: When true, the caller will save this register before running 
any algorithm. */
        bool caller_save;
+       /* Pointer to place where the value is stored, in the format understood 
by
+        * the binarybuffer.h functions. */
        void *value;
+       /* The stored value needs to be written to the target. */
        bool dirty;
+       /* When true, value is valid. */
        bool valid;
+       /* When false, the register doesn't actually exist in the target. */
        bool exist;
+       /* Size of the register in bits. */
        uint32_t size;
+       /* Used for generating XML description of registers. Can be set to NULL 
for
+        * targets that don't use that. */
        struct reg_data_type *reg_data_type;
+       /* Used for generating XML description of registers. Can be set to NULL 
for
+        * targets that don't use that. */
        const char *group;
+       /* Pointer to architecture-specific info for this register. */
        void *arch_info;
        const struct reg_arch_type *type;
 };

-- 

------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
OpenOCD-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/openocd-devel

Reply via email to