[tor-bugs] #4310 [Core Tor/Tor]: Reorder tor manpage entries within sections

[Tor Bug Tracker & Wiki]

#4310: Reorder tor manpage entries within sections
-------------------------------------------------+-------------------------
 Reporter:  arma                                 |          Owner:  (none)
     Type:  task                                 |         Status:  new
 Priority:  Medium                               |      Milestone:  Tor:
                                                 |  unspecified
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  documentation tor-client manpage     |  Actual Points:
  easy                                           |
Parent ID:                                       |         Points:  3
 Reviewer:                                       |        Sponsor:
-------------------------------------------------+-------------------------

Comment (by arma):

 It's not about section headings. It's about each little piece of the man
 page (RelayBandwidthRate, Nickname, etc) being in a seemingly random order
 within their section. Like, they used to be alphabetized, and then they
 became "alphabetized but with some exceptions", and then it became mostly
 exceptions. Why is Sandbox right before Socksport? Maybe because "sa"
 comes before "so". Why are both of those after HTTPSProxyAuthenticator?
 Maybe because Socksport came after HTTPProxy back when there were far
 fewer torrc options. But then later we've got LogTimeGranularity in
 between RunAsDaemon and TruncateLogFile. Like, what the heck is our
 reasoning for the order we've picked. And the answer is that it just all
 accumulated.

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