From 5545219bf6761e32544be80a193dd4cb53fc0a9c Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Fri, 16 Nov 2001 03:22:15 +0000 Subject: Document the urlsplit() and urlunsplit() functions. --- Doc/lib/liburlparse.tex | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/Doc/lib/liburlparse.tex b/Doc/lib/liburlparse.tex index 1a8ac37..8599d20 100644 --- a/Doc/lib/liburlparse.tex +++ b/Doc/lib/liburlparse.tex @@ -63,6 +63,25 @@ URL that was parsed originally had redundant delimiters, e.g. a ? with an empty query (the draft states that these are equivalent). \end{funcdesc} +\begin{funcdesc}{urlsplit}{urlstring\optional{, + default_scheme\optional{, allow_fragments}}} +This is similar to \function{urlparse()}, but does not split the +params from the URL. This should generally be used instead of +\function{urlparse()} if the more recent URL syntax allowing +parameters to be applied to each segment of the \var{path} portion of +the URL (see \rfc{2396}). A separate function is needed to separate +the path segments and parameters. This function returns a 5-tuple: +(addressing scheme, network location, path, query, fragment +identifier). +\versionadded{2.2} +\end{funcdesc} + +\begin{funcdesc}{urlunsplit}{tuple} +Combine the elements of a tuple as returned by \function{urlsplit()} +into a complete URL as a string. +\versionadded{2.2} +\end{funcdesc} + \begin{funcdesc}{urljoin}{base, url\optional{, allow_fragments}} Construct a full (``absolute'') URL by combining a ``base URL'' (\var{base}) with a ``relative URL'' (\var{url}). Informally, this -- cgit v0.12