/[emacs]/emacs/man/url.texi
ViewVC logotype

Diff of /emacs/man/url.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.3 by rms, Wed Dec 8 20:10:08 2004 UTC revision 1.4 by teirllm, Fri Dec 17 03:14:07 2004 UTC
# Line 27  Copyright (C) 1993, 1994, 1995, 1996  Wi Line 27  Copyright (C) 1993, 1994, 1995, 1996  Wi
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.''
# Line 74  License.'' Line 74  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
# Line 115  The meaning of Line 115  The meaning of
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    
# Line 222  load into, or @var{nil} if the process h Line 222  load into, or @var{nil} if the process h
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.
# Line 235  load into, or @var{nil} if the process h Line 235  load into, or @var{nil} if the process h
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.
# Line 273  otherwise the user will be asked on each Line 273  otherwise the user will be asked on each
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
# Line 451  Info URLs are not officially defined.  T Line 451  Info URLs are not officially defined.  T
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
# Line 493  fields may be included in news URLs thou Line 493  fields may be included in news URLs thou
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}
# Line 550  Well-known ports are used if the URL doe Line 550  Well-known ports are used if the URL doe
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.
# Line 582  including parameters.  It defaults to Line 582  including parameters.  It defaults to
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
# Line 658  the Lisp @code{man} function. Line 658  the Lisp @code{man} function.
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
# Line 684  the Lisp @code{man} function. Line 684  the Lisp @code{man} function.
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
# Line 761  more likely to conflict with other files Line 761  more likely to conflict with other files
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
# Line 783  more likely to conflict with other files Line 783  more likely to conflict with other files
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
# Line 815  NO_PROXY="*.aventail.com,home.com,.seane Line 815  NO_PROXY="*.aventail.com,home.com,.seane
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    
# Line 980  This the @samp{nslookup} program.  It is Line 980  This the @samp{nslookup} program.  It is
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
# Line 1144  function taking a single argument (the p Line 1144  function taking a single argument (the p
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    

Legend:
Removed from v.1.3  
changed lines
  Added in v.1.4

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26