Take for example addons.qdoc in the qtdoc repository. This has sections for several modules, which are intended to link on to the module landing pages.

Like this:

\section1 Qt Script

The \l{Qt Script} Module blah blah.

With qdoc this currently doesn't work, because the \l

prefers the section itself as target for the link instead of the module landing page. Currently the section names in that page have to be renamed to work around the issue.

There should be some way to override the behavior, so that you can use section names which are the same as page names.