"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/Mainpage.txt" between
uriparser-0.9.4.tar.xz and uriparser-0.9.5.tar.xz

About: uriparser is a strictly RFC 3986 compliant URI parsing library (with Unicode support).

Mainpage.txt  (uriparser-0.9.4.tar.xz):Mainpage.txt  (uriparser-0.9.5.tar.xz)
skipping to change at line 13 skipping to change at line 13
* *
* @section SEC_TOC Table of Contents * @section SEC_TOC Table of Contents
* - <a href="#intro">Introduction</a> * - <a href="#intro">Introduction</a>
* - Algorithms and Examples * - Algorithms and Examples
* - <a href="#parsing">Parsing URIs</a> (from string to object) * - <a href="#parsing">Parsing URIs</a> (from string to object)
* - <a href="#recomposition">Recomposing URIs</a> (from object back to string ) * - <a href="#recomposition">Recomposing URIs</a> (from object back to string )
* - <a href="#resolution">Resolving References</a> * - <a href="#resolution">Resolving References</a>
* - <a href="#shortening">Creating References</a> * - <a href="#shortening">Creating References</a>
* - <a href="#filenames">Filenames and URIs</a> * - <a href="#filenames">Filenames and URIs</a>
* - <a href="#normalization">Normalizing URIs</a> * - <a href="#normalization">Normalizing URIs</a>
* - <a href="#querystrings">Working with query strings</a> * - <a href="#querystrings">Working with Query Strings</a>
* - <a href="#chartypes">Ansi and Unicode</a> * - <a href="#chartypes">Narrow Strings and Wide Strings</a>
* - <a href="#autoconf">Autoconf Check</a> * - <a href="#autoconf">Autoconf Check</a>
* *
* *
* @section intro Introduction * @section intro Introduction
* Welcome to the short uriparser integration tutorial. * Welcome to the short uriparser integration tutorial.
* It is intended to answer upcoming questions and to shed light * It is intended to answer upcoming questions and to shed light
* where function prototypes alone are not enough. * where function prototypes alone are not enough.
* Please drop me a line if you need further assistance and I will * Please drop me a line if you need further assistance and I will
* see what I can do for you. Good luck with uriparser! * see what I can do for you. Good luck with uriparser!
* *
skipping to change at line 229 skipping to change at line 229
* internally: * internally:
* *
* @code * @code
* if (uriNormalizeSyntaxA(&uri) != URI_SUCCESS) { * if (uriNormalizeSyntaxA(&uri) != URI_SUCCESS) {
* /COMMENT_HACK* Failure *COMMENT_HACK/ * /COMMENT_HACK* Failure *COMMENT_HACK/
* ... * ...
* } * }
* @endcode * @endcode
* *
* *
* @section querystrings Working with query strings * @section querystrings Working with Query Strings
* <a href="http://tools.ietf.org/html/rfc3986" target="_blank">RFC 3986</a> * <a href="http://tools.ietf.org/html/rfc3986" target="_blank">RFC 3986</a>
* itself does not understand the query part of a URI as a list of key/value pai rs. * itself does not understand the query part of a URI as a list of key/value pai rs.
* But HTML 2.0 does and defines a media type <i>application/x-www-form-urlencod ed</i> * But HTML 2.0 does and defines a media type <i>application/x-www-form-urlencod ed</i>
* in in <a href="http://tools.ietf.org/html/rfc1866#section-8.2.1" target="blan k">section 8.2.1</a> * in in <a href="http://tools.ietf.org/html/rfc1866#section-8.2.1" target="blan k">section 8.2.1</a>
* of <a href="http://tools.ietf.org/html/rfc1866" target="blank">RFC 1866</a>. * of <a href="http://tools.ietf.org/html/rfc1866" target="blank">RFC 1866</a>.
* uriparser allows you to dissect (or parse) a query string into unescaped key/ value pairs * uriparser allows you to dissect (or parse) a query string into unescaped key/ value pairs
* and back. * and back.
* *
* To dissect the query part of a just-parsed URI you could write code like this : * To dissect the query part of a just-parsed URI you could write code like this :
* *
skipping to change at line 284 skipping to change at line 284
* } * }
* if (uriComposeQueryA(queryString, queryList, charsRequired + 1, &charsWri tten) != URI_SUCCESS) { * if (uriComposeQueryA(queryString, queryList, charsRequired + 1, &charsWri tten) != URI_SUCCESS) {
* /COMMENT_HACK* Failure *COMMENT_HACK/ * /COMMENT_HACK* Failure *COMMENT_HACK/
* ... * ...
* } * }
* ... * ...
* free(queryString); * free(queryString);
* @endcode * @endcode
* *
* *
* @section chartypes Ansi and Unicode * @section chartypes Narrow Strings and Wide Strings
* uriparser comes with two versions of every structure and function: * uriparser comes with two versions of every structure and function:
* one handling Ansi text (char *) and one working with Unicode text (wchar_t *) , * one handling narrow strings (<code>char *</code>) and one working with wide s trings (<code>wchar_t *</code>),
* for instance * for instance
* - uriParseSingleUriA() for Ansi and * - uriParseSingleUriA() for <code>char *</code>
* - uriParseSingleUriW() for Unicode. * - uriParseSingleUriW() for <code>wchar_t *</code>.
* *
* This tutorial only shows the usage of the Ansi editions but * This tutorial only shows the usage of the narrow string editions but
* their Unicode counterparts work in the very same way. * their wide string counterparts work in the very same way.
* *
* *
* @section autoconf Autoconf Check * @section autoconf Autoconf Check
* You can use the code below to make <c>./configure</c> test for presence * You can use the code below to make <c>./configure</c> test for presence
* of uriparser 0.6.4 or later. * of uriparser 0.9.0 or later.
* *
*<div class="fragment"><pre class="fragment">URIPARSER_MISSING=<span class="str *<div class="fragment"><pre class="fragment">PKG_CHECK_MODULES([URIPARSER], [li
ingliteral">"Please install uriparser 0.9.0 or later. buriparser >= 0.9.0], [], [])</pre></div>
* On a Debian-based system enter 'sudo apt-get install liburiparser-dev'."</s
pan>
*AC_CHECK_LIB(uriparser, uriParseSingleUriA,, AC_MSG_ERROR(${URIPARSER_MISSING}
))
*AC_CHECK_HEADER(uriparser/Uri.h,, AC_MSG_ERROR(${URIPARSER_MISSING}))
*<b></b>
*URIPARSER_TOO_OLD=<span class="stringliteral">"uriparser 0.9.0 or later is req
uired, your copy is too old."</span>
*AC_COMPILE_IFELSE([
*<span class="preprocessor">\#include <uriparser/Uri.h>
*\#if (defined(URI_VER_MAJOR) && defined(URI_VER_MINOR) && defined(URI_VER_RELE
ASE) \\<b></b>
*&& ((URI_VER_MAJOR > 0) \\<b></b>
*|| ((URI_VER_MAJOR == 0) && (URI_VER_MINOR > 9)) \\<b></b>
*|| ((URI_VER_MAJOR == 0) && (URI_VER_MINOR == 9) && (URI_VER_RELEASE >= 0)) \\
<b></b>
*))</span>
*<span class="comment"><b></b>/<b></b>* FINE *<b></b>/</span>
*<span class="preprocessor">\#else
*\# error uriparser not recent enough
*\#endif</span>
*],,AC_MSG_ERROR(${URIPARSER_TOO_OLD}))</pre></div>
*/ */
 End of changes. 8 change blocks. 
34 lines changed or deleted 12 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)