Using Apache 2.050 Manual

[freddo99]

I've installed Apache on XP and see there is a directoy called manual which holds the Apache manual in some form of xml and html files.

How do I use it? I've tried looking at the html files in the browser but they just show up as plain text.

[coopster]

Welcome to WebmasterWorld, freddo99!

I ran into similar issues lately, which I documented in msg#3 of this thread [webmasterworld.com]. Your issue sounds quite similar, so have a look. There are a couple of links at the bottom of that message where I found my answers.

[freddo99]

Thanks for the reply Coopster. I've looked at the information on the links you provided but can't find any reference to gettign the manual working. Can you help further?

[gergoe]

By default the manual is available on the [localhost...] url, in the case if you have the apache listening on localhost, and you did not removed the

Alias /manual/ [b][ServerRoot][/b]/htdocs/manual/

directive from the httpd.conf. There are several other cases when the manual might not be working, for example when the mod_alias module is not enabled, or the manual directory does not have the correct permissions set in the apache config, etc.

[freddo99]

Still not working

I have added the alias to httpd.conf as per the last post, restarted the server but still only get plain text
eg "URI: index.html.de Content-Language: de Content-type: text/html; charset=ISO-8859-1 URI: index.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 URI: index.html.es Content-Language: es Content-type: text/html; charset=ISO-8859-1 URI: " etc
when I enter localhost/manual/

Can you help further?

[gergoe]

This seems to be the content of a .var file (contains type definitions for individual files). Since you have the MultiViews Option (and modules like mod_mime and mod_negotiation) enabled for the /modules directory, the Apache tries to negotiate the language and the content-type of the document with tghe browser, in some rare cases it may lead to problems - like in your case.

If you have the DirectoryIndex set to the default values (or at least you did not removed index.html), and the MultiviewsMatch directive is not listed (or left unchanged) in the httpd.conf file then the [localhost...] url should be working properly. It might be not working, if you did not have any language set in your browser (so it did not send the Accept-Language header, or it is empty) and some of the directives/modules listed above is not enabled.

Try the [localhost...] and/or the [localhost...] urls, and if one of these are working, then you don't have any serious problem.

I can't give you straight answer to the problem (because it is weird), I might check the browser for the language settings, if still not working, then revert the mod_mime and mod_negotiation related settings in the httpd.conf from the default httpd.conf file. If you really got stuck post the relevant parts (module lists, mod_mime and mod_negotiation directives) of the httpd.conf file, and someone might be able to fix this problem.

As a last resort use the [httpd.apache.org...] instead of the locally installed manual ;-)

[coopster]

Did you try enabling EnableMMAP and EnableSendfile as suggested earlier?

# 
# EnableMMAP: Control whether memory-mapping is used to deliver 
# files (assuming that the underlying OS supports it). 
# The default is on; turn this off if you serve from NFS-mounted  
# filesystems. On some systems, turning it off (regardless of 
# filesystem) can improve performance; for details, please see 
# [httpd.apache.org...]  
# 
EnableMMAP Off 
# Also added this one as per Apache directions 
# [apache.org...]  
# ..but commented it out as it did not make any difference. 
#Win32DisableAcceptEx 
# 
# EnableSendfile: Control whether the sendfile kernel support is  
# used to deliver files (assuming that the OS supports it). 
# The default is on; turn this off if you serve from NFS-mounted  
# filesystems. Please see 
# [httpd.apache.org...]  
# 
EnableSendfile Off

If that doesn't do it, try uncommenting the

Win32DisableAcceptEx

directive as well. Don't forget to restart Apache.