Customization
The following user options affect the general operation of url library.
User Option: url-configuration-directory
The value of this variable specifies the name of the directory where the url library stores its various configuration files, cache files, etc.
The default value specifies a subdirectory named url/ in the standard Emacs user data directory specified by the variable user-emacs-directory (normally ~/.config/emacs or ~/.emacs.d). However, the old default was ~/.url, and this directory is used instead if it exists.
User Option: url-debug
Specifies the types of debug messages which are logged to the *URL-DEBUG* buffer. t means log all messages. A number means log all messages and show them with message. It may also be a list of the types of messages to be logged.
User Option: url-privacy-level
User Option: url-lastloc-privacy-level
Provided lastloc is not prohibited by url-privacy-level, this determines who we send our last location to. none means we include our last location in every outgoing request. domain-match means we send it only if the domain of our last location matches the domain of the URI we are requesting. host-match means we only send our last location back to the same host. The default is domain-match.
Using domain-match for this option requires emacs to make one or more DNS requests each time a new host is contacted, to determine the domain of the host. Results of these lookups are cached, so repeated visits do not require repeated domain lookups.
User Option: url-uncompressor-alist
User Option: url-passwd-entry-func
User Option: url-standalone-mode
User Option: url-bad-port-list
User Option: url-max-password-attempts
User Option: url-show-status
User Option: url-confirmation-func
The function to use for asking yes or no functions. This is normally either y-or-n-p or yes-or-no-p, but could be another function taking a single argument (the prompt) and returning t only if an affirmative answer is given.
User Option: url-gateway-method
A symbol specifying the type of gateway support to use for connections from the local machine. The supported methods are:
telnet
Run telnet in a subprocess to connect;
socks
Connect through a socks server;
ssl
Connect with SSL;
native
Connect directly.
User Option: url-user-agent
The User Agent string used for sending HTTP/HTTPS requests. The value should be nil, which means that no ‘User-Agent’ header is generated, default, which means that a string is generated based on the setting of url-privacy-level, a string or a function of no arguments that returns a string.
The default is default, which means that the ‘User-Agent: package-name URL/Emacs’ string will be generated, where package-name is the value of url-package-name and its version, if they are non-nil.