Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs: netlink: netlink-raw.rst: use :ref: instead of :doc:

Currently, rt documents are referred with:

Documentation/userspace-api/netlink/netlink-raw.rst: :doc:`rt-link<../../networking/netlink_spec/rt-link>`
Documentation/userspace-api/netlink/netlink-raw.rst: :doc:`tc<../../networking/netlink_spec/tc>`
Documentation/userspace-api/netlink/netlink-raw.rst: :doc:`tc<../../networking/netlink_spec/tc>`

Having :doc: references with relative paths doesn't always work,
as it may have troubles when O= is used. Also that's hard to
maintain, and may break if we change the way rst files are
generated from yaml. Better to use instead a reference for
the netlink family.

So, replace them by Sphinx cross-reference tag that are
created by ynl_gen_rst.py.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Reviewed-by: Donald Hunter <donald.hunter@gmail.com>

+6 -5
+3 -2
tools/net/ynl/pyynl/ynl_gen_rst.py
··· 314 314 315 315 # Main header 316 316 317 - lines.append(rst_header()) 318 - 319 317 family = obj['name'] 318 + 319 + lines.append(rst_header()) 320 + lines.append(rst_label("netlink-" + family)) 320 321 321 322 title = f"Family ``{family}`` netlink specification" 322 323 lines.append(rst_title(title))