109 |
the possible exception of @code{telnet}, it is rare for ports to be |
the possible exception of @code{telnet}, it is rare for ports to be |
110 |
specified, and it is possible using a non-standard port may have |
specified, and it is possible using a non-standard port may have |
111 |
undesired consequences if a different service is listening on that |
undesired consequences if a different service is listening on that |
112 |
port (e.g.@: an HTTP URL specifying the SMTP port can cause mail to be |
port (e.g., an HTTP URL specifying the SMTP port can cause mail to be |
113 |
sent).@c , but @xref{Other Variables, url-bad-port-list}. |
sent).@c , but @xref{Other Variables, url-bad-port-list}. |
114 |
The meaning of |
The meaning of |
115 |
the @var{path} component depends on the service. |
the @var{path} component depends on the service. |
142 |
@noindent where |
@noindent where |
143 |
@table @var |
@table @var |
144 |
@item type |
@item type |
145 |
is the type of the URL scheme, e.g.@: @code{http} |
is the type of the URL scheme, e.g., @code{http} |
146 |
@item user |
@item user |
147 |
is the username associated with it, or @code{nil}; |
is the username associated with it, or @code{nil}; |
148 |
@item password |
@item password |
182 |
@findex url-set-attributes |
@findex url-set-attributes |
183 |
@findex url-set-full |
@findex url-set-full |
184 |
These attributes have accessors named @code{url-@var{part}}, where |
These attributes have accessors named @code{url-@var{part}}, where |
185 |
@var{part} is the name of one of the elements above, e.g.@: |
@var{part} is the name of one of the elements above, e.g., |
186 |
@code{url-host}. Similarly, there are setters of the form |
@code{url-host}. Similarly, there are setters of the form |
187 |
@code{url-set-@var{part}}. |
@code{url-set-@var{part}}. |
188 |
|
|
317 |
@subsection Language and Encoding Preferences |
@subsection Language and Encoding Preferences |
318 |
|
|
319 |
HTTP allows clients to express preferences for the language and |
HTTP allows clients to express preferences for the language and |
320 |
encoding of documents which servers may honour. |
encoding of documents which servers may honour. For each of these |
321 |
|
variables, the value is a string; it can specify a single choice, or |
322 |
|
it can be a comma-separated list in descending order of preference. |
323 |
|
Each element can be followed by @samp{;q=@var{priority}} to specify |
324 |
|
its preference level; e.g., for @code{url-mime-language-string}, |
325 |
|
@w{@code{"de, en-gb;q=0.8, en;q=0.7"}}. |
326 |
|
|
327 |
@defopt url-mime-charset-string |
@defopt url-mime-charset-string |
328 |
@cindex character sets |
@cindex character sets |
330 |
This variable specifies a preference for character sets when documents |
This variable specifies a preference for character sets when documents |
331 |
can be served in more than one encoding. |
can be served in more than one encoding. |
332 |
|
|
333 |
HTTP allows specifying a list of MIME charsets which indicate your |
HTTP allows specifying a series of MIME charsets which indicate your |
334 |
preferred character set encodings, e.g.@: Latin-9 or Big5, and these |
preferred character set encodings, e.g., Latin-9 or Big5, and these |
335 |
can be weighted. This list is generated automatically from the list |
can be weighted. The default series is generated automatically from |
336 |
of defined coding systems which have associated MIME types. These are |
the associated MIME types of all defined coding systems, sorted by the |
337 |
sorted by coding priority. @xref{Recognize Coding, , Recognizing |
coding system priority specified in Emacs. @xref{Recognize Coding, , |
338 |
Coding Systems, emacs, The GNU Emacs Manual}. |
Recognizing Coding Systems, emacs, The GNU Emacs Manual}. |
339 |
@end defopt |
@end defopt |
340 |
|
|
341 |
@defopt url-mime-language-string |
@defopt url-mime-language-string |
342 |
@cindex language preferences |
@cindex language preferences |
343 |
A string specifying the preferred language when servers can serve |
A string specifying the preferred language when servers can serve |
344 |
files in several languages. Use RFC 1766 abbreviations, e.g.@: |
files in several languages. Use RFC 1766 abbreviations, e.g., |
345 |
@samp{en} for English, @samp{de} for German. It can be a |
@samp{en} for English, @samp{de} for German. |
346 |
comma-separated list in descending order of preference. The ordering |
|
347 |
can be made explicit using `q' factors defined by HTTP, e.g.@: |
The string can be @code{"*"} to get the first available language (as |
348 |
@w{@samp{de, en-gb;q=0.8, en;q=0.7}}. It can be @samp{*} to get the |
opposed to the default). |
|
first available language (as opposed to the default). |
|
349 |
@end defopt |
@end defopt |
350 |
|
|
351 |
@node HTTP URL Options |
@node HTTP URL Options |