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'

Attachment: signature.asc
Description: Digital signature

Reply via email to