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

Tor Bug Tracker & Wiki blackhole at torproject.org
Sun Dec 15 22:48:25 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:
-------------------------------------------------+-------------------------
Changes (by teor):

 * status:  needs_review => needs_revision


Comment:

 All these changes look good, but the options are not actually in
 alphabetical order. (There are some cases where word breaks make ordering
 ambiguous, and others where the options are just out of order.)

 {{{
 $ head -930 doc/tor.1.txt | tail -701 | grep '\[\[' | cut -d [ -f 3 | cut
 -d ] -f 1 > general_options.txt
 $ sort general_options.txt > general_options_sorted.txt
 $ diff -u general_options.txt general_options_sorted.txt
 ...
 }}}

 I suggest that we add a test to make sure the options in the general
 section are actually in order.

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


More information about the tor-bugs mailing list