[tor-bugs] #32708 [Core Tor/Tor]: manpage: alphabetize General Options

Tor Bug Tracker & Wiki blackhole at torproject.org
Mon Dec 16 06:37:28 UTC 2019

#32708: manpage: alphabetize General Options
 Reporter:  catalyst                             |          Owner:
                                                 |  catalyst
     Type:  task                                 |         Status:
                                                 |  needs_revision
 Priority:  Medium                               |      Milestone:  Tor:
                                                 |  0.4.3.x-final
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  documentation tor-client manpage     |  Actual Points:
  easy gsod                                      |
Parent ID:  #4310                                |         Points:  1
 Reviewer:  teor                                 |        Sponsor:

Comment (by arma):

 Replying to [comment:6 catalyst]:
 > It seems odd to put Password in front of Username, so maybe this can
 also deviate from strict alphabetical order?

 I agree that we shouldn't stick to alphabetical when it makes things

 It also seems really easy to just accumulate more items in the future and
 have it all go messy again.

 Maybe that argues for grouping config options by topic? Or for having more
 'areas', where each area is small and alphabetized? Or for writing down
 some heuristics for how we picked the current order, so that when we add
 things in the future we can have a prayer of keeping things organized?

 I don't have any good answers. So I am just here to say that even though I
 wrote 'alphabetized' in a trac ticket eight years ago does not mean that I
 am certain it is the best way to go. :)

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

More information about the tor-bugs mailing list