commit 328ef47332173504100cda24e16a155e928df157 Author: Damian Johnson <atagar@torproject.org> Date: Tue May 12 17:11:02 2020 -0700 Drop line numbers in links Sphinx warns if multiple links have the same text but differing urls... /home/atagar/Desktop/stem/stem/descriptor/hidden_service.py:docstring of stem.descriptor.hidden_service.InnerLayer.create:19: WARNING: Duplicate explicit target name: "spec". /home/atagar/Desktop/stem/stem/descriptor/remote.py:docstring of stem.descriptor.remote.DescriptorDownloader.query:15: WARNING: Duplicate explicit target name: "'v3ident' in tor's config.c". On reflection the real problem here is that we supplied line numbers that have already fallen out of date. Simply citing the section number instead. --- stem/descriptor/hidden_service.py | 6 ++++-- stem/descriptor/remote.py | 2 +- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/stem/descriptor/hidden_service.py b/stem/descriptor/hidden_service.py index 84e8e9c0..5b3b5178 100644 --- a/stem/descriptor/hidden_service.py +++ b/stem/descriptor/hidden_service.py @@ -1168,7 +1168,8 @@ class HiddenServiceDescriptorV3(HiddenServiceDescriptor): class OuterLayer(Descriptor): """ Initial encryped layer of a hidden service v3 descriptor (`spec - <https://gitweb.torproject.org/torspec.git/tree/rend-spec-v3.txt#n1154>`_). + <https://gitweb.torproject.org/torspec.git/tree/rend-spec-v3.txt>`_ section + 2.5.1.2). .. versionadded:: 1.8.0 @@ -1264,7 +1265,8 @@ class OuterLayer(Descriptor): class InnerLayer(Descriptor): """ Second encryped layer of a hidden service v3 descriptor (`spec - <https://gitweb.torproject.org/torspec.git/tree/rend-spec-v3.txt#n1308>`_). + <https://gitweb.torproject.org/torspec.git/tree/rend-spec-v3.txt>`_ section + 2.5.2.2). .. versionadded:: 1.8.0 diff --git a/stem/descriptor/remote.py b/stem/descriptor/remote.py index 2e2bb53b..9ced7de3 100644 --- a/stem/descriptor/remote.py +++ b/stem/descriptor/remote.py @@ -805,7 +805,7 @@ class DescriptorDownloader(object): :param str,list authority_v3idents: fingerprint or list of fingerprints of the authority keys, see `'v3ident' in tor's config.c - <https://gitweb.torproject.org/tor.git/tree/src/or/config.c#n819>`_ + <https://gitweb.torproject.org/tor.git/tree/src/or/config.c>`_ for the values. :param query_args: additional arguments for the :class:`~stem.descriptor.remote.Query` constructor