Re: [tor-bugs] #7507 [Stem]: Sphinx warnings about "missing attribute mentioned"

["Tor Bug Tracker & Wiki" <blackhole@xxxxxxxxxxxxxx>]

#7507: Sphinx warnings about "missing attribute mentioned"
------------------------+---------------------------------------------------
    Reporter:  atagar   |       Owner:  atagar 
        Type:  defect   |      Status:  closed 
    Priority:  minor    |   Milestone:         
   Component:  Stem     |     Version:         
  Resolution:  wontfix  |    Keywords:  website
      Parent:           |      Points:         
Actualpoints:           |  
------------------------+---------------------------------------------------
Changes (by atagar):

  * status:  new => closed
  * resolution:  => wontfix


Comment:

 Hi Eoin, thanks for looking into this!

 > 1) WARNING: Duplicate explicit target name: "ticket".
 > This can be fixed by using a diferent target name for each different
 link

 The cure sounds worse than the disease in this case. It's common to want
 to have multiple links with the same text. If sphinx produces a warning
 for this then it's probably best ignored.

 > 2) WARNING: missing attribute.
 > These are caused by the all list in the different init.py files

 Ahhhh, makes sense. We definitely don't want to drop the __all__ since
 that would have a functional impact on our users. Sounds like this is
 another warning that's best ignored.

 If there's a configuration option to selectively disable these two
 warnings then that would be great. Barring that guess I'll just keep
 ignoring them - thanks for the explanations!

-- 
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/7507#comment:2>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online
_______________________________________________
tor-bugs mailing list
tor-bugs@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs