[tor-bugs] #32846 [Core Tor/Tor]: Tor Manual: Alphabetize Client Options

Tor Bug Tracker & Wiki blackhole at torproject.org
Thu Jan 9 17:28:41 UTC 2020

#32846: Tor Manual: Alphabetize Client Options
 Reporter:  swati                                |          Owner:  (none)
     Type:  project                              |         Status:
                                                 |  merge_ready
 Priority:  Medium                               |      Milestone:
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  documentation, tor-client, manpage,  |  Actual Points:
  gsod, extra-review                             |
Parent ID:  #4310                                |         Points:
 Reviewer:  catalyst, teor                       |        Sponsor:
Changes (by catalyst):

 * status:  needs_revision => merge_ready


 Replying to [comment:10 teor]:
 > Looks good!
 Thanks for the review!  I updated the pull request.

 > I've tried to prioritise the changes I'm suggesting. Feel free to mark
 as merge ready when the "must" and "useful" changes are done.
 > Here are the things I think we must fix before merging:
 > * GuardfractionFile should be moved to the directory authority section.
 It doesn't apply to clients.
 I agree.  Moved.

 > Here are some useful things that I think would help people read the
 > * ReducedConnectionPadding logically belongs immediately after
 > * ReducedCircuitPadding logically belongs immediately after
 >   * CircuitPadding splits the circuit timeout option group. If we're
 going to put it out of order anyway, maybe we should put it with
 I agree, except with moving CircuitPadding.  As a slightly more "top-
 level" option, leaving it in alphabetic order might be better.  Maybe we
 should make a new ticket for moving the timeout options in a new

 > * FascistFirewall* logically belongs after Reachable*Addresses.
 I left this one alone, because we clearly describe FascistFirewall as
 deprecated and refer to ReachableAddresses.

 > * Reject and Warn PlaintextPorts belong together, probably near
 SafeSocks. They all do similar things.
 Done.  Warn now precedes Reject because of how their descriptions are
 worded.  Also moved TestSocks after SafeSocks because they're related and
 they were like that pre-alphabetization.

 > Here are things we could fix now, but we could also do the fix in
 another ticket, possibly by creating a new subsection:
 > * StrictNodes and GeoIPExcludeUnknown might logically belong after
 > * All the *Nodes options (including the HS*Nodes) options, would make
 sense together
 > * This is a big change, so it probably needs another ticket
 > If we create a section for the *Nodes options, we could mark them as
 advanced options. They're all options that might compromise anonymity, by
 changing how tor behaves.
 I agree; let's make a new ticket for these.

Ticket URL: <https://trac.torproject.org/projects/tor/ticket/32846#comment:11>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online

More information about the tor-bugs mailing list