diff options
author | James LewisMoss <dres@debian.org> | 2001-07-27 23:45:29 -0400 |
---|---|---|
committer | Bryan Newbold <bnewbold@robocracy.org> | 2017-02-20 00:05:29 -0800 |
commit | f559c149c83da84d0b1c285f0298c84aec564af9 (patch) | |
tree | f1c91bcb9bb5e6dad87b643127c3f878d80d89ee /uri.txi | |
parent | c394920caedf3dac1981bb6b10eeb47fd6e4bb21 (diff) | |
parent | 87b82b5822ca54228cfa6df29be3ad9d4bc47d16 (diff) | |
download | slib-f559c149c83da84d0b1c285f0298c84aec564af9.tar.gz slib-f559c149c83da84d0b1c285f0298c84aec564af9.zip |
Import Debian changes 2d2-1debian/2d2-1
slib (2d2-1) unstable; urgency=low
* New upstream version
* Revert back to free. Is now so.
slib (2d1-1) unstable; urgency=low
* New upstream version.
* Move to non-free. FSF pointed out license doesn't allow modified
versions to be distributed.
* Get a complete list of copyrights that apply to the source into
copyright file.
* Remove setup for guile 1.3.
* Remove postrm. Just calling install-info (lintian) Move install-info
call to prerm since doc-base doesn't do install-info.
slib (2c9-3) unstable; urgency=low
* Change info location to section "The Algorithmic Language Scheme" to
match up with where guile puts it's files.
* Postinst is running slibconfig now. (Closes: #75891)
slib (2c9-2) unstable; urgency=low
* Stop installing slibconfig (for guile).
* In postinst if /usr/sbin/slibconnfig exists call it (Close: #75843
#75891).
slib (2c9-1) unstable; urgency=low
* New upstream (Closes: #74760)
* replace string-index with strsrch:string-index in http-cgi.scm.
* Add doc-base support (Closes: #31163)
Diffstat (limited to 'uri.txi')
-rw-r--r-- | uri.txi | 95 |
1 files changed, 95 insertions, 0 deletions
@@ -0,0 +1,95 @@ +@code{(require 'uri)} +@ftindex uri + +@noindent Implements @dfn{Uniform Resource Identifiers} (URI) as +@cindex Uniform Resource Identifiers +described in RFC 2396. + + +@defun make-uri + + +@defunx make-uri fragment + +@defunx make-uri query fragment + +@defunx make-uri path query fragment + +@defunx make-uri authority path query fragment + +@defunx make-uri scheme authority path query fragment + +Returns a Uniform Resource Identifier string from component arguments. +@end defun + +@defun html:anchor name +Returns a string which defines this location in the (HTML) file +as @var{name}. The hypertext @samp{<A HREF="#@var{name}">} will link to this point. + +@example +(html:anchor "(section 7)") +@result{} +"<A NAME=\"(section%207)\"></A>" +@end example +@end defun + +@defun html:link uri highlighted +Returns a string which links the @var{highlighted} text to @var{uri}. + +@example +(html:link (make-uri "(section 7)") "section 7") +@result{} +"<A HREF=\"#(section%207)\">section 7</A>" +@end example +@end defun + +@defun html:base uri +Returns a string specifying the @dfn{base} @var{uri} of a document, for +@cindex base +inclusion in the HEAD of the document (@pxref{HTML, head}). +@end defun + +@defun html:isindex prompt +Returns a string specifying the search @var{prompt} of a document, for +inclusion in the HEAD of the document (@pxref{HTML, head}). +@end defun + +@defun uri->tree uri-reference base-tree @dots{} +Returns a list of 5 elements corresponding to the parts +(@var{scheme} @var{authority} @var{path} @var{query} @var{fragment}) +of string @var{uri-reference}. Elements corresponding to absent parts are #f. + +The @var{path} is a list of strings. If the first string is empty, +then the path is absolute; otherwise relative. + +If the @var{authority} component is a +@dfn{Server-based Naming Authority}, then it is a list of the +@cindex Server-based Naming Authority +@var{userinfo}, @var{host}, and @var{port} strings (or #f). For other +types of @var{authority} components the @var{authority} will be a +string. + +@example +(uri->tree "http://www.ics.uci.edu/pub/ietf/uri/#Related") +@result{} +(http "www.ics.uci.edu" ("" "pub" "ietf" "uri" "") #f "Related") +@end example +@end defun + +@noindent @code{uric:} prefixes indicate procedures dealing with +URI-components. + + +@defun uric:encode uri-component allows +Returns a copy of the string @var{uri-component} in which all @dfn{unsafe} octets +@cindex unsafe +(as defined in RFC 2396) have been @samp{%} @dfn{escaped}. +@cindex escaped +@code{uric:decode} decodes strings encoded by @code{uric:encode}. +@end defun + +@defun uric:decode uri-component +Returns a copy of the string @var{uri-component} in which each @samp{%} escaped +characters in @var{uri-component} is replaced with the character it encodes. This +routine is useful for showing URI contents on error pages. +@end defun |