From 6f6ef15a3f7b925a64e60e25862645b2a03bc63d Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Thu, 10 Aug 2000 11:05:52 +0000 Subject: [PATCH] * gdbint.texinfo (Target Architecture Definition): Document that REGISTER_CONVERT_TO_VIRTUAL should only be called on a register for which REGISTER_CONVERTIBLE returns a zero value. --- gdb/doc/ChangeLog | 6 ++++++ gdb/doc/gdbint.texinfo | 12 ++++++++++-- 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index edf92b7439a..c718f1b4dd1 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,9 @@ +2000-08-10 Eli Zaretskii + + * gdbint.texinfo (Target Architecture Definition): Document that + REGISTER_CONVERT_TO_VIRTUAL should only be called on a register + for which REGISTER_CONVERTIBLE returns a zero value. + 2000-07-08 Christopher Faylor * Makefile.in (install-info): Find files to install in either the diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index 532d22351b8..3e1251dc924 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -1368,6 +1368,9 @@ virtual conversions: @deftypefn {Target Macro} int REGISTER_CONVERTIBLE (int @var{reg}) Return non-zero if register number @var{reg}'s value needs different raw and virtual formats. + +You should not use @code{REGISTER_CONVERT_TO_VIRTUAL} for a register +unless this macro returns a non-zero value for that register. @end deftypefn @deftypefn {Target Macro} int REGISTER_RAW_SIZE (int @var{reg}) @@ -1395,8 +1398,13 @@ should always be @code{REGISTER_VIRTUAL_TYPE (@var{reg})}. The buffer at @var{from} holds the register's value in raw format; the macro should convert the value to virtual format, and place it at @var{to}. -Note that REGISTER_CONVERT_TO_VIRTUAL and REGISTER_CONVERT_TO_RAW take -their @var{reg} and @var{type} arguments in different orders. +Note that @code{REGISTER_CONVERT_TO_VIRTUAL} and +@code{REGISTER_CONVERT_TO_RAW} take their @var{reg} and @var{type} +arguments in different orders. + +You should only use @code{REGISTER_CONVERT_TO_VIRTUAL} with registers +for which the @code{REGISTER_CONVERTIBLE} macro returns a non-zero +value. @end deftypefn @deftypefn {Target Macro} void REGISTER_CONVERT_TO_RAW (struct type *@var{type}, int @var{reg}, char *@var{from}, char *@var{to}) -- 2.30.2