58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1 \input texinfo
58849
+ ��膩��鰹申鐃順�渇��膩��� 2 @setfilename ../info/url
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 3 @settitle URL Programmer's Manual
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 4
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 5 @iftex
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 6 @c @finalout
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 7 @end iftex
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 8 @c @setchapternewpage odd
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 9 @c @smallbook
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 10
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 11 @tex
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 12 \overfullrule=0pt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 13 %\global\baselineskip 30pt % for printing in double space
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 14 @end tex
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 15 @dircategory World Wide Web
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 16 @dircategory GNU Emacs Lisp
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 17 @direntry
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 18 * URL: (url). URL loading package.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 19 @end direntry
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 20
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 21 @ifnottex
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 22 This file documents the URL loading package.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 23
75247
+ ��膩��鰹申鐃順�渇��膩��� 24 Copyright @copyright{} 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2002,
79791
+ ��膩��鰹申鐃順�渇��膩��� 25 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 26
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 27 Permission is granted to copy, distribute and/or modify this document
65555
+ ��膩��鰹申鐃順�渇��膩��� 28 under the terms of the GNU Free Documentation License, Version 1.2 or
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 29 any later version published by the Free Software Foundation; with the
59002
+ ��膩��鰹申鐃順�渇��膩��� 30 Invariant Sections being
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 31 ``GNU GENERAL PUBLIC LICENSE''. A copy of the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 32 license is included in the section entitled ``GNU Free Documentation
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 33 License.''
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 34 @end ifnottex
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 35
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 36 @c
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 37 @titlepage
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 38 @sp 6
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 39 @center @titlefont{URL}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 40 @center @titlefont{Programmer's Manual}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 41 @sp 4
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 42 @center First Edition, URL Version 2.0
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 43 @sp 1
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 44 @c @center December 1999
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 45 @sp 5
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 46 @center William M. Perry
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 47 @center @email{wmperry@@gnu.org}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 48 @center David Love
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 49 @center @email{fx@@gnu.org}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 50 @page
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 51 @vskip 0pt plus 1filll
75247
+ ��膩��鰹申鐃順�渇��膩��� 52 Copyright @copyright{} 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2002,
79791
+ ��膩��鰹申鐃順�渇��膩��� 53 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 54
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 55 Permission is granted to copy, distribute and/or modify this document
65555
+ ��膩��鰹申鐃順�渇��膩��� 56 under the terms of the GNU Free Documentation License, Version 1.2 or
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 57 any later version published by the Free Software Foundation; with the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 58 Invariant Sections being
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 59 ``GNU GENERAL PUBLIC LICENSE''. A copy of the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 60 license is included in the section entitled ``GNU Free Documentation
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 61 License.''
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 62 @end titlepage
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 63 @page
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 64 @node Top
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 65 @top URL
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 66
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 67
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 68
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 69 @menu
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 70 * Getting Started:: Preparing your program to use URLs.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 71 * Retrieving URLs:: How to use this package to retrieve a URL.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 72 * Supported URL Types:: Descriptions of URL types currently supported.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 73 * Defining New URLs:: How to define a URL loader for a new protocol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 74 * General Facilities:: URLs can be cached, accessed via a gateway
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 75 and tracked in a history list.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 76 * Customization:: Variables you can alter.
77235
+ ��膩��鰹申鐃順�渇��膩��� 77 * GNU Free Documentation License:: The license for this documentation.
59002
+ ��膩��鰹申鐃順�渇��膩��� 78 * Function Index::
+ ��膩��鰹申鐃順�渇��膩��� 79 * Variable Index::
+ ��膩��鰹申鐃順�渇��膩��� 80 * Concept Index::
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 81 @end menu
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 82
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 83 @node Getting Started
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 84 @chapter Getting Started
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 85 @cindex URLs, definition
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 86 @cindex URIs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 87
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 88 @dfn{Uniform Resource Locators} (URLs) are a specific form of
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 89 @dfn{Uniform Resource Identifiers} (URI) described in RFC 2396 which
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 90 updates RFC 1738 and RFC 1808. RFC 2016 defines uniform resource
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 91 agents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 92
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 93 URIs have the form @var{scheme}:@var{scheme-specific-part}, where the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 94 @var{scheme}s supported by this library are described below.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 95 @xref{Supported URL Types}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 96
62429
+ ��膩��鰹申鐃順�渇��膩��� 97 FTP, NFS, HTTP, HTTPS, @code{rlogin}, @code{telnet}, tn3270,
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 98 IRC and gopher URLs all have the form
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 99
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 100 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 101 @var{scheme}://@r{[}@var{userinfo}@@@r{]}@var{hostname}@r{[}:@var{port}@r{]}@r{[}/@var{path}@r{]}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 102 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 103 @noindent
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 104 where @samp{@r{[}} and @samp{@r{]}} delimit optional parts.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 105 @var{userinfo} sometimes takes the form @var{username}:@var{password}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 106 but you should beware of the security risks of sending cleartext
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 107 passwords. @var{hostname} may be a domain name or a dotted decimal
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 108 address. If the @samp{:@var{port}} is omitted then the library will
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 109 use the `well known' port for that service when accessing URLs. With
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 110 the possible exception of @code{telnet}, it is rare for ports to be
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 111 specified, and it is possible using a non-standard port may have
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 112 undesired consequences if a different service is listening on that
60497
+ ��膩��鰹申鐃順�渇��膩��� 113 port (e.g., an HTTP URL specifying the SMTP port can cause mail to be
62429
+ ��膩��鰹申鐃順�渇��膩��� 114 sent). @c , but @xref{Other Variables, url-bad-port-list}.
+ ��膩��鰹申鐃順�渇��膩��� 115 The meaning of the @var{path} component depends on the service.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 116
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 117 @menu
59002
+ ��膩��鰹申鐃順�渇��膩��� 118 * Configuration::
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 119 * Parsed URLs:: URLs are parsed into vector structures.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 120 @end menu
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 121
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 122 @node Configuration
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 123 @section Configuration
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 124
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 125 @defvar url-configuration-directory
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 126 @cindex @file{~/.url}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 127 @cindex configuration files
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 128 The directory in which URL configuration files, the cache etc.,
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 129 reside. Default @file{~/.url}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 130 @end defvar
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 131
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 132 @node Parsed URLs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 133 @section Parsed URLs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 134 @cindex parsed URLs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 135 The library functions typically operate on @dfn{parsed} versions of
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 136 URLs. These are actually vectors of the form:
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 137
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 138 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 139 [@var{type} @var{user} @var{password} @var{host} @var{port} @var{file} @var{target} @var{attributes} @var{full}]
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 140 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 141
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 142 @noindent where
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 143 @table @var
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 144 @item type
60497
+ ��膩��鰹申鐃順�渇��膩��� 145 is the type of the URL scheme, e.g., @code{http}
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 146 @item user
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 147 is the username associated with it, or @code{nil};
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 148 @item password
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 149 is the user password associated with it, or @code{nil};
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 150 @item host
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 151 is the host name associated with it, or @code{nil};
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 152 @item port
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 153 is the port number associated with it, or @code{nil};
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 154 @item file
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 155 is the `file' part of it, or @code{nil}. This doesn't necessarily
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 156 actually refer to a file;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 157 @item target
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 158 is the target part, or @code{nil};
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 159 @item attributes
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 160 is the attributes associated with it, or @code{nil};
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 161 @item full
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 162 is @code{t} for a fully-specified URL, with a host part indicated by
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 163 @samp{//} after the scheme part.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 164 @end table
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 165
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 166 @findex url-type
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 167 @findex url-user
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 168 @findex url-password
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 169 @findex url-host
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 170 @findex url-port
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 171 @findex url-file
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 172 @findex url-target
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 173 @findex url-attributes
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 174 @findex url-full
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 175 @findex url-set-type
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 176 @findex url-set-user
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 177 @findex url-set-password
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 178 @findex url-set-host
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 179 @findex url-set-port
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 180 @findex url-set-file
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 181 @findex url-set-target
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 182 @findex url-set-attributes
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 183 @findex url-set-full
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 184 These attributes have accessors named @code{url-@var{part}}, where
60497
+ ��膩��鰹申鐃順�渇��膩��� 185 @var{part} is the name of one of the elements above, e.g.,
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 186 @code{url-host}. Similarly, there are setters of the form
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 187 @code{url-set-@var{part}}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 188
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 189 There are functions for parsing and unparsing between the string and
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 190 vector forms.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 191
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 192 @defun url-generic-parse-url url
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 193 Return a parsed version of the string @var{url}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 194 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 195
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 196 @defun url-recreate-url url
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 197 @cindex unparsing URLs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 198 Recreates a URL string from the parsed @var{url}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 199 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 200
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 201 @node Retrieving URLs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 202 @chapter Retrieving URLs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 203
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 204 @defun url-retrieve-synchronously url
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 205 Retrieve @var{url} synchronously and return a buffer containing the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 206 data. @var{url} is either a string or a parsed URL structure. Return
59004
+ ��膩��鰹申鐃順�渇��膩��� 207 @code{nil} if there are no data associated with it (the case for dired,
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 208 info, or mailto URLs that need no further processing).
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 209 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 210
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 211 @defun url-retrieve url callback &optional cbargs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 212 Retrieve @var{url} asynchronously and call @var{callback} with args
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 213 @var{cbargs} when finished. The callback is called when the object
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 214 has been completely retrieved, with the current buffer containing the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 215 object and any MIME headers associated with it. @var{url} is either a
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 216 string or a parsed URL structure. Returns the buffer @var{url} will
59004
+ ��膩��鰹申鐃順�渇��膩��� 217 load into, or @code{nil} if the process has already completed.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 218 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 219
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 220 @node Supported URL Types
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 221 @chapter Supported URL Types
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 222
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 223 @menu
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 224 * http/https:: Hypertext Transfer Protocol.
59002
+ ��膩��鰹申鐃順�渇��膩��� 225 * file/ftp:: Local files and FTP archives.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 226 * info:: Emacs `Info' pages.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 227 * mailto:: Sending email.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 228 * news/nntp/snews:: Usenet news.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 229 * rlogin/telnet/tn3270:: Remote host connectivity.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 230 * irc:: Internet Relay Chat.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 231 * data:: Embedded data URLs.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 232 * nfs:: Networked File System
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 233 @c * finger::
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 234 @c * gopher::
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 235 @c * netrek::
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 236 @c * prospero::
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 237 * cid:: Content-ID.
59002
+ ��膩��鰹申鐃順�渇��膩��� 238 * about::
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 239 * ldap:: Lightweight Directory Access Protocol
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 240 * imap:: IMAP mailboxes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 241 * man:: Unix man pages.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 242 @end menu
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 243
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 244 @node http/https
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 245 @section @code{http} and @code{https}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 246
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 247 The scheme @code{http} is Hypertext Transfer Protocol. The library
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 248 supports version 1.1, specified in RFC 2616. (This supersedes 1.0,
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 249 defined in RFC 1945) HTTP URLs have the following form, where most of
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 250 the parts are optional:
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 251 @example
74026
+ ��膩��鰹申鐃順�渇��膩��� 252 http://@var{user}:@var{password}@@@var{host}:@var{port}/@var{path}?@var{searchpart}#@var{fragment}
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 253 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 254 @c The @code{:@var{port}} part is optional, and @var{port} defaults to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 255 @c 80. The @code{/@var{path}} part, if present, is a slash-separated
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 256 @c series elements. The @code{?@var{searchpart}}, if present, is the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 257 @c query for a search or the content of a form submission. The
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 258 @c @code{#fragment} part, if present, is a location in the document.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 259
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 260 The scheme @code{https} is a secure version of @code{http}, with
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 261 transmission via SSL. It is defined in RFC 2069. Its default port is
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 262 443. This scheme depends on SSL support in Emacs via the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 263 @file{ssl.el} library and is actually implemented by forcing the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 264 @code{ssl} gateway method to be used. @xref{Gateways in general}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 265
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 266 @defopt url-honor-refresh-requests
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 267 This controls honouring of HTTP @samp{Refresh} headers by which
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 268 servers can direct clients to reload documents from the same URL or a
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 269 or different one. @code{nil} means they will not be honoured,
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 270 @code{t} (the default) means they will always be honoured, and
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 271 otherwise the user will be asked on each request.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 272 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 273
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 274
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 275 @menu
59002
+ ��膩��鰹申鐃順�渇��膩��� 276 * Cookies::
+ ��膩��鰹申鐃順�渇��膩��� 277 * HTTP language/coding::
+ ��膩��鰹申鐃順�渇��膩��� 278 * HTTP URL Options::
+ ��膩��鰹申鐃順�渇��膩��� 279 * Dealing with HTTP documents::
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 280 @end menu
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 281
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 282 @node Cookies
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 283 @subsection Cookies
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 284
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 285 @defopt url-cookie-file
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 286 The file in which cookies are stored, defaulting to @file{cookies} in
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 287 the directory specified by @code{url-configuration-directory}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 288 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 289
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 290 @defopt url-cookie-confirmation
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 291 Specifies whether confirmation is require to accept cookies.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 292 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 293
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 294 @defopt url-cookie-multiple-line
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 295 Specifies whether to put all cookies for the server on one line in the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 296 HTTP request to satisfy broken servers like
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 297 @url{http://www.hotmail.com}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 298 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 299
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 300 @defopt url-cookie-trusted-urls
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 301 A list of regular expressions matching URLs from which to accept
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 302 cookies always.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 303 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 304
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 305 @defopt url-cookie-untrusted-urls
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 306 A list of regular expressions matching URLs from which to reject
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 307 cookies always.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 308 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 309
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 310 @defopt url-cookie-save-interval
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 311 The number of seconds between automatic saves of cookies to disk.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 312 Default is one hour.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 313 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 314
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 315
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 316 @node HTTP language/coding
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 317 @subsection Language and Encoding Preferences
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 318
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 319 HTTP allows clients to express preferences for the language and
60497
+ ��膩��鰹申鐃順�渇��膩��� 320 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
60861
+ ��膩��鰹申鐃順�渇��膩��� 322 it can be a comma-separated list.
+ ��膩��鰹申鐃順�渇��膩��� 323
+ ��膩��鰹申鐃順�渇��膩��� 324 Normally this list ordered by descending preference. However, each
+ ��膩��鰹申鐃順�渇��膩��� 325 element can be followed by @samp{;q=@var{priority}} to specify its
+ ��膩��鰹申鐃順�渇��膩��� 326 preference level, a decimal number from 0 to 1; e.g., for
+ ��膩��鰹申鐃順�渇��膩��� 327 @code{url-mime-language-string}, @w{@code{"de, en-gb;q=0.8,
+ ��膩��鰹申鐃順�渇��膩��� 328 en;q=0.7"}}. An element that has no @samp{;q} specification has
+ ��膩��鰹申鐃順�渇��膩��� 329 preference level 1.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 330
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 331 @defopt url-mime-charset-string
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 332 @cindex character sets
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 333 @cindex coding systems
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 334 This variable specifies a preference for character sets when documents
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 335 can be served in more than one encoding.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 336
60497
+ ��膩��鰹申鐃順�渇��膩��� 337 HTTP allows specifying a series of MIME charsets which indicate your
+ ��膩��鰹申鐃順�渇��膩��� 338 preferred character set encodings, e.g., Latin-9 or Big5, and these
+ ��膩��鰹申鐃順�渇��膩��� 339 can be weighted. The default series is generated automatically from
+ ��膩��鰹申鐃順�渇��膩��� 340 the associated MIME types of all defined coding systems, sorted by the
+ ��膩��鰹申鐃順�渇��膩��� 341 coding system priority specified in Emacs. @xref{Recognize Coding, ,
+ ��膩��鰹申鐃順�渇��膩��� 342 Recognizing Coding Systems, emacs, The GNU Emacs Manual}.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 343 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 344
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 345 @defopt url-mime-language-string
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 346 @cindex language preferences
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 347 A string specifying the preferred language when servers can serve
60497
+ ��膩��鰹申鐃順�渇��膩��� 348 files in several languages. Use RFC 1766 abbreviations, e.g.,
+ ��膩��鰹申鐃順�渇��膩��� 349 @samp{en} for English, @samp{de} for German.
+ ��膩��鰹申鐃順�渇��膩��� 350
+ ��膩��鰹申鐃順�渇��膩��� 351 The string can be @code{"*"} to get the first available language (as
+ ��膩��鰹申鐃順�渇��膩��� 352 opposed to the default).
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 353 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 354
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 355 @node HTTP URL Options
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 356 @subsection HTTP URL Options
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 357
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 358 HTTP supports an @samp{OPTIONS} method describing things supported by
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 359 the URL@.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 360
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 361 @defun url-http-options url
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 362 Returns a property list describing options available for URL. The
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 363 property list members are:
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 364
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 365 @table @code
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 366 @item methods
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 367 A list of symbols specifying what HTTP methods the resource
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 368 supports.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 369
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 370 @item dav
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 371 @cindex DAV
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 372 A list of numbers specifying what DAV protocol/schema versions are
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 373 supported.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 374
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 375 @item dasl
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 376 @cindex DASL
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 377 A list of supported DASL search types supported (string form).
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 378
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 379 @item ranges
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 380 A list of the units available for use in partial document fetches.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 381
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 382 @item p3p
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 383 @cindex P3P
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 384 The @dfn{Platform For Privacy Protection} description for the resource.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 385 Currently this is just the raw header contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 386 @end table
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 387
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 388 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 389
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 390 @node Dealing with HTTP documents
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 391 @subsection Dealing with HTTP documents
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 392
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 393 HTTP URLs are retrieved into a buffer containing the HTTP headers
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 394 followed by the body. Since the headers are quasi-MIME, they may be
59005
5c053e769038
(HTTP language/coding, mailto): Replace "GNU Emacs manual" with
Luc Teirlinck <teirllm@auburn.edu>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 395 processed using the MIME library. @xref{Top,, Emacs MIME,
5c053e769038
(HTTP language/coding, mailto): Replace "GNU Emacs manual" with
Luc Teirlinck <teirllm@auburn.edu>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 396 emacs-mime, The Emacs MIME Manual}. The URL package provides a
5c053e769038
(HTTP language/coding, mailto): Replace "GNU Emacs manual" with
Luc Teirlinck <teirllm@auburn.edu>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 397 function to do this in general:
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 398
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 399 @defun url-decode-text-part handle &optional coding
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 400 This function decodes charset-encoded text in the current buffer. In
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 401 Emacs, the buffer is expected to be unibyte initially and is set to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 402 multibyte after decoding.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 403 HANDLE is the MIME handle of the original part. CODING is an explicit
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 404 coding to use, overriding what the MIME headers specify.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 405 The coding system used for the decoding is returned.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 406
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 407 Note that this function doesn't deal with @samp{http-equiv} charset
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 408 specifications in HTML @samp{<meta>} elements.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 409 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 410
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 411 @node file/ftp
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 412 @section file and ftp
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 413 @cindex files
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 414 @cindex FTP
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 415 @cindex File Transfer Protocol
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 416 @cindex compressed files
77062
+ ��膩��鰹申鐃順�渇��膩��� 417 @cindex dired
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 418
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 419 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 420 ftp://@var{user}:@var{password}@@@var{host}:@var{port}/@var{file}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 421 file://@var{user}:@var{password}@@@var{host}:@var{port}/@var{file}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 422 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 423
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 424 These schemes are defined in RFC 1808.
59003
+ ��膩��鰹申鐃順�渇��膩��� 425 @samp{ftp:} and @samp{file:} are synonymous in this library. They
+ ��膩��鰹申鐃順�渇��膩��� 426 allow reading arbitrary files from hosts. Either @samp{ange-ftp}
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 427 (Emacs) or @samp{efs} (XEmacs) is used to retrieve them from remote
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 428 hosts. Local files are accessed directly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 429
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 430 Compressed files are handled, but support is hard-coded so that
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 431 @code{jka-compr-compression-info-list} and so on have no affect.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 432 Suffixes recognized are @samp{.z}, @samp{.gz}, @samp{.Z} and
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 433 @samp{.bz2}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 434
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 435 @defopt url-directory-index-file
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 436 The filename to look for when indexing a directory, default
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 437 @samp{"index.html"}. If this file exists, and is readable, then it
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 438 will be viewed instead of using @code{dired} to view the directory.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 439 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 440
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 441 @node info
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 442 @section info
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 443 @cindex Info
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 444 @cindex Texinfo
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 445 @findex Info-goto-node
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 446
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 447 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 448 info:@var{file}#@var{node}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 449 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 450
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 451 Info URLs are not officially defined. They invoke
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 452 @code{Info-goto-node} with argument @samp{(@var{file})@var{node}}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 453 @samp{#@var{node}} is optional, defaulting to @samp{Top}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 454
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 455 @node mailto
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 456 @section mailto
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 457
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 458 @cindex mailto
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 459 @cindex email
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 460 A mailto URL will send an email message to the address in the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 461 URL, for example @samp{mailto:foo@@bar.com} would compose a
59002
+ ��膩��鰹申鐃順�渇��膩��� 462 message to @samp{foo@@bar.com}.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 463
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 464 @defopt url-mail-command
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 465 @vindex mail-user-agent
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 466 The function called whenever url needs to send mail. This should
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 467 normally be left to default from @var{mail-user-agent}. @xref{Mail
59005
5c053e769038
(HTTP language/coding, mailto): Replace "GNU Emacs manual" with
Luc Teirlinck <teirllm@auburn.edu>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 468 Methods, , Mail-Composition Methods, emacs, The GNU Emacs Manual}.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 469 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 470
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 471 An @samp{X-Url-From} header field containing the URL of the document
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 472 that contained the mailto URL is added if that URL is known.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 473
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 474 RFC 2368 extends the definition of mailto URLs in RFC 1738.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 475 The form of a mailto URL is
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 476 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 477 @samp{mailto:@var{mailbox}[?@var{header}=@var{contents}[&@var{header}=@var{contents}]]}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 478 @end example
59003
+ ��膩��鰹申鐃順�渇��膩��� 479 @noindent where an arbitrary number of @var{header}s can be added. If the
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 480 @var{header} is @samp{body}, then @var{contents} is put in the body
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 481 otherwise a @var{header} header field is created with @var{contents}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 482 as its contents. Note that the URL library does not consider any
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 483 headers `dangerous' so you should check them before sending the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 484 message.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 485
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 486 @c Fixme: update
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 487 Email messages are defined in @sc{rfc}822.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 488
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 489 @node news/nntp/snews
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 490 @section @code{news}, @code{nntp} and @code{snews}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 491 @cindex news
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 492 @cindex network news
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 493 @cindex usenet
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 494 @cindex NNTP
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 495 @cindex snews
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 496
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 497 @c draft-gilman-news-url-01
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 498 The network news URL scheme take the following forms following RFC
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 499 1738 except that for compatibility with other clients, host and port
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 500 fields may be included in news URLs though they are properly only
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 501 allowed for nntp an snews.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 502
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 503 @table @samp
59002
+ ��膩��鰹申鐃順�渇��膩��� 504 @item news:@var{newsgroup}
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 505 Retrieves a list of messages in @var{newsgroup};
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 506 @item news:@var{message-id}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 507 Retrieves the message with the given @var{message-id};
59002
+ ��膩��鰹申鐃順�渇��膩��� 508 @item news:*
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 509 Retrieves a list of all available newsgroups;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 510 @item nntp://@var{host}:@var{port}/@var{newsgroup}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 511 @itemx nntp://@var{host}:@var{port}/@var{message-id}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 512 @itemx nntp://@var{host}:@var{port}/*
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 513 Similar to the @samp{news} versions.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 514 @end table
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 515
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 516 @samp{:@var{port}} is optional and defaults to :119.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 517
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 518 @samp{snews} is the same as @samp{nntp} except that the default port
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 519 is :563.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 520 @cindex SSL
59003
+ ��膩��鰹申鐃順�渇��膩��� 521 (It is tunneled through SSL.)
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 522
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 523 An @samp{nntp} URL is the same as a news URL, except that the URL may
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 524 specify an article by its number.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 525
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 526 @defopt url-news-server
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 527 This variable can be used to override the default news server.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 528 Usually this will be set by the Gnus package, which is used to fetch
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 529 news.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 530 @cindex environment variable
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 531 @vindex NNTPSERVER
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 532 It may be set from the conventional environment variable
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 533 @code{NNTPSERVER}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 534 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 535
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 536 @node rlogin/telnet/tn3270
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 537 @section rlogin, telnet and tn3270
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 538 @cindex rlogin
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 539 @cindex telnet
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 540 @cindex tn3270
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 541 @cindex terminal emulation
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 542 @findex terminal-emulator
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 543
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 544 These URL schemes from RFC 1738 for logon via a terminal emulator have
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 545 the form
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 546 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 547 telnet://@var{user}:@var{password}@@@var{host}:@var{port}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 548 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 549 but the @code{:@var{password}} component is ignored.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 550
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 551 To handle rlogin, telnet and tn3270 URLs, a @code{rlogin},
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 552 @code{telnet} or @code{tn3270} (the program names and arguments are
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 553 hardcoded) session is run in a @code{terminal-emulator} buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 554 Well-known ports are used if the URL does not specify a port.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 555
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 556 @node irc
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 557 @section irc
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 558 @cindex IRC
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 559 @cindex Internet Relay Chat
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 560 @cindex ZEN IRC
71226
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 561 @cindex ERC
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 562 @cindex rcirc
59002
+ ��膩��鰹申鐃順�渇��膩��� 563 @c Fixme: reference (was http://www.w3.org/Addressing/draft-mirashi-url-irc-01.txt)
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 564 @dfn{Internet Relay Chat} (IRC) is handled by handing off the @sc{irc}
59002
+ ��膩��鰹申鐃順�渇��膩��� 565 session to a function named in @code{url-irc-function}.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 566
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 567 @defopt url-irc-function
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 568 A function to actually open an IRC connection.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 569 This function
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 570 must take five arguments, @var{host}, @var{port}, @var{channel},
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 571 @var{user} and @var{password}. The @var{channel} argument specifies the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 572 channel to join immediately, this can be @code{nil}. By default this is
71226
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 573 @code{url-irc-rcirc}.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 574 @end defopt
71226
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 575 @defun url-irc-rcirc host port channel user password
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 576 Processes the arguments and lets @code{rcirc} handle the session.
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 577 @end defun
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 578 @defun url-irc-erc host port channel user password
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 579 Processes the arguments and lets @code{ERC} handle the session.
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 580 @end defun
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 581 @defun url-irc-zenirc host port channel user password
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 582 Processes the arguments and lets @code{zenirc} handle the session.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 583 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 584
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 585 @node data
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 586 @section data
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 587 @cindex data URLs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 588
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 589 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 590 data:@r{[}@var{media-type}@r{]}@r{[};@var{base64}@r{]},@var{data}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 591 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 592
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 593 Data URLs contain MIME data in the URL itself. They are defined in
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 594 RFC 2397.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 595
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 596 @var{media-type} is a MIME @samp{Content-Type} string, possibly
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 597 including parameters. It defaults to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 598 @samp{text/plain;charset=US-ASCII}. The @samp{text/plain} can be
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 599 omitted but the charset parameter supplied. If @samp{;base64} is
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 600 present, the @var{data} are base64-encoded.
59002
+ ��膩��鰹申鐃順�渇��膩��� 601
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 602 @node nfs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 603 @section nfs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 604 @cindex NFS
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 605 @cindex Network File System
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 606 @cindex automounter
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 607
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 608 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 609 nfs://@var{user}:@var{password}@@@var{host}:@var{port}/@var{file}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 610 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 611
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 612 The @samp{nfs:} scheme is defined in RFC 2224. It is similar to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 613 @samp{ftp:} except that it points to a file on a remote host that is
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 614 handled by the automounter on the local host.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 615
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 616 @defvar url-nfs-automounter-directory-spec
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 617 @end defvar
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 618 A string saying how to invoke the NFS automounter. Certain @samp{%}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 619 sequences are recognized:
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 620
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 621 @table @samp
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 622 @item %h
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 623 The hostname of the NFS server;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 624 @item %n
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 625 The port number of the NFS server;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 626 @item %u
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 627 The username to use to authenticate;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 628 @item %p
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 629 The password to use to authenticate;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 630 @item %f
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 631 The filename on the remote server;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 632 @item %%
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 633 A literal @samp{%}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 634 @end table
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 635
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 636 Each can be used any number of times.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 637
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 638 @node cid
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 639 @section cid
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 640 @cindex Content-ID
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 641
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 642 RFC 2111
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 643
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 644 @node about
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 645 @section about
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 646
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 647 @node ldap
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 648 @section ldap
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 649 @cindex LDAP
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 650 @cindex Lightweight Directory Access Protocol
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 651
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 652 The LDAP scheme is defined in RFC 2255.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 653
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 654 @node imap
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 655 @section imap
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 656 @cindex IMAP
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 657
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 658 RFC 2192
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 659
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 660 @node man
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 661 @section man
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 662 @cindex @command{man}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 663 @cindex Unix man pages
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 664 @findex man
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 665
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 666 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 667 @samp{man:@var{page-spec}}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 668 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 669
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 670 This is a non-standard scheme. @var{page-spec} is passed directly to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 671 the Lisp @code{man} function.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 672
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 673 @node Defining New URLs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 674 @chapter Defining New URLs
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 675
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 676 @menu
59002
+ ��膩��鰹申鐃順�渇��膩��� 677 * Naming conventions::
+ ��膩��鰹申鐃順�渇��膩��� 678 * Required functions::
+ ��膩��鰹申鐃順�渇��膩��� 679 * Optional functions::
+ ��膩��鰹申鐃順�渇��膩��� 680 * Asynchronous fetching::
+ ��膩��鰹申鐃順�渇��膩��� 681 * Supporting file-name-handlers::
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 682 @end menu
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 683
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 684 @node Naming conventions
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 685 @section Naming conventions
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 686
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 687 @node Required functions
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 688 @section Required functions
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 689
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 690 @node Optional functions
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 691 @section Optional functions
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 692
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 693 @node Asynchronous fetching
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 694 @section Asynchronous fetching
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 695
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 696 @node Supporting file-name-handlers
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 697 @section Supporting file-name-handlers
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 698
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 699 @node General Facilities
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 700 @chapter General Facilities
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 701
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 702 @menu
59002
+ ��膩��鰹申鐃順�渇��膩��� 703 * Disk Caching::
+ ��膩��鰹申鐃順�渇��膩��� 704 * Proxies::
+ ��膩��鰹申鐃順�渇��膩��� 705 * Gateways in general::
+ ��膩��鰹申鐃順�渇��膩��� 706 * History::
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 707 @end menu
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 708
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 709 @node Disk Caching
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 710 @section Disk Caching
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 711 @cindex Caching
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 712 @cindex Persistent Cache
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 713 @cindex Disk Cache
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 714
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 715 The disk cache stores retrieved documents locally, whence they can be
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 716 retrieved more quickly. When requesting a URL that is in the cache,
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 717 the library checks to see if the page has changed since it was last
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 718 retrieved from the remote machine. If not, the local copy is used,
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 719 saving the transmission over the network.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 720 @cindex Cleaning the cache
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 721 @cindex Clearing the cache
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 722 @cindex Cache cleaning
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 723 Currently the cache isn't cleared automatically.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 724 @c Running the @code{clean-cache} shell script
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 725 @c fist is recommended, to allow for future cleaning of the cache. This
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 726 @c shell script will remove all files that have not been accessed since it
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 727 @c was last run. To keep the cache pared down, it is recommended that this
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 728 @c script be run from @i{at} or @i{cron} (see the manual pages for
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 729 @c crontab(5) or at(1) for more information)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 730
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 731 @defopt url-automatic-caching
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 732 Setting this variable non-@code{nil} causes documents to be cached
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 733 automatically.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 734 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 735
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 736 @defopt url-cache-directory
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 737 This variable specifies the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 738 directory to store the cache files. It defaults to sub-directory
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 739 @file{cache} of @code{url-configuration-directory}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 740 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 741
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 742 @c Fixme: function v. option, but neither used.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 743 @c @findex url-cache-expired
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 744 @c @defopt url-cache-expired
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 745 @c This is a function to decide whether or not a cache entry has expired.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 746 @c It takes two times as it parameters and returns non-@code{nil} if the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 747 @c second time is ``too old'' when compared with the first time.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 748 @c @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 749
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 750 @defopt url-cache-creation-function
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 751 The cache relies on a scheme for mapping URLs to files in the cache.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 752 This variable names a function which sets the type of cache to use.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 753 It takes a URL as argument and returns the absolute file name of the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 754 corresponding cache file. The two supplied possibilities are
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 755 @code{url-cache-create-filename-using-md5} and
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 756 @code{url-cache-create-filename-human-readable}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 757 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 758
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 759 @defun url-cache-create-filename-using-md5 url
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 760 Creates a cache file name from @var{url} using MD5 hashing.
77062
+ ��膩��鰹申鐃順�渇��膩��� 761 This is creates entries with very few cache collisions and is fast.
+ ��膩��鰹申鐃順�渇��膩��� 762 @cindex MD5
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 763 @smallexample
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 764 (url-cache-create-filename-using-md5 "http://www.example.com/foo/bar")
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 765 @result{} "/home/fx/.url/cache/fx/http/com/example/www/b8a35774ad20db71c7c3409a5410e74f"
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 766 @end smallexample
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 767 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 768
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 769 @defun url-cache-create-filename-human-readable url
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 770 Creates a cache file name from @var{url} more obviously connected to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 771 @var{url} than for @code{url-cache-create-filename-using-md5}, but
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 772 more likely to conflict with other files.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 773 @smallexample
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 774 (url-cache-create-filename-human-readable "http://www.example.com/foo/bar")
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 775 @result{} "/home/fx/.url/cache/fx/http/com/example/www/foo/bar"
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 776 @end smallexample
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 777 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 778
59002
+ ��膩��鰹申鐃順�渇��膩��� 779 @c Fixme: never actually used currently?
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 780 @c @defopt url-standalone-mode
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 781 @c @cindex Relying on cache
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 782 @c @cindex Cache only mode
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 783 @c @cindex Standalone mode
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 784 @c If this variable is non-@code{nil}, the library relies solely on the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 785 @c cache for fetching documents and avoids checking if they have changed
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 786 @c on remote servers.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 787 @c @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 788
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 789 @c With a large cache of documents on the local disk, it can be very handy
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 790 @c when traveling, or any other time the network connection is not active
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 791 @c (a laptop with a dial-on-demand PPP connection, etc). Emacs/W3 can rely
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 792 @c solely on its cache, and avoid checking to see if the page has changed
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 793 @c on the remote server. In the case of a dial-on-demand PPP connection,
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 794 @c this will keep the phone line free as long as possible, only bringing up
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 795 @c the PPP connection when asking for a page that is not located in the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 796 @c cache. This is very useful for demonstrations as well.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 797
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 798 @node Proxies
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 799 @section Proxies and Gatewaying
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 800
59002
+ ��膩��鰹申鐃順�渇��膩��� 801 @c fixme: check/document url-ns stuff
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 802 @cindex proxy servers
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 803 @cindex proxies
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 804 @cindex environment variables
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 805 @vindex HTTP_PROXY
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 806 Proxy servers are commonly used to provide gateways through firewalls
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 807 or as caches serving some more-or-less local network. Each protocol
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 808 (HTTP, FTP, etc.)@: can have a different gateway server. Proxying is
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 809 conventionally configured commonly amongst different programs through
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 810 environment variables of the form @code{@var{protocol}_proxy}, where
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 811 @var{protocol} is one of the supported network protocols (@code{http},
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 812 @code{ftp} etc.). The library recognizes such variables in either
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 813 upper or lower case. Their values are of one of the forms:
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 814 @itemize @bullet
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 815 @item @code{@var{host}:@var{port}}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 816 @item A full URL;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 817 @item Simply a host name.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 818 @end itemize
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 819
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 820 @vindex NO_PROXY
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 821 The @code{NO_PROXY} environment variable specifies URLs that should be
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 822 excluded from proxying (on servers that should be contacted directly).
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 823 This should be a comma-separated list of hostnames, domain names, or a
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 824 mixture of both. Asterisks can be used as wildcards, but other
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 825 clients may not support that. Domain names may be indicated by a
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 826 leading dot. For example:
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 827 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 828 NO_PROXY="*.aventail.com,home.com,.seanet.com"
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 829 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 830 @noindent says to contact all machines in the @samp{aventail.com} and
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 831 @samp{seanet.com} domains directly, as well as the machine named
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 832 @samp{home.com}. If @code{NO_PROXY} isn't defined, @code{no_PROXY}
59002
+ ��膩��鰹申鐃順�渇��膩��� 833 and @code{no_proxy} are also tried, in that order.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 834
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 835 Proxies may also be specified directly in Lisp.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 836
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 837 @defopt url-proxy-services
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 838 This variable is an alist of URL schemes and proxy servers that
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 839 gateway them. The items are of the form @w{@code{(@var{scheme}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 840 . @var{host}:@var{portnumber})}}, says that the URL @var{scheme} is
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 841 gatewayed through @var{portnumber} on the specified @var{host}. An
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 842 exception is the pseudo scheme @code{"no_proxy"}, which is paired with
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 843 a regexp matching host names not to be proxied. This variable is
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 844 initialized from the environment as above.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 845
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 846 @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 847 (setq url-proxy-services
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 848 '(("http" . "proxy.aventail.com:80")
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 849 ("no_proxy" . "^.*\\(aventail\\|seanet\\)\\.com")))
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 850 @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 851 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 852
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 853 @node Gateways in general
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 854 @section Gateways in General
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 855 @cindex gateways
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 856 @cindex firewalls
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 857
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 858 The library provides a general gateway layer through which all
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 859 networking passes. It can both control access to the network and
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 860 provide access through gateways in firewalls. This may make direct
63636
+ ��膩��鰹申鐃順�渇��膩��� 861 connections in some cases and pass through some sort of gateway in
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 862 others.@footnote{Proxies (which only operate over HTTP) are
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 863 implemented using this.} The library's basic function responsible for
63636
+ ��膩��鰹申鐃順�渇��膩��� 864 making connections is @code{url-open-stream}.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 865
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 866 @defun url-open-stream name buffer host service
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 867 @cindex opening a stream
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 868 @cindex stream, opening
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 869 Open a stream to @var{host}, possibly via a gateway. The other
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 870 arguments are as for @code{open-network-stream}. This will not make a
63636
+ ��膩��鰹申鐃順�渇��膩��� 871 connection if @code{url-gateway-unplugged} is non-@code{nil}.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 872 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 873
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 874 @defvar url-gateway-local-host-regexp
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 875 This is a regular expression that matches local hosts that do not
63636
+ ��膩��鰹申鐃順�渇��膩��� 876 require the use of a gateway. If @code{nil}, all connections are made
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 877 through the gateway.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 878 @end defvar
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 879
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 880 @defvar url-gateway-method
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 881 This variable controls which gateway method is used. It may be useful
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 882 to bind it temporarily in some applications. It has values taken from
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 883 a list of symbols. Possible values are:
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 884
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 885 @table @code
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 886 @item telnet
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 887 @cindex @command{telnet}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 888 Use this method if you must first telnet and log into a gateway host,
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 889 and then run telnet from that host to connect to outside machines.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 890
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 891 @item rlogin
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 892 @cindex @command{rlogin}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 893 This method is identical to @code{telnet}, but uses @command{rlogin}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 894 to log into the remote machine without having to send the username and
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 895 password over the wire every time.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 896
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 897 @item socks
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 898 @cindex @sc{socks}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 899 Use if the firewall has a @sc{socks} gateway running on it. The
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 900 @sc{socks} v5 protocol is defined in RFC 1928.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 901
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 902 @c @item ssl
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 903 @c This probably shouldn't be documented
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 904 @c Fixme: why not? -- fx
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 905
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 906 @item native
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 907 This method uses Emacs's builtin networking directly. This is the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 908 default. It can be used only if there is no firewall blocking access.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 909 @end table
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 910 @end defvar
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 911
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 912 The following variables control the gateway methods.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 913
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 914 @defopt url-gateway-telnet-host
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 915 The gateway host to telnet to. Once logged in there, you then telnet
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 916 out to the hosts you want to connect to.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 917 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 918 @defopt url-gateway-telnet-parameters
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 919 This should be a list of parameters to pass to the @command{telnet} program.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 920 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 921 @defopt url-gateway-telnet-password-prompt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 922 This is a regular expression that matches the password prompt when
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 923 logging in.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 924 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 925 @defopt url-gateway-telnet-login-prompt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 926 This is a regular expression that matches the username prompt when
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 927 logging in.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 928 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 929 @defopt url-gateway-telnet-user-name
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 930 The username to log in with.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 931 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 932 @defopt url-gateway-telnet-password
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 933 The password to send when logging in.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 934 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 935 @defopt url-gateway-prompt-pattern
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 936 This is a regular expression that matches the shell prompt.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 937 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 938
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 939 @defopt url-gateway-rlogin-host
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 940 Host to @samp{rlogin} to before telnetting out.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 941 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 942 @defopt url-gateway-rlogin-parameters
71226
a6a1e9e44f8b
(irc): Mention new funs `url-irc-rcirc' and `url-irc-erc'.
Romain Francoise <romain@orebokech.com>
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 943 Parameters to pass to @samp{rsh}.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 944 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 945 @defopt url-gateway-rlogin-user-name
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 946 User name to use when logging in to the gateway.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 947 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 948 @defopt url-gateway-prompt-pattern
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 949 This is a regular expression that matches the shell prompt.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 950 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 951
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 952 @defopt socks-server
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 953 This specifies the default server, it takes the form
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 954 @w{@code{("Default server" @var{server} @var{port} @var{version})}}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 955 where @var{version} can be either 4 or 5.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 956 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 957 @defvar socks-password
59003
+ ��膩��鰹申鐃順�渇��膩��� 958 If this is @code{nil} then you will be asked for the password,
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 959 otherwise it will be used as the password for authenticating you to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 960 the @sc{socks} server.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 961 @end defvar
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 962 @defvar socks-username
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 963 This is the username to use when authenticating yourself to the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 964 @sc{socks} server. By default this is your login name.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 965 @end defvar
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 966 @defvar socks-timeout
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 967 This controls how long, in seconds, to wait for responses from the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 968 @sc{socks} server; it is 5 by default.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 969 @end defvar
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 970 @c fixme: these have been effectively commented-out in the code
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 971 @c @defopt socks-server-aliases
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 972 @c This a list of server aliases. It is a list of aliases of the form
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 973 @c @var{(alias hostname port version)}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 974 @c @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 975 @c @defopt socks-network-aliases
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 976 @c This a list of network aliases. Each entry in the list takes the form
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 977 @c @var{(alias (network))} where @var{alias} is a string that names the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 978 @c @var{network}. The networks can contain a pair (not a dotted pair) of
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 979 @c @sc{ip} addresses which specify a range of @sc{ip} addresses, an @sc{ip}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 980 @c address and a netmask, a domain name or a unique hostname or @sc{ip}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 981 @c address.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 982 @c @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 983 @c @defopt socks-redirection-rules
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 984 @c This a list of redirection rules. Each rule take the form
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 985 @c @var{(Destination network Connection type)} where @var{Destination
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 986 @c network} is a network alias from @code{socks-network-aliases} and
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 987 @c @var{Connection type} can be @code{nil} in which case a direct
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 988 @c connection is used, or it can be an alias from
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 989 @c @code{socks-server-aliases} in which case that server is used as a
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 990 @c proxy.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 991 @c @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 992 @defopt socks-nslookup-program
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 993 @cindex @command{nslookup}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 994 This the @samp{nslookup} program. It is @code{"nslookup"} by default.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 995 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 996
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 997 @menu
63636
+ ��膩��鰹申鐃順�渇��膩��� 998 * Suppressing network connections::
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 999 @end menu
59002
+ ��膩��鰹申鐃順�渇��膩��� 1000 @c * Broken hostname resolution::
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1001
63636
+ ��膩��鰹申鐃順�渇��膩��� 1002 @node Suppressing network connections
+ ��膩��鰹申鐃順�渇��膩��� 1003 @subsection Suppressing Network Connections
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1004
63636
+ ��膩��鰹申鐃順�渇��膩��� 1005 @cindex network connections, suppressing
+ ��膩��鰹申鐃順�渇��膩��� 1006 @cindex suppressing network connections
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1007 @cindex bugs, HTML
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1008 @cindex HTML `bugs'
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1009 In some circumstances it is desirable to suppress making network
63636
+ ��膩��鰹申鐃順�渇��膩��� 1010 connections. A typical case is when rendering HTML in a mail user
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1011 agent, when external URLs should not be activated, particularly to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1012 avoid `bugs' which `call home' by fetch single-pixel images and the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1013 like. To arrange this, bind the following variable for the duration
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1014 of such processing.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1015
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1016 @defvar url-gateway-unplugged
63636
+ ��膩��鰹申鐃順�渇��膩��� 1017 If this variable is non-@code{nil} new network connections are never
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1018 opened by the URL library.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1019 @end defvar
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1020
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1021 @c @node Broken hostname resolution
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1022 @c @subsection Broken Hostname Resolution
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1023
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1024 @c @cindex hostname resolver
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1025 @c @cindex resolver, hostname
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1026 @c Some C libraries do not include the hostname resolver routines in
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1027 @c their static libraries. If Emacs was linked statically, and was not
59003
+ ��膩��鰹申鐃順�渇��膩��� 1028 @c linked with the resolver libraries, it will not be able to get to any
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1029 @c machines off the local network. This is characterized by being able
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1030 @c to reach someplace with a raw ip number, but not its hostname
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1031 @c (@url{http://129.79.254.191/} works, but
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1032 @c @url{http://www.cs.indiana.edu/} doesn't). This used to happen on
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1033 @c SunOS4 and Ultrix, but is now probably now rare. If Emacs can't be
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1034 @c rebuilt linked against the resolver library, it can use the external
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1035 @c @command{nslookup} program instead.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1036
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1037 @c @defopt url-gateway-broken-resolution
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1038 @c @cindex @code{nslookup} program
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1039 @c @cindex program, @code{nslookup}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1040 @c If non-@code{nil}, this variable says to use the program specified by
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1041 @c @code{url-gateway-nslookup-program} program to do hostname resolution.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1042 @c @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1043
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1044 @c @defopt url-gateway-nslookup-program
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1045 @c The name of the program to do hostname lookup if Emacs can't do it
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1046 @c directly. This program should expect a single argument on the command
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1047 @c line---the hostname to resolve---and should produce output similar to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1048 @c the standard Unix @command{nslookup} program:
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1049 @c @example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1050 @c Name: www.cs.indiana.edu
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1051 @c Address: 129.79.254.191
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1052 @c @end example
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1053 @c @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1054
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1055 @node History
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1056 @section History
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1057
77062
+ ��膩��鰹申鐃順�渇��膩��� 1058 @findex url-do-setup
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1059 The library can maintain a global history list tracking URLs accessed.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1060 URL completion can be done from it. The history mechanism is set up
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1061 automatically via @code{url-do-setup} when it is configured to be on.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1062 Note that the size of the history list is currently not limited.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1063
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1064 @vindex url-history-hash-table
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1065 The history `list' is actually a hash table,
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1066 @code{url-history-hash-table}. It contains access times keyed by URL
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1067 strings. The times are in the format returned by @code{current-time}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1068
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1069 @defun url-history-update-url url time
59003
+ ��膩��鰹申鐃順�渇��膩��� 1070 This function updates the history table with an entry for @var{url}
+ ��膩��鰹申鐃順�渇��膩��� 1071 accessed at the given @var{time}.
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1072 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1073
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1074 @defopt url-history-track
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1075 If non-@code{nil}, the library will keep track of all the URLs
64465
+ ��膩��鰹申鐃順�渇��膩��� 1076 accessed. If it is @code{t}, the list is saved to disk at the end of
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1077 each Emacs session. The default is @code{nil}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1078 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1079
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1080 @defopt url-history-file
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1081 The file storing the history list between sessions. It defaults to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1082 @file{history} in @code{url-configuration-directory}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1083 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1084
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1085 @defopt url-history-save-interval
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1086 @findex url-history-setup-save-timer
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1087 The number of seconds between automatic saves of the history list.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1088 Default is one hour. Note that if you change this variable directly,
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1089 rather than using Custom, after @code{url-do-setup} has been run, you
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1090 need to run the function @code{url-history-setup-save-timer}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1091 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1092
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1093 @defun url-history-parse-history &optional fname
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1094 Parses the history file @var{fname} (default @code{url-history-file})
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1095 and sets up the history list.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1096 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1097
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1098 @defun url-history-save-history &optional fname
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1099 Saves the current history to file @var{fname} (default
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1100 @code{url-history-file}).
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1101 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1102
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1103 @defun url-completion-function string predicate function
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1104 You can use this function to do completion of URLs from the history.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1105 @end defun
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1106
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1107 @node Customization
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1108 @chapter Customization
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1109
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1110 @section Environment Variables
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1111
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1112 @cindex environment variables
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1113 The following environment variables affect the library's operation at
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1114 startup.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1115
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1116 @table @code
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1117 @item TMPDIR
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1118 @vindex TMPDIR
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1119 @vindex url-temporary-directory
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1120 If this is defined, @var{url-temporary-directory} is initialized from
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1121 it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1122 @end table
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1123
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1124 @section General User Options
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1125
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1126 The following user options, settable with Customize, affect the
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1127 general operation of the package.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1128
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1129 @defopt url-debug
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1130 @cindex debugging
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1131 Specifies the types of debug messages the library which are logged to
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1132 the @code{*URL-DEBUG*} buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1133 @code{t} means log all messages.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1134 A number means log all messages and show them with @code{message}.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1135 If may also be a list of the types of messages to be logged.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1136 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1137 @defopt url-personal-mail-address
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1138 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1139 @defopt url-privacy-level
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1140 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1141 @defopt url-uncompressor-alist
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1142 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1143 @defopt url-passwd-entry-func
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1144 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1145 @defopt url-standalone-mode
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1146 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1147 @defopt url-bad-port-list
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1148 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1149 @defopt url-max-password-attempts
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1150 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1151 @defopt url-temporary-directory
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1152 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1153 @defopt url-show-status
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1154 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1155 @defopt url-confirmation-func
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1156 The function to use for asking yes or no functions. This is normally
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1157 either @code{y-or-n-p} or @code{yes-or-no-p}, but could be another
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1158 function taking a single argument (the prompt) and returning @code{t}
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1159 only if an affirmative answer is given.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1160 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1161 @defopt url-gateway-method
59002
+ ��膩��鰹申鐃順�渇��膩��� 1162 @c fixme: describe gatewaying
63636
+ ��膩��鰹申鐃順�渇��膩��� 1163 A symbol specifying the type of gateway support to use for connections
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1164 from the local machine. The supported methods are:
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1165
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1166 @table @code
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1167 @item telnet
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1168 Run telnet in a subprocess to connect;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1169 @item rlogin
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1170 Rlogin to another machine to connect;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1171 @item socks
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1172 Connect through a socks server;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1173 @item ssl
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1174 Connect with SSL;
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1175 @item native
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1176 Connect directly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1177 @end table
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1178 @end defopt
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1179
77235
+ ��膩��鰹申鐃順�渇��膩��� 1180 @node GNU Free Documentation License
+ ��膩��鰹申鐃順�渇��膩��� 1181 @appendix GNU Free Documentation License
+ ��膩��鰹申鐃順�渇��膩��� 1182 @include doclicense.texi
+ ��膩��鰹申鐃順�渇��膩��� 1183
58830
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1184 @node Function Index
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1185 @unnumbered Command and Function Index
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1186 @printindex fn
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1187
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1188 @node Variable Index
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1189 @unnumbered Variable Index
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1190 @printindex vr
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1191
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1192 @node Concept Index
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1193 @unnumbered Concept Index
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1194 @printindex cp
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1195
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1196 @setchapternewpage odd
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1197 @contents
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
+ ��膩��鰹申鐃順�渇��膩��� 1198 @bye
58833
+ ��膩��鰹申鐃順�渇��膩��� 1199
+ ��膩��鰹申鐃順�渇��膩��� 1200 @ignore
+ ��膩��鰹申鐃順�渇��膩��� 1201 arch-tag: c96be356-7e2d-4196-bcda-b13246c5c3f0
+ ��膩��鰹申鐃順�渇��膩��� 1202 @end ignore