mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-30 11:50:28 +02:00
Code Activity

Update uri? documentation.

Browse source 
* doc/ref/web.texi (URIs): Update uri? documentation for deprecation
  removal.
This commit is contained in:
Andy Wingo 2017-05-22 15:40:10 +02:00
parent 1f560bc4b7
commit 67b35bba67
1 changed files with 3 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

10
doc/ref/web.texi
View file

@ -343,6 +343,9 @@ enforce enforce specific restrictions on the URI-reference. The most
generic URI parser is then @code{string->uri-reference}, and there is generic URI parser is then @code{string->uri-reference}, and there is
also a parser for when you know that you want a relative-ref. also a parser for when you know that you want a relative-ref.
Note that @code{uri?} will only return @code{#t} for URI objects that
have schemes; that is, it rejects relative-refs.
@deffn {Scheme Procedure} string->uri-reference string @deffn {Scheme Procedure} string->uri-reference string
Parse @var{string} into a URI object, while not requiring a scheme. Parse @var{string} into a URI object, while not requiring a scheme.
Return @code{#f} if the string could not be parsed. Return @code{#f} if the string could not be parsed.
@ -353,13 +356,6 @@ Parse @var{string} into a URI object, while asserting that no scheme is
present. Return @code{#f} if the string could not be parsed. present. Return @code{#f} if the string could not be parsed.
@end deffn @end deffn
For compatibility reasons, note that @code{uri?} will return @code{#t}
for all URI objects, even relative-refs. In contrast, @code{build-uri}
and @code{string->uri} require that the resulting URI not be a
relative-ref. As a predicate to distinguish relative-refs from proper
URIs (in the language of RFC 3986), use something like @code{(and
(uri-reference? @var{x}) (not (relative-ref? @var{x})))}.
@node HTTP @node HTTP
@subsection The Hyper-Text Transfer Protocol @subsection The Hyper-Text Transfer Protocol