[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
Re: [tor-bugs] #4310 [Core Tor/Tor]: Reorder tor manpage entries within sections
#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
_______________________________________________
tor-bugs mailing list
tor-bugs@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs