[tor-bugs] #21405 [Core Tor/Tor]: Clarify "address" in man page: IPv4, IPv6, hostname?

[Tor Bug Tracker & Wiki]

#21405: Clarify "address" in man page: IPv4, IPv6, hostname?
----------------------------------------+----------------------------------
 Reporter:  teor                        |          Owner:  nickm
     Type:  defect                      |         Status:  needs_revision
 Priority:  Low                         |      Milestone:  Tor:
                                        |  0.3.2.x-final
Component:  Core Tor/Tor                |        Version:
 Severity:  Minor                       |     Resolution:
 Keywords:  tor-doc easy intro manpage  |  Actual Points:
Parent ID:  #18892                      |         Points:  1
 Reviewer:                              |        Sponsor:
----------------------------------------+----------------------------------
Changes (by dgoulet):

 * status:  needs_review => needs_revision


Comment:

 In the case of `__IP__`, I don't see any mentions of what is the expected
 format? I'm asking because for v4 it is easy but seems that for v6 we do
 require `[]` from what I can see in the code in terms of parsing.

 It's kind of obvious the brackets are needed for IPv6 because you can put
 a port with `:PORT` but could we make a quick note maybe at the start of
 the man page that every IPv6 address needs the brackets?

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