[tor-bugs] Re: [Tor Bug Tracker] #1195: manpage doesn't talk about mbytes and friends

["Tor Bug Tracker" <torproject-admin@xxxxxxxxxxxxxx>]

#1195: manpage doesn't talk about mbytes and friends
-----------------------------+----------------------------------------------
  Reporter:  Sebastian       |       Owner:  phobos            
      Type:  defect          |      Status:  accepted          
  Priority:  minor           |   Milestone:  Tor: 0.2.2.x-final
 Component:  Tor-Tor client  |     Version:  0.2.1.21          
Resolution:  None            |    Keywords:                    
-----------------------------+----------------------------------------------
Changes (by phobos):

  * status:  new => accepted
  * owner:  => phobos
  * milestone:  => Tor: 0.2.2.x-final


Old description:

> Making this bug report so I don't forget
>
> waltman| In setting a value like AccountingMax in torrc, is there a
> difference
>     between "500 MB" and "500 MBytes"?
> waltman| It's a bit confusing because the manpage says "KB", "MB", etc.,
> but
>     the examples values all are "KBytes", e.g. "RelayBandwidthRate 100
> KBytes"
> Sebastian| you can use either one
> waltman| cool, thanks
> Sebastian| we should fix that in the manpage.
> Sebastian| we're thinking about how we can make the manpage easier to
>     understand for the average use. Hopefully we'll find something.
>
> In our efforts to make the manpage less confusing and more usable for
> people
> with less *nix experience, we might want to explore explaining what we
> mean
> when we allow the user to specify some amount of bandwidth in one
> section,
> and the refer to that section from all the options.
>
> [Automatically added by flyspray2trac: Operating System: All]

New description:

 Making this bug report so I don't forget

 waltman| In setting a value like AccountingMax in torrc, is there a
 difference
     between "500 MB" and "500 MBytes"?
 waltman| It's a bit confusing because the manpage says "KB", "MB", etc.,
 but
     the examples values all are "KBytes", e.g. "RelayBandwidthRate 100
 KBytes"
 Sebastian| you can use either one
 waltman| cool, thanks
 Sebastian| we should fix that in the manpage.
 Sebastian| we're thinking about how we can make the manpage easier to
     understand for the average use. Hopefully we'll find something.

 In our efforts to make the manpage less confusing and more usable for
 people
 with less *nix experience, we might want to explore explaining what we
 mean
 when we allow the user to specify some amount of bandwidth in one section,
 and the refer to that section from all the options.

 [Automatically added by flyspray2trac: Operating System: All]

--

Comment:

 average users don't read man pages.

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