Re: [boost] [quickbook] error with links when building documentation

Subject: Re: [boost] [quickbook] error with links when building documentation
From: Daniel James (dnljms_at_[hidden])
Date: 2010-12-12 19:21:45

On 12 December 2010 22:49, Christian Henning <chhenning_at_[hidden]> wrote:
> Hi there, I keep getting these strange errors when building my documentation:
>
> Error: no ID for constraint linkend: _Tutorial_.
> Error: no ID for constraint linkend: _extenting_io_.
> Error: no ID for constraint linkend: _Supported_Formats_.
> Error: no ID for constraint linkend: _Supported_Formats_.

It means that you're linking to an id that doesn't exist. You've got
'[link _Tutorial_ Tutorial]' but nothing with the id '_Tutorial_'.
It's probably should be '[link gil.io.tutorial Tutorial]'.

I'd also suggest you use sections or anchors for anything you want to
link to, so that you can specify the id explicitly as id generation is
a bit odd at times. Quickbook 1.6 will improve matters and be able to
have explicit ids on headers, but that won't be stable (or documented)
for a while.

Daniel