From: Mark Wielaard Date: Wed, 13 May 2020 13:26:53 +0000 (+0200) Subject: hg-manual.xml: listitems contain paras, not CDATA. X-Git-Tag: VALGRIND_3_16_0~27 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=8e40553f72ca5a95e25d412eec08bdd63045aa3b;p=thirdparty%2Fvalgrind.git hg-manual.xml: listitems contain paras, not CDATA. --- diff --git a/helgrind/docs/hg-manual.xml b/helgrind/docs/hg-manual.xml index 8a1d9166aa..887a4be519 100644 --- a/helgrind/docs/hg-manual.xml +++ b/helgrind/docs/hg-manual.xml @@ -1178,25 +1178,29 @@ unlock(mx) unlock(mx) The following aspects have to be considered when using : - In some cases (for example in a function prologue), the - valgrind unwinder might not properly unwind the stack, due to some - limitations and/or due to wrong unwind info. When using - --delta-stacktrace=yes, the wrong stack trace captured in the - function prologue will be kept till the next call or return. - - On the other hand, --delta-stacktrace=yes sometimes helps to - obtain a correct stacktrace, for example when the unwind info allows - a correct stacktrace to be done in the beginning of the sequence, - but not later on in the instruction sequence. - Determining which instructions are changing the callstack is - partially based on platform dependent heuristics, which have to be - tuned/validated specifically for the platform. Also, unwinding in a - function prologue must be good enough to allow using - --delta-stacktrace=yes. Currently, the option --delta-stacktrace=yes - has been reasonably validated only on linux x86 32 bits and linux - amd64 64 bits. For more details about how to validate - --delta-stacktrace=yes, see debug option --hg-sanity-flags and the - function check_cached_rcec_ok in libhb_core.c. + In some cases (for example in a function + prologue), the valgrind unwinder might not properly unwind + the stack, due to some limitations and/or due to wrong + unwind info. When using --delta-stacktrace=yes, the wrong + stack trace captured in the function prologue will be kept + till the next call or return. + + On the other hand, --delta-stacktrace=yes + sometimes helps to obtain a correct stacktrace, for + example when the unwind info allows a correct stacktrace + to be done in the beginning of the sequence, but not later + on in the instruction sequence. + Determining which instructions are changing + the callstack is partially based on platform dependent + heuristics, which have to be tuned/validated specifically + for the platform. Also, unwinding in a function prologue + must be good enough to allow using + --delta-stacktrace=yes. Currently, the option + --delta-stacktrace=yes has been reasonably validated only + on linux x86 32 bits and linux amd64 64 bits. For more + details about how to validate --delta-stacktrace=yes, see + debug option --hg-sanity-flags and the function + check_cached_rcec_ok in libhb_core.c.