[Emacs-diffs] /srv/bzr/emacs/emacs-24 r108089: * doc/misc/url.texi (Parsed URLs): Adjust to the code's use of defstruct.

[Stefan Monnier]

------------------------------------------------------------
revno: 108089
fixes bug: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=12096
author: Aurélien Aptel <address@hidden>
committer: Stefan Monnier <address@hidden>
branch nick: emacs-24
timestamp: Mon 2012-08-06 17:50:25 -0400
message:
  * doc/misc/url.texi (Parsed URLs): Adjust to the code's use of defstruct.
modified:
  doc/misc/ChangeLog
  doc/misc/url.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2012-07-28 07:38:32 +0000
+++ b/doc/misc/ChangeLog        2012-08-06 21:50:25 +0000
@@ -1,3 +1,8 @@
+2012-08-06  Aurélien Aptel  <address@hidden>
+
+       * url.texi (Parsed URLs): Adjust to the code's use of defstruct
+       (bug#12096).
+
 2012-07-28  Eli Zaretskii  <address@hidden>
 
        * faq.texi (Right-to-left alphabets): Update for Emacs 24.

=== modified file 'doc/misc/url.texi'
--- a/doc/misc/url.texi 2012-02-29 08:12:51 +0000
+++ b/doc/misc/url.texi 2012-08-06 21:50:25 +0000
@@ -126,10 +126,10 @@
 @section Parsed URLs
 @cindex parsed URLs
 The library functions typically operate on @dfn{parsed} versions of
-URLs.  These are actually vectors of the form:
+URLs.  These are actually CL structures (vectors) of the form:
 
 @example
address@hidden @var{user} @var{password} @var{host} @var{port} @var{file} 
@var{target} @var{attributes} @var{full}]
+[cl-struct-url @var{type} @var{user} @var{password} @var{host} @var{port} 
@var{filename} @var{target} @var{attributes} @var{fullness} @var{use-cookies}]
 @end example
 
 @noindent where
@@ -144,16 +144,19 @@
 is the host name associated with it, or @code{nil};
 @item port
 is the port number associated with it, or @code{nil};
address@hidden file
address@hidden filename
 is the ``file'' part of it, or @code{nil}.  This doesn't necessarily
 actually refer to a file;
 @item target
 is the target part, or @code{nil};
 @item attributes
 is the attributes associated with it, or @code{nil};
address@hidden full
address@hidden fullness
 is @code{t} for a fully-specified URL, with a host part indicated by
 @samp{//} after the scheme part.
address@hidden use-cookies
+is @code{nil} to neither send or store cookies to the server, @code{t}
+otherwise.
 @end table
 
 @findex url-type
@@ -161,23 +164,21 @@
 @findex url-password
 @findex url-host
 @findex url-port
address@hidden url-file
address@hidden url-filename
 @findex url-target
 @findex url-attributes
address@hidden url-full
address@hidden url-set-type
address@hidden url-set-user
address@hidden url-set-password
address@hidden url-set-host
address@hidden url-set-port
address@hidden url-set-file
address@hidden url-set-target
address@hidden url-set-attributes
address@hidden url-set-full
address@hidden url-fullness
 These attributes have accessors named @address@hidden, where
 @var{part} is the name of one of the elements above, e.g.,
address@hidden  Similarly, there are setters of the form
address@hidden@var{part}}.
address@hidden  These attributes can be set with the same accessors
+using @code{setf}:
+
address@hidden
+(setf (url-port url) 80)
address@hidden example
+
+If @var{port} is @var{nil}, @code{url-port} returns the default port
+of the protocol.
 
 There are functions for parsing and unparsing between the string and
 vector forms.