[tor-bugs] #21151 [Core Tor/Tor]: man page lists wrong default for DataDirectory

[Tor Bug Tracker & Wiki]

#21151: man page lists wrong default for DataDirectory
------------------------------+-----------------
     Reporter:  arma          |      Owner:
         Type:  defect        |     Status:  new
     Priority:  Medium        |  Milestone:
    Component:  Core Tor/Tor  |    Version:
     Severity:  Normal        |   Keywords:
Actual Points:                |  Parent ID:
       Points:                |   Reviewer:
      Sponsor:                |
------------------------------+-----------------
 In my doc/tor.1 in my git checkout, I have
 {{{
        DataDirectory DIR
            Store working data in DIR (Default: /usr/local/var/lib/tor)
 }}}

 Apparently the underlying code (in tor.1.txt) is
 {{{
 [[DataDirectory]] **DataDirectory** __DIR__::
     Store working data in DIR (Default: @LOCALSTATEDIR@/lib/tor)
 }}}

 It looks like if DataDirectory remains unset (which is the default), on
 Windows you get
 {{{
 get_windows_conf_root()
 }}}

 whereas on other platforms, you get
 {{{
     d = "~/.tor";
 }}}
 and then it's only if you're running as root that you get
 {{{
      fn = tor_strdup(LOCALSTATEDIR PATH_SEPARATOR "tor");
 }}}

 But I admit that all of this is confusing, because we have functions like
 {{{find_torrc_filename()}}} and {{{get_default_conf_file()}}} and
 {{{get_torrc_fname()}}} so it's hard to say for sure.

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