1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-27 10:54:40 +00:00

Document the nil/default values of url-user-agent

* doc/misc/url.texi (Customization): Document the nil/default
values of url-user-agent.
This commit is contained in:
Lars Magne Ingebrigtsen 2016-04-24 14:55:15 +02:00
parent 234ef3b432
commit b876ee8971
2 changed files with 11 additions and 5 deletions

View File

@ -1337,10 +1337,16 @@ Connect directly.
@end defopt
@defopt url-user-agent
The User Agent string used for sending HTTP/HTTPS requests. The value
should be a string or a function of no arguments that returns a
string. The default value is @w{@samp{User-Agent: @var{package-name}
URL/Emacs}}, where @var{package-name} is the value of
The User Agent string used for sending @acronym{HTTP}/@acronym{HTTPS}
requests. The value should be @code{nil}, which means that no
@samo{User-Agent} header is generated, @code{default}, which means
that a string is generated based on the setting of
@code{url-privacy-leve}, a string or a function of no arguments that
returns a string.
The default is @code{default}, which means that the
@w{@samp{User-Agent: @var{package-name} URL/Emacs}} string will be
generated, where @var{package-name} is the value of
@code{url-package-name} and its version, if they are non-@code{nil}.
@end defopt

View File

@ -284,7 +284,7 @@ domain.
*** The URL package now support https over proxies supporting CONNECT.
---
+++
*** `url-user-agent' now defaults to `default', and the User-Agent
string is computed dynamically based on `url-privacy-level'.