On sab, nov 24, 2012 at 10:22:51 -0500, Samuel Bronson wrote: > I see some screwed up references in valgrind(1), in particular here: > > ,---- > | --vgdb=<no|yes|full> [default: yes] > | Valgrind will provide "gdbserver" functionality when --vgdb=yes > or > | --vgdb=full is specified. This allows an external GNU GDB > debugger > | to control and debug your program when it runs on Valgrind. See > | ??? for a detailed description. > | > | If the embedded gdbserver is enabled but no gdb is currently > being > | used, the ??? command line utility can send "monitor commands" > to > | Valgrind from a shell. The Valgrind core provides a set of ???. A > | tool can optionally provide tool specific monitor commands, which > | are documented in the tool specific chapter. > | > | --vgdb=full incurs significant performance overheads. > `---- > > ... and here: > > ,---- > | --cache-sim=<yes|no> [default: no] > | Specify if you want to do full cache simulation. By default, only > | instruction read accesses will be counted ("Ir"). With cache > | simulation, further event counters are enabled: Cache misses on > | instruction reads ("I1mr"/"ILmr"), data read accesses ("Dr") and > | related cache misses ("D1mr"/"DLmr"), data write accesses ("Dw") > | and related cache misses ("D1mw"/"DLmw"). For more information, > | see ???. > `---- > > Unfortunately, the error messages one gets from docbook-xsl aren't > terribly easy to follow, so I don't have a patch for it :-(.
I'm no docbook expert, but looking at the XML sources it seems that the '???' should have been replaced by some kind of links. Also, from the build log: > ERROR: xref linking to manual-core-adv.gdbserver has no generated link text. > Error: no ID for constraint linkend: manual-core-adv.gdbserver. > ERROR: xref linking to manual-core-adv.vgdb has no generated link text. > Error: no ID for constraint linkend: manual-core-adv.vgdb. > ERROR: xref linking to manual-core-adv.valgrind-monitor-commands has no > generated link text. > Error: no ID for constraint linkend: > manual-core-adv.valgrind-monitor-commands. > Error: no ID for constraint linkend: manual-core.comment. > ERROR: xref linking to manual-core.pthreads_perf_sched has no generated link > text. > Error: no ID for constraint linkend: manual-core.pthreads_perf_sched. > ERROR: xref linking to cg-manual has no generated link text. > Error: no ID for constraint linkend: cg-manual. According to [0] this is a known problem, and, unless these are different problems, to solve it one would need to do "two-pass processing". I'll have a look at the linked page to see if this actually solves the problem. Cheers [0] http://sourceware.org/ml/docbook-apps/2003-q4/msg00729.html -- perl -E '$_=q;$/= @{[@_]};and s;\S+;<inidehG ordnasselA>;eg;say~~reverse'
signature.asc
Description: Digital signature