From 565b1c73e741f73b3bace79ef1c6089dac042d2c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tim=20R=C3=BChsen?= Date: Mon, 10 Aug 2015 17:33:46 +0200 Subject: [PATCH] updated to V0.8.0 --- api-index-full.html | 9 +- deprecated-api-index.html | 9 +- index.html | 7 +- index.sgml | 7 +- libpsl-Public-Suffix-List-functions.html | 124 ++++------ libpsl.devhelp2 | 7 +- object-tree.html | 9 +- style.css | 302 ++++++++++++----------- 8 files changed, 238 insertions(+), 236 deletions(-) diff --git a/api-index-full.html b/api-index-full.html index b9eeef6..c492afc 100644 --- a/api-index-full.html +++ b/api-index-full.html @@ -2,17 +2,17 @@ -Libpsl Reference Manual: API Index +API Index: Libpsl Reference Manual - + - +
-

Object Hierarchy

-
-
-
-

Includes

#include <libpsl.h>
@@ -213,7 +207,7 @@ psl_load_file (const char To free the allocated resources, call psl_free().

The suffixes are expected to be lowercase UTF-8 encoded if they are international.

-

Parameters

+

Parameters

@@ -228,11 +222,10 @@ To free the allocated resources, call -

Returns

+

Returns

Pointer to a PSL context or NULL on failure.

-

-

Since 0.1

+

Since: 0.1

@@ -243,7 +236,7 @@ psl_load_fp (FILE *fppsl_free().

The suffixes are expected to be lowercase UTF-8 encoded if they are international.

-

Parameters

+

Parameters

@@ -258,11 +251,10 @@ To free the allocated resources, call -

Returns

+

Returns

Pointer to a PSL context or NULL on failure.

-

-

Since 0.1

+

Since: 0.1

@@ -276,11 +268,10 @@ You don't have to free the returned context explicitely.

So if using the builtin psl context, you can provide UTF-8 or punycode representations of domains to functions like psl_is_public_suffix().

-

Returns

+

Returns

Pointer to the built in PSL data or NULL if this data is not available.

-

-

Since 0.1

+

Since: 0.1

@@ -305,7 +296,7 @@ Other encodings result in unexpected behavior.

is a context returned by either psl_load_file(), psl_load_fp() or psl_builtin().

-

Parameters

+

Parameters

@@ -327,11 +318,10 @@ Other encodings result in unexpected behavior.

-

Returns

+

Returns

1 if domain is a public suffix, 0 if not.

-

-

Since 0.1

+

Since: 0.1

@@ -349,7 +339,7 @@ Other encodings result in unexpected behavior.

is a context returned by either psl_load_file(), psl_load_fp() or psl_builtin().

-

Parameters

+

Parameters

@@ -371,14 +361,13 @@ Other encodings result in unexpected behavior.

-

Returns

+

Returns

Pointer to longest public suffix part of domain or NULL if domain does not contain a public suffix (or if psl is NULL).

-

-

Since 0.1

+

Since: 0.1

@@ -396,7 +385,7 @@ Other encodings result in unexpected behavior.

is a context returned by either psl_load_file(), psl_load_fp() or psl_builtin().

-

Parameters

+

Parameters

@@ -418,14 +407,13 @@ Other encodings result in unexpected behavior.

-

Returns

+

Returns

Pointer to shortest private suffix part of domain or NULL if domain does not contain a private suffix (or if psl is NULL).

-

-

Since 0.1

+

Since: 0.1

@@ -437,7 +425,7 @@ psl_suffix_count (const -

Parameters

+

Parameters

@@ -452,11 +440,10 @@ The number of exceptions within the Public Suffix List are not included.

-

Returns

+

Returns

Number of public suffixes entries in PSL context.

-

-

Since 0.1

+

Since: 0.1

@@ -467,7 +454,7 @@ psl_suffix_exception_count (const

If the generation of built-in data has been disabled during compilation, 0 will be returned.

-

Parameters

+

Parameters

@@ -482,11 +469,10 @@ psl_suffix_exception_count (const
-

Returns

+

Returns

Number of public suffix exceptions in PSL context.

-

-

Since 0.1

+

Since: 0.1

@@ -496,11 +482,10 @@ psl_builtin_compile_time (voidThis function returns the time when the Publix Suffix List has been compiled into C code (by psl2c).

If the generation of built-in data has been disabled during compilation, 0 will be returned.

-

Returns

+

Returns

time_t value or 0.

-

-

Since 0.1

+

Since: 0.1

@@ -510,11 +495,10 @@ psl_builtin_file_time (voidThis function returns the mtime of the Publix Suffix List file that has been built in.

If the generation of built-in data has been disabled during compilation, 0 will be returned.

-

Returns

+

Returns

time_t value or 0.

-

-

Since 0.1

+

Since: 0.1

@@ -525,11 +509,10 @@ psl_builtin_sha1sum (void< The returned string is in lowercase hex encoding, e.g. "2af1e9e3044eda0678bb05949d7cca2f769901d8".

If the generation of built-in data has been disabled during compilation, an empty string will be returned.

-

Returns

+

Returns

String containing SHA1 checksum or an empty string.

-

-

Since 0.1

+

Since: 0.1

@@ -539,11 +522,10 @@ psl_builtin_filename (void

This function returns the file name of the Publix Suffix List file that has been built in.

If the generation of built-in data has been disabled during compilation, an empty string will be returned.

-

Returns

+

Returns

String containing the PSL file name or an empty string.

-

-

Since 0.1

+

Since: 0.1

@@ -568,7 +550,7 @@ but '.com' or 'com' would NOT be acceptable since 'com' is a public suffix.

< but NOT for 'forgot.his.name' since 'forgot.his.name' is a public suffix.

-

Parameters

+

Parameters

@@ -595,11 +577,10 @@ but NOT for 'forgot.his.name' since 'forgot.his.name' is a public suffix.

-

Returns

+

Returns

1 if acceptable, 0 if not acceptable.

-

-

Since 0.1

+

Since: 0.1

@@ -608,16 +589,15 @@ but NOT for 'forgot.his.name' since 'forgot.his.name' is a public suffix.

void);

Get libpsl version.

-

Returns

+

Returns

String containing version of libpsl.

-

-

Since 0.2.5

+

Since: 0.2.5

psl_str_to_utf8lower ()

-
int
+
psl_error_t
 psl_str_to_utf8lower (const char *str,
                       const char *encoding,
                       const char *locale,
@@ -625,10 +605,10 @@ psl_str_to_utf8lower (const char<
 
This helper function converts a string to lowercase UTF-8 representation.
 Lowercase UTF-8 is needed as input to the domain checking functions.

 
lower
- is NULL on error.
-The return value 'lower' must be freed after usage.

+ is set to NULL on error.

+
The return value 'lower' must be freed after usage.

 

-
Parameters

+
Parameters
@@ -662,7 +642,7 @@ for to lowercase conversion, e.g. 'de' or -

Returns

+

Returns

psl_error_t value. PSL_SUCCESS: Success PSL_ERR_INVALID_ARG: str @@ -672,9 +652,8 @@ PSL_ERR_TO_UTF16: Failed to convert str to unicode PSL_ERR_TO_LOWER: Failed to convert unicode to lowercase PSL_ERR_TO_UTF8: Failed to convert unicode to UTF-8

-

-

Since 0.4

+

Since: 0.4

@@ -685,7 +664,7 @@ PSL_ERR_TO_UTF8: Failed to convert unicode to UTF-8

Negative return codes mean failure. Positive values are reserved for non-error return codes.

-

Members

+

Members

@@ -748,7 +727,6 @@ Positive values are reserved for non-error return codes.

-
- Generated by GTK-Doc V1.20
+
Generated by GTK-Doc V1.24 \ No newline at end of file diff --git a/libpsl.devhelp2 b/libpsl.devhelp2 index 92973fb..4eea0d3 100644 --- a/libpsl.devhelp2 +++ b/libpsl.devhelp2 @@ -1,5 +1,4 @@ - @@ -28,5 +27,11 @@ + + + + + + diff --git a/object-tree.html b/object-tree.html index 57bef97..29474d0 100644 --- a/object-tree.html +++ b/object-tree.html @@ -2,17 +2,17 @@ -Libpsl Reference Manual: Object Hierarchy +Object Hierarchy: Libpsl Reference Manual - + -
+ @@ -27,7 +27,6 @@
-
- Generated by GTK-Doc V1.20
+
Generated by GTK-Doc V1.24 \ No newline at end of file diff --git a/style.css b/style.css index 705a5c9..3675420 100644 --- a/style.css +++ b/style.css @@ -30,127 +30,6 @@ body vertical-align: top; } -@media screen { - sup a.footnote - { - position: relative; - top: 0em ! important; - } - /* this is needed so that the local anchors are displayed below the naviagtion */ - div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] - { - display: inline-block; - position: relative; - top:-5em; - } - /* this seems to be a bug in the xsl style sheets when generating indexes */ - div.index div.index - { - top: 0em; - } - /* make space for the fixed navigation bar and add space at the bottom so that - * link targets appear somewhat close to top - */ - body - { - padding-top: 5em; - padding-bottom: 500px; - max-width: 60em; - } - p - { - max-width: 60em; - } - /* style and size the navigation bar */ - table.navigation#top - { - position: fixed; - background: #e2e2e2; - border-bottom: solid 1px #babdb6; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - z-index: 10; - } - .navigation a, .navigation a:visited - { - /* tango:sky blue 3 */ - color: #204a87; - } - .navigation a:hover - { - /* tango:sky blue 2 */ - color: #3465a4; - } - td.shortcuts - { - /* tango:sky blue 2 */ - color: #3465a4; - font-size: 80%; - white-space: nowrap; - } - td.shortcuts .dim - { - color: #babdb6; - } -} -@media screen and (min-width: 60em) { - /* screen larger than 60em */ - body { margin: auto; } -} -@media screen and (max-width: 60em) { - /* screen less than 60em */ - #nav_hierarchy { display: none; } - #nav_interfaces { display: none; } - #nav_prerequisites { display: none; } - #nav_derived_interfaces { display: none; } - #nav_implementations { display: none; } - #nav_child_properties { display: none; } - #nav_style_properties { display: none; } - #nav_index { display: none; } - #nav_glossary { display: none; } - .gallery_image { display: none; } - .property_flags { display: none; } - .signal_flags { display: none; } - .parameter_annotations { display: none; } - .enum_member_annotations { display: none; } - .struct_member_annotations { display: none; } - .union_member_annotations { display: none; } - /* now that a column is hidden, optimize space */ - col.parameters_name { width: auto; } - col.parameters_description { width: auto; } - col.struct_members_name { width: auto; } - col.struct_members_description { width: auto; } - col.enum_members_name { width: auto; } - col.enum_members_description { width: auto; } - col.union_members_name { width: auto; } - col.union_members_description { width: auto; } -} -@media print { - table.navigation { - visibility: collapse; - display: none; - } - div.titlepage table.navigation { - visibility: visible; - display: table; - background: #e2e2e2; - border: solid 1px #babdb6; - margin-top: 0; - margin-bottom: 0; - top: 0; - left: 0; - height: 3em; - } -} - -.navigation .title -{ - font-size: 120%; -} - div.gallery-float { float: left; @@ -181,7 +60,7 @@ a:hover div.informaltable table { border-collapse: separate; - border-spacing: 20px 3px; + border-spacing: 1em 0.3em; border: none; } @@ -239,6 +118,11 @@ div.informaltable table td, div.informaltable table th color: #729fcf; } +td p +{ + margin: 0.25em; +} + div.table table { border-collapse: collapse; @@ -264,6 +148,8 @@ div.table table th h4 { color: #555753; + margin-top: 1em; + margin-bottom: 1em; } hr @@ -282,17 +168,16 @@ dl.toc dt padding-bottom: 0.25em; } -dl.toc > dd > dl > dt +dl.toc > dt { padding-top: 0.25em; padding-bottom: 0.25em; + font-weight: bold; } -dl.toc > dt +dl.toc > dl { - padding-top: 1em; padding-bottom: 0.5em; - font-weight: bold; } .parameter @@ -404,21 +289,28 @@ h2 .extralinks, h3 .extralinks font-weight: normal; } +acronym,abbr +{ + border-bottom: 1px dotted gray; +} + /* code listings */ -.listing_code .programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ -.listing_code .programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ -.listing_code .programlisting .function { color: #000000; font-weight: bold; } -.listing_code .programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ -.listing_code .programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ +.listing_code .programlisting .normal, +.listing_code .programlisting .normal a, +.listing_code .programlisting .number, +.listing_code .programlisting .cbracket, +.listing_code .programlisting .symbol { color: #555753; } +.listing_code .programlisting .comment, .listing_code .programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ -.listing_code .programlisting .normal { color: #000000; } -.listing_code .programlisting .number { color: #75507b; } /* tango: plum 2 */ +.listing_code .programlisting .function, +.listing_code .programlisting .function a, .listing_code .programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ -.listing_code .programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ -.listing_code .programlisting .type { color: #000000; } -.listing_code .programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ -.listing_code .programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ +.listing_code .programlisting .string { color: #ad7fa8; } /* tango: plum */ +.listing_code .programlisting .keyword, +.listing_code .programlisting .usertype, +.listing_code .programlisting .type, +.listing_code .programlisting .type a { color: #4e9a06; } /* tango: chameleon 3 */ .listing_frame { /* tango:sky blue 1 */ @@ -432,11 +324,6 @@ h2 .extralinks, h3 .extralinks margin-bottom: 0px; padding: 0.5em; } -.listing_lines { - /* this just adds visual clutter and - takes precious room from small screens */ - display: none; -} .listing_lines { /* tango:sky blue 0.5 */ background: #a6c5e3; @@ -459,3 +346,134 @@ h2 .extralinks, h3 .extralinks margin: 0px; } +@media screen { + /* these have a as a first child, but since there are no parent selectors + * we can't use that. */ + a.footnote + { + position: relative; + top: 0em ! important; + } + /* this is needed so that the local anchors are displayed below the naviagtion */ + div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] + { + display: inline-block; + position: relative; + top:-5em; + } + /* this seems to be a bug in the xsl style sheets when generating indexes */ + div.index div.index + { + top: 0em; + } + /* make space for the fixed navigation bar and add space at the bottom so that + * link targets appear somewhat close to top + */ + body + { + padding-top: 2.5em; + padding-bottom: 500px; + max-width: 60em; + } + p + { + max-width: 60em; + } + /* style and size the navigation bar */ + table.navigation#top + { + position: fixed; + background: #e2e2e2; + border-bottom: solid 1px #babdb6; + border-spacing: 5px; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + z-index: 10; + } + table.navigation#top td + { + padding-left: 6px; + padding-right: 6px; + } + .navigation a, .navigation a:visited + { + /* tango:sky blue 3 */ + color: #204a87; + } + .navigation a:hover + { + /* tango:sky blue 2 */ + color: #3465a4; + } + td.shortcuts + { + /* tango:sky blue 2 */ + color: #3465a4; + font-size: 80%; + white-space: nowrap; + } + td.shortcuts .dim + { + color: #babdb6; + } + .navigation .title + { + font-size: 80%; + max-width: none; + margin: 0px; + font-weight: normal; + } +} +@media screen and (min-width: 60em) { + /* screen larger than 60em */ + body { margin: auto; } +} +@media screen and (max-width: 60em) { + /* screen less than 60em */ + #nav_hierarchy { display: none; } + #nav_interfaces { display: none; } + #nav_prerequisites { display: none; } + #nav_derived_interfaces { display: none; } + #nav_implementations { display: none; } + #nav_child_properties { display: none; } + #nav_style_properties { display: none; } + #nav_index { display: none; } + #nav_glossary { display: none; } + .gallery_image { display: none; } + .property_flags { display: none; } + .signal_flags { display: none; } + .parameter_annotations { display: none; } + .enum_member_annotations { display: none; } + .struct_member_annotations { display: none; } + .union_member_annotations { display: none; } + /* now that a column is hidden, optimize space */ + col.parameters_name { width: auto; } + col.parameters_description { width: auto; } + col.struct_members_name { width: auto; } + col.struct_members_description { width: auto; } + col.enum_members_name { width: auto; } + col.enum_members_description { width: auto; } + col.union_members_name { width: auto; } + col.union_members_description { width: auto; } + .listing_lines { display: none; } +} +@media print { + table.navigation { + visibility: collapse; + display: none; + } + div.titlepage table.navigation { + visibility: visible; + display: table; + background: #e2e2e2; + border: solid 1px #babdb6; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + height: 3em; + } +} +