[tor-bugs] #32621 [Core Tor/Tor]: Add automated checks to make sure man page options stay in alphabetical order

Tor Bug Tracker & Wiki blackhole at torproject.org
Tue Jan 7 00:13:23 UTC 2020


#32621: Add automated checks to make sure man page options stay in alphabetical
order
-------------------------------------------------+-------------------------
 Reporter:  teor                                 |          Owner:  (none)
     Type:  task                                 |         Status:  new
 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                                           |
Parent ID:  #4310                                |         Points:  1
 Reviewer:                                       |        Sponsor:
-------------------------------------------------+-------------------------

Comment (by catalyst):

 I looked briefly at Python's diffutils library and it seems plausible as a
 basis for such a tool.

 We'd need some easily-parsed way to mark exceptions, and maybe some way to
 double-check that the anchors names match their item names. (Also we
 should skip the "formatting only" anchors.)

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


More information about the tor-bugs mailing list