[tor-bugs] #30349 [Core Tor/Tor]: Document member-hiding conventions for structs

Tor Bug Tracker & Wiki blackhole at torproject.org
Tue Apr 30 23:53:22 UTC 2019


#30349: Document member-hiding conventions for structs
-------------------------------+-----------------------------------------
     Reporter:  catalyst       |      Owner:  (none)
         Type:  task           |     Status:  new
     Priority:  Medium         |  Milestone:
    Component:  Core Tor/Tor   |    Version:
     Severity:  Normal         |   Keywords:  technical-debt, refactoring
Actual Points:                 |  Parent ID:  #29209
       Points:  0.5            |   Reviewer:
      Sponsor:  Sponsor31-can  |
-------------------------------+-----------------------------------------
 We should document whatever conventions we choose for hiding struct
 members, probably in doc/HACKING. Also we should make tools for searching
 for violations, e.g., code that directly accesses private members without
 using the appropriate macros. (A fairly simple Coccinelle script should
 work for this.)

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/30349>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online


More information about the tor-bugs mailing list