Re: [PATCH] docs: Fix reST markup when linking to sections
On Sat, 26 Dec 2020 14:18:58 +0100, NĂcolas F. R. A. Prado wrote:
During the process of converting the documentation to reST, some links were converted using the following wrong syntax (and sometimes using %20 instead of spaces):
`Display text <#section-name-in-html>`__
This syntax can work in html, but isn't the one described in docutils, and it also doesn't work on pdf. The following syntax should be used instead:
`Display text <Section Name_>`__
The usual toolchain doesn't mind this unusual syntax, but it causes errors when trying to build using the not-yet-merged rst2pdf:
ValueError: format not resolved, probably missing URL scheme or undefined destination target for 'Forcing%20Quiescent%20States'
Fixes: ccc9971e2147 ("docs: rcu: convert some articles from html to ReST") Fixes: c8cce10a62aa ("docs: Fix the reference labels in Locking.rst") Fixes: e548cdeffcd8 ("docs-rst: convert kernel-locking to ReST") Fixes: 7ddedebb03b7 ("ALSA: doc: ReSTize writing-an-alsa-driver document") Signed-off-by: NĂcolas F. R. A. Prado nfraprado@protonmail.com
For the sound part:
Reviewed-by: Takashi Iwai tiwai@suse.de
thanks,
Takashi
participants (1)
-
Takashi Iwai