---

6 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-personal-mail-address ¶

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.