27 |
Permission is granted to copy, distribute and/or modify this document |
Permission is granted to copy, distribute and/or modify this document |
28 |
under the terms of the GNU Free Documentation License, Version 1.1 or |
under the terms of the GNU Free Documentation License, Version 1.1 or |
29 |
any later version published by the Free Software Foundation; with the |
any later version published by the Free Software Foundation; with the |
30 |
Invariant Sections being |
Invariant Sections being |
31 |
``GNU GENERAL PUBLIC LICENSE''. A copy of the |
``GNU GENERAL PUBLIC LICENSE''. A copy of the |
32 |
license is included in the section entitled ``GNU Free Documentation |
license is included in the section entitled ``GNU Free Documentation |
33 |
License.'' |
License.'' |
74 |
* General Facilities:: URLs can be cached, accessed via a gateway |
* General Facilities:: URLs can be cached, accessed via a gateway |
75 |
and tracked in a history list. |
and tracked in a history list. |
76 |
* Customization:: Variables you can alter. |
* Customization:: Variables you can alter. |
77 |
* Function Index:: |
* Function Index:: |
78 |
* Variable Index:: |
* Variable Index:: |
79 |
* Concept Index:: |
* Concept Index:: |
80 |
@end menu |
@end menu |
81 |
|
|
82 |
@node Getting Started |
@node Getting Started |
115 |
the @var{path} component depends on the service. |
the @var{path} component depends on the service. |
116 |
|
|
117 |
@menu |
@menu |
118 |
* Configuration:: |
* Configuration:: |
119 |
* Parsed URLs:: URLs are parsed into vector structures. |
* Parsed URLs:: URLs are parsed into vector structures. |
120 |
@end menu |
@end menu |
121 |
|
|
222 |
|
|
223 |
@menu |
@menu |
224 |
* http/https:: Hypertext Transfer Protocol. |
* http/https:: Hypertext Transfer Protocol. |
225 |
* file/ftp:: Local files and FTP archives. |
* file/ftp:: Local files and FTP archives. |
226 |
* info:: Emacs `Info' pages. |
* info:: Emacs `Info' pages. |
227 |
* mailto:: Sending email. |
* mailto:: Sending email. |
228 |
* news/nntp/snews:: Usenet news. |
* news/nntp/snews:: Usenet news. |
235 |
@c * netrek:: |
@c * netrek:: |
236 |
@c * prospero:: |
@c * prospero:: |
237 |
* cid:: Content-ID. |
* cid:: Content-ID. |
238 |
* about:: |
* about:: |
239 |
* ldap:: Lightweight Directory Access Protocol |
* ldap:: Lightweight Directory Access Protocol |
240 |
* imap:: IMAP mailboxes. |
* imap:: IMAP mailboxes. |
241 |
* man:: Unix man pages. |
* man:: Unix man pages. |
273 |
|
|
274 |
|
|
275 |
@menu |
@menu |
276 |
* Cookies:: |
* Cookies:: |
277 |
* HTTP language/coding:: |
* HTTP language/coding:: |
278 |
* HTTP URL Options:: |
* HTTP URL Options:: |
279 |
* Dealing with HTTP documents:: |
* Dealing with HTTP documents:: |
280 |
@end menu |
@end menu |
281 |
|
|
282 |
@node Cookies |
@node Cookies |
451 |
@cindex email |
@cindex email |
452 |
A mailto URL will send an email message to the address in the |
A mailto URL will send an email message to the address in the |
453 |
URL, for example @samp{mailto:foo@@bar.com} would compose a |
URL, for example @samp{mailto:foo@@bar.com} would compose a |
454 |
message to @samp{foo@@bar.com}. |
message to @samp{foo@@bar.com}. |
455 |
|
|
456 |
@defopt url-mail-command |
@defopt url-mail-command |
457 |
@vindex mail-user-agent |
@vindex mail-user-agent |
493 |
allowed for nntp an snews. |
allowed for nntp an snews. |
494 |
|
|
495 |
@table @samp |
@table @samp |
496 |
@item news:@var{newsgroup} |
@item news:@var{newsgroup} |
497 |
Retrieves a list of messages in @var{newsgroup}; |
Retrieves a list of messages in @var{newsgroup}; |
498 |
@item news:@var{message-id} |
@item news:@var{message-id} |
499 |
Retrieves the message with the given @var{message-id}; |
Retrieves the message with the given @var{message-id}; |
500 |
@item news:* |
@item news:* |
501 |
Retrieves a list of all available newsgroups; |
Retrieves a list of all available newsgroups; |
502 |
@item nntp://@var{host}:@var{port}/@var{newsgroup} |
@item nntp://@var{host}:@var{port}/@var{newsgroup} |
503 |
@itemx nntp://@var{host}:@var{port}/@var{message-id} |
@itemx nntp://@var{host}:@var{port}/@var{message-id} |
550 |
@cindex IRC |
@cindex IRC |
551 |
@cindex Internet Relay Chat |
@cindex Internet Relay Chat |
552 |
@cindex ZEN IRC |
@cindex ZEN IRC |
553 |
@c Fixme: reference (was http://www.w3.org/Addressing/draft-mirashi-url-irc-01.txt) |
@c Fixme: reference (was http://www.w3.org/Addressing/draft-mirashi-url-irc-01.txt) |
554 |
@dfn{Internet Relay Chat} (IRC) is handled by handing off the @sc{irc} |
@dfn{Internet Relay Chat} (IRC) is handled by handing off the @sc{irc} |
555 |
session to a function named in @code{url-irc-function}. |
session to a function named in @code{url-irc-function}. |
556 |
|
|
557 |
@defopt url-irc-function |
@defopt url-irc-function |
558 |
A function to actually open an IRC connection. |
A function to actually open an IRC connection. |
582 |
@samp{text/plain;charset=US-ASCII}. The @samp{text/plain} can be |
@samp{text/plain;charset=US-ASCII}. The @samp{text/plain} can be |
583 |
omitted but the charset parameter supplied. If @samp{;base64} is |
omitted but the charset parameter supplied. If @samp{;base64} is |
584 |
present, the @var{data} are base64-encoded. |
present, the @var{data} are base64-encoded. |
585 |
|
|
586 |
@node nfs |
@node nfs |
587 |
@section nfs |
@section nfs |
588 |
@cindex NFS |
@cindex NFS |
658 |
@chapter Defining New URLs |
@chapter Defining New URLs |
659 |
|
|
660 |
@menu |
@menu |
661 |
* Naming conventions:: |
* Naming conventions:: |
662 |
* Required functions:: |
* Required functions:: |
663 |
* Optional functions:: |
* Optional functions:: |
664 |
* Asynchronous fetching:: |
* Asynchronous fetching:: |
665 |
* Supporting file-name-handlers:: |
* Supporting file-name-handlers:: |
666 |
@end menu |
@end menu |
667 |
|
|
668 |
@node Naming conventions |
@node Naming conventions |
684 |
@chapter General Facilities |
@chapter General Facilities |
685 |
|
|
686 |
@menu |
@menu |
687 |
* Disk Caching:: |
* Disk Caching:: |
688 |
* Proxies:: |
* Proxies:: |
689 |
* Gateways in general:: |
* Gateways in general:: |
690 |
* History:: |
* History:: |
691 |
@end menu |
@end menu |
692 |
|
|
693 |
@node Disk Caching |
@node Disk Caching |
761 |
@end smallexample |
@end smallexample |
762 |
@end defun |
@end defun |
763 |
|
|
764 |
@c Fixme: never actually used currently? |
@c Fixme: never actually used currently? |
765 |
@c @defopt url-standalone-mode |
@c @defopt url-standalone-mode |
766 |
@c @cindex Relying on cache |
@c @cindex Relying on cache |
767 |
@c @cindex Cache only mode |
@c @cindex Cache only mode |
783 |
@node Proxies |
@node Proxies |
784 |
@section Proxies and Gatewaying |
@section Proxies and Gatewaying |
785 |
|
|
786 |
@c fixme: check/document url-ns stuff |
@c fixme: check/document url-ns stuff |
787 |
@cindex proxy servers |
@cindex proxy servers |
788 |
@cindex proxies |
@cindex proxies |
789 |
@cindex environment variables |
@cindex environment variables |
815 |
@noindent says to contact all machines in the @samp{aventail.com} and |
@noindent says to contact all machines in the @samp{aventail.com} and |
816 |
@samp{seanet.com} domains directly, as well as the machine named |
@samp{seanet.com} domains directly, as well as the machine named |
817 |
@samp{home.com}. If @code{NO_PROXY} isn't defined, @code{no_PROXY} |
@samp{home.com}. If @code{NO_PROXY} isn't defined, @code{no_PROXY} |
818 |
and @code{no_proxy} are also tried, in that order. |
and @code{no_proxy} are also tried, in that order. |
819 |
|
|
820 |
Proxies may also be specified directly in Lisp. |
Proxies may also be specified directly in Lisp. |
821 |
|
|
980 |
@end defopt |
@end defopt |
981 |
|
|
982 |
@menu |
@menu |
983 |
* Suppressing network connexions:: |
* Suppressing network connexions:: |
984 |
@end menu |
@end menu |
985 |
@c * Broken hostname resolution:: |
@c * Broken hostname resolution:: |
986 |
|
|
987 |
@node Suppressing network connexions |
@node Suppressing network connexions |
988 |
@subsection Suppressing Network Connexions |
@subsection Suppressing Network Connexions |
1144 |
only if an affirmative answer is given. |
only if an affirmative answer is given. |
1145 |
@end defopt |
@end defopt |
1146 |
@defopt url-gateway-method |
@defopt url-gateway-method |
1147 |
@c fixme: describe gatewaying |
@c fixme: describe gatewaying |
1148 |
A symbol specifying the type of gateway support to use fro connexions |
A symbol specifying the type of gateway support to use fro connexions |
1149 |
from the local machine. The supported methods are: |
from the local machine. The supported methods are: |
1150 |
|
|