bug#12096: 24.1; Several documented functions in URL package are not defined

[Aurélien Aptel]

Hi all,

url-parse.el defines functions to parse an URL. A parsed URL (with
`url-generic-parse-url') is a simple vector whose content is documented
in (info "(url)Parsed URLs").

>From the info page:
> The library functions typically operate on "parsed" versions of URLs.
> These are actually vectors of the form:
>
>      [TYPE USER PASSWORD HOST PORT FILE TARGET ATTRIBUTES FULL]
>
...
>    These attributes have accessors named `url-PART', where PART is the
> name of one of the elements above, e.g., `url-host'.  Similarly, there
> are setters of the form `url-set-PART'.

There are some exceptions which are not documented:

`url-file' is not the FILE attribute accessor. The accessor is actually
`url-filename'.

`url-full' is actually `url-fullness'.

And most importantly none of the setters are defined, as this little
snippet shows:

    (let (funlist)
      (require 'url)
      (require 'url-parse)
      (mapatoms (lambda (a)
                  (when (and (fboundp a)
                             (string-match "^url-set-" (symbol-name a)))
                    (push a funlist))))
                funlist)
    ;; => (url-set-mime-charset-string)


In GNU Emacs 24.1.1 (x86_64-unknown-linux-gnu, GTK+ Version 2.24.10)
 of 2012-06-11 on bitzer.hoetzel.info
Windowing system distributor `The X.Org Foundation', version 11.0.11203000
Configured using:
 `configure '--prefix=/usr' '--sysconfdir=/etc' '--libexecdir=/usr/lib'
 '--localstatedir=/var' '--with-x-toolkit=gtk' '--with-xft'
 'CFLAGS=-march=x86-64 -mtune=generic -O2 -pipe -fstack-protector
 --param=ssp-buffer-size=4 -D_FORTIFY_SOURCE=2'
 'LDFLAGS=-Wl,-O1,--sort-common,--as-needed,-z,relro''

Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: fr_FR.UTF-8
  value of $LANG: en_US.utf8
  value of $XMODIFIERS: nil
  locale-coding-system: utf-8-unix
  default enable-multibyte-characters: t

Major mode: Lisp Interaction

Minor modes in effect:
  rcirc-track-minor-mode: t
  cua-mode: t
  ido-everywhere: t
  show-paren-mode: t
  rainbow-delimiters-mode: t
  yas/global-mode: t
  yas/minor-mode: t
  global-auto-complete-mode: t
  auto-complete-mode: t
  tooltip-mode: t
  mouse-wheel-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  blink-cursor-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  column-number-mode: t
  line-number-mode: t
  transient-mark-mode: t

Recent input:
M-x r e <backspace> C-g ( m p <backspace> a p a t o
m s SPC ( l a m b d a <up> C-g <up> <return> ( l e
t SPC ( f u n l i s t ) <down> <tab> <end> SPC ( a
) <return> <tab> ( f b o u n d p SPC a ) <return> <tab>
( <up> <backspace> ( w h e n SPC ( a n d SPC ( C-e
<return> C-k <tab> C-e s t r i n g - m a t <return>
SPC " ^ u r l - s e t " SPC ( s y u <backspace> m b
o l <down> <return> SPC a ) ) ) <return> <tab> ( p
u s h SPC a SPC f u n l i s t ) ) ) <return> <tab>
f u n <return> ) <up> C-e ) C-n C-j <up> C-SPC <C-down>
C-w <up> <up> <up> <up> <up> <up> C-SPC <C-down> C-g
<up> <up> <up> <up> <up> <up> <end> <return> <tab>
( r e q u i r e SPC ' u r l ) <return> <tab> ( r e
q u i r e SPC ' u r l - p a r s e ) <down> <down> <down>
<down> <down> C-j <up> C-SPC <home> C-SPC <left> <down>
<home> C-SPC <down> C-w <up> <up> <down> <end> <up>
<up> <C-right> <C-right> <C-right> <C-right> - C-g
<down> <down> C-j M-x r e p o e <backspace> r <tab>
<return>

Recent messages:
Fill column set to 80 (was 70)
[yas] Reloaded everything....
Loading grep...done
For information about GNU Emacs and the GNU system, type C-h C-a.
Quit [2 times]
Mark set [3 times]
Mark cleared
Mark activated
Quit

Load-path shadows:
None found.

Features:
(shadow sort mail-extr emacsbug message format-spec rfc822 mml mml-sec
mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils
mailheader sendmail rfc2047 rfc2045 ietf-drums mail-utils url url-proxy
url-privacy url-expand url-methods url-history url-cookie url-util
url-parse auth-source eieio byte-opt bytecomp byte-compile cconv
macroexp gnus-util password-cache url-vars mm-util mail-prsvr mailcap
thingatpt find-func grep compile comint regexp-opt ansi-color cus-start
cus-load rcirc ring windmove cua-base ido delsel knarf-wombat-theme
mark-multiple paren expand-region expand-region-custom
expand-region-core uniquify rainbow-delimiters yasnippet advice
advice-preload dropdown-list help-fns derived easy-mmode help-mode view
easymenu assoc cl auto-complete-config auto-complete edmacro kmacro
popup server dpaste-autoloads expand-region-autoloads gccsense-autoloads
htmlize-autoloads mark-multiple-autoloads rainbow-delimiters-autoloads
package tabulated-list time-date tooltip ediff-hook vc-hooks
lisp-float-type mwheel x-win x-dnd tool-bar dnd fontset image fringe
lisp-mode register page menu-bar rfn-eshadow timer select scroll-bar
mouse jit-lock font-lock syntax facemenu font-core frame cham georgian
utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean
japanese hebrew greek romanian slovak czech european ethiopic indian
cyrillic chinese case-table epa-hook jka-cmpr-hook help simple abbrev
minibuffer loaddefs button faces cus-face files text-properties overlay
sha1 md5 base64 format env code-pages mule custom widget
hashtable-print-readable backquote make-network-process dbusbind
dynamic-setting system-font-setting font-render-setting move-toolbar gtk
x-toolkit x multi-tty emacs)