On Fri, 08 Mar 2019, Markus Heiser <markus.heiser@xxxxxxxxxxx> wrote:
> Hi Tobin,
>
> Am 07.03.19 um 21:30 schrieb Tobin C. Harding:
>> On Thu, Mar 07, 2019 at 10:58:07AM +0100, Markus Heiser wrote:
> [...]
>>> If there is any interest in, I can implement a RFC for this.
>>
>> Cool! I think this would be super useful, I for one like using
>> SPHINXDIRS when developing docs incrementally so removing false warnings
>> would be nice. I doubt I'm the only one to be baffled about Sphinx
>> references. I'd be happy to review and test your RFC if you CC me.
>
> Intersphinx has also drawbacks. E.g.:
>
> >> To close such cross-books links we can use intersphinx [1] and map to e.g.
> >>
> >> intersphinx_mapping = {
> >> 'kernel': ('https://www.kernel.org/doc/html/latest/', None)}
>
> This requires online access while building the output. Anyway, as soon as
> I have some time to spare I will send a RFC with more explanation about
> (you will receive it in CC).
Please remember to call out the online access in the patch series. Such
a requirement is going to draw a lot of opposition.
BR,
Jani.
--
Jani Nikula, Intel Open Source Graphics Center
