On Dec 12, 2012, at 12:22 PM, Martin Smith wrote:
> If you have trouble creating a link to something (usually title or subtitle)
> because the title or subtitle you are trying to link to exists in more than
> one document and your link goes to the wrong one, consider using the \target
> command. It didn't work across modules until today. The relevant qdoc change
> is integrating in stable as I write.
>
> Suppose you have this as a section header:
>
> \section1 Qt Script
>
> and you want to link to it like this:
>
> See the section called \l {Qt Script} for more details.
>
> This might not work because there is module page with the title Qt Script. So
> if you want to link to the section heading, you might get a link to the
> module page instead, and if you want to link to the module page, you might
> get a link to the section heading.
>
> In this example, if your link goes to the wrong page, you can use the \target
> command. It defines a string you can link to:
>
> \target a_unique_string
> \section1 Qt Script
>
> Then you can write:
>
> See the section called \l {a_unique_string} for more details.
That's wrong. It should be:
See the section called \l {a_unique_string} {Qt Script} for more details.
>
> ...and your link will go to the correct page.
>
> Never use '#' ':' or '.' in the target string, and it is a good idea not to
> use '-' either because qdoc replaces blanks with a '-' when it outputs the
> target for a title or subtitle, so the target for Qt Script become qt-script.
>
> martin
> _______________________________________________
> Development mailing list
> [email protected]
> http://lists.qt-project.org/mailman/listinfo/development
_______________________________________________
Development mailing list
[email protected]
http://lists.qt-project.org/mailman/listinfo/development
