[tor-commits] [stem/master] Drop line numbers in links

atagar at torproject.org atagar at torproject.org
Thu May 14 23:31:54 UTC 2020


commit 328ef47332173504100cda24e16a155e928df157
Author: Damian Johnson <atagar at 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





More information about the tor-commits mailing list