tracd --help wrong for --basic-auth ?

[Steven R. Loomis <srl@…>]

tracd --help says

  --basic-auth=BASICAUTH    [projectdir],[htpasswd_file],[realm]

But http://trac.edgewall.org/wiki/TracStandalone#UsingAuthentication says

tracd -p 8080 --basic-auth=environmentname,/fullpath/environmentname/.htpasswd,/fullpath/environmentname /fullpath/environmentname

And it is the latter which works.

So, I think the --help should say something like:

  --basic-auth=BASICAUTH    [projectNAME],[htpasswd_file],[/fullpath/projectdir]

or maybe projectNAME here should be 'realm'.

[cboos]

Looking at the code (source:/trunk/trac/web/standalone.py​ and source:/trunk/trac/web/auth.py​), the [projectdir],[htpasswd_file],[realm] hint seems to be correct.

That doesn't mean that a realm looking like /fullpath/environmentname wouldn't work, as the realm is not used internally when using Basic authentication (as opposed to Digest authentication).

The doc could eventually be clearer about the realm, saying it can be anything for Basic auth, and should match the realm used for the htdigest file for Digest auth.

Or is there another problem?

[cboos]

Well, I verified this, and the documentation in the source code is correct, the quoted part of the TracStandalone page wrong.

In fact, the realm can take any value, even /fullpath/environmentname one wants to have this.

Fixed in TracStandalone@86.