* 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.
This commit is contained in:
Eli Zaretskii 2000-08-10 11:05:52 +00:00
parent 00fdaf47d5
commit 6f6ef15a3f
2 changed files with 16 additions and 2 deletions

View File

@ -1,3 +1,9 @@
2000-08-10 Eli Zaretskii <eliz@is.elta.co.il>
* 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 <cgf@cygnus.com> 2000-07-08 Christopher Faylor <cgf@cygnus.com>
* Makefile.in (install-info): Find files to install in either the * Makefile.in (install-info): Find files to install in either the

View File

@ -1368,6 +1368,9 @@ virtual conversions:
@deftypefn {Target Macro} int REGISTER_CONVERTIBLE (int @var{reg}) @deftypefn {Target Macro} int REGISTER_CONVERTIBLE (int @var{reg})
Return non-zero if register number @var{reg}'s value needs different raw Return non-zero if register number @var{reg}'s value needs different raw
and virtual formats. 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 @end deftypefn
@deftypefn {Target Macro} int REGISTER_RAW_SIZE (int @var{reg}) @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 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}. convert the value to virtual format, and place it at @var{to}.
Note that REGISTER_CONVERT_TO_VIRTUAL and REGISTER_CONVERT_TO_RAW take Note that @code{REGISTER_CONVERT_TO_VIRTUAL} and
their @var{reg} and @var{type} arguments in different orders. @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 @end deftypefn
@deftypefn {Target Macro} void REGISTER_CONVERT_TO_RAW (struct type *@var{type}, int @var{reg}, char *@var{from}, char *@var{to}) @deftypefn {Target Macro} void REGISTER_CONVERT_TO_RAW (struct type *@var{type}, int @var{reg}, char *@var{from}, char *@var{to})