once again: .htpasswd (X.1)


Hello :)

a few months ago, i had the problem to generate a .htpasswd file under OS 10.0.4, that the standard OS X - Apache recogniced! i remember, i had to download a newer version and had to compile it new, wiht several more options, after that, the .htaccess files worked fine! (but, truely, the real reason for that was never found! it was random, that from one day to the other, this worked, as if there never were a problem, but without change something in between in the Apache files!!!!!!) (last end, i just was happy, that it worked and did nothing more change!)

Now, Mac OS X 10.1 (the next generation)... delievers the Apache 1.3.20. (i think).... but, why is this .htaccess file not working again?... i think, this time, apple did not resume to install a fully operable Apache (with PHP, mySQL, access_mod, auth_mod etc.).... where is the problem now?...

as soon as i generated a .htpasswd file in the /private/etc/httpd/users/ folder, apachectl won't start! there is no difference if i use "Allow Override All" or "Allow Override None" in httpd.conf, or in which way i create the .htpasswd file with htpasswd (-c) (-cp) (-cm), it always have the same problem:

[localhost:~] medepp% apachectl graceful
/usr/sbin/apachectl graceful: httpd not running, trying to start
Processing config directory: /private/etc/httpd/users
Processing config file: /private/etc/httpd/users/.htaccess
Syntax error on line 1 of /private/etc/httpd/users/.htaccess:
Invalid command 'susanne:AgDugRoDrAasio', perhaps mis-spelled or defined by a module not included in the server configuration
/usr/sbin/apachectl graceful: httpd could not be started
[localhost:~] medepp%

as soon as i remove the .htpasswd file, the apache will work again! :)... but i want to secure this pages! what's up?

whaaazzzaaaaaaaa????? *grrrrrrrrrrrrrrrrrrRRRRRRRRRRRRRRR*
okay, i have found the error:

my .htpasswd File was located in the /etc/httpd/users/ folder (like the manual from the apache says).....

if i place the .htpasswd file somwhere else, then the apache runs good!

So the Apache is there searching for something else, and skelter over the .htpasswd file, which has not the right syntax for this process (the systemusers)....

thats it!

but i don't understand, why they write such a bullshit into the manual and i'm the only one, who read the manual !!! (all others seemed to know instinctively that the .htpasswd file should be placed somwhere else...)...

why that?
I've found that almost 100% of the time, these tech manuals are written by techies - not tech writers. Basically folks who are writing them shouldn't be writing. Printed books are usually the way to go if you want to learn an application.