diff options
Diffstat (limited to 'doc/manual-html/gimpprint_18.html')
| -rw-r--r-- | doc/manual-html/gimpprint_18.html | 156 |
1 files changed, 156 insertions, 0 deletions
diff --git a/doc/manual-html/gimpprint_18.html b/doc/manual-html/gimpprint_18.html new file mode 100644 index 0000000..96bc5a4 --- /dev/null +++ b/doc/manual-html/gimpprint_18.html @@ -0,0 +1,156 @@ +<HTML> +<HEAD> +<!-- This HTML file has been created by texi2html 1.51 + from .././gimpprint.texi on 11 June 2004 --> + +<TITLE>GIMP-Print - Version functions</TITLE> +</HEAD> +<BODY> +Go to the <A HREF="gimpprint_1.html">first</A>, <A HREF="gimpprint_17.html">previous</A>, <A HREF="gimpprint_19.html">next</A>, <A HREF="gimpprint_47.html">last</A> section, <A HREF="gimpprint_toc.html">table of contents</A>. +<P><HR><P> + + +<H2><A NAME="SEC23" HREF="gimpprint_toc.html#TOC23">4.8 Version functions</A></H2> +<P> +<A NAME="IDX159"></A> + +</P> +<P> +<DL> +<DT><U>Function:</U> const char * <B>stp_check_version</B> <I>(unsigned int <VAR>required_major</VAR>,</I> +<DD><A NAME="IDX160"></A> +unsigned int <VAR>required_minor</VAR>, unsigned int <VAR>required_micro</VAR>) + +</P> +<P> +This function checks whether the version of libgimpprint that the program +is linked with is equal to the version number passed to it. If the version +is the same, the function returns <CODE>NULL</CODE>. If any of the version +numbers do not match (i.e. the library version is too old or too new), a string containing a desription of the difference is +returned. The first error found is returned. The function checks in the order +major, minor, micro. +</DL> + +</P> + + +<H3><A NAME="SEC24" HREF="gimpprint_toc.html#TOC24">4.8.1 Version macros</A></H3> + +<P> +<DL> +<DT><U>Macro:</U> <B>GIMPPRINT_CHECK_VERSION</B> <I>(major,minor,micro)</I> +<DD><A NAME="IDX161"></A> + +</P> +<P> +This macro returns zero if the version of the libgimpprint headers are +greater or equal to the version given as an argument. It returns nonzero +if the version of the libgimpprint headers are less than the argument. +</DL> + +</P> +<P> +<DL> +<DT><U>Macro:</U> <B>GIMPPRINT_MAJOR_VERSION</B> +<DD><A NAME="IDX162"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Macro:</U> <B>GIMPPRINT_MINOR_VERSION</B> +<DD><A NAME="IDX163"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Macro:</U> <B>GIMPPRINT_MICRO_VERSION</B> +<DD><A NAME="IDX164"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Macro:</U> <B>GIMPPRINT_CURRENT_INTERFACE</B> +<DD><A NAME="IDX165"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Macro:</U> <B>GIMPPRINT_BINARY_AGE</B> +<DD><A NAME="IDX166"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Macro:</U> <B>GIMPPRINT_INTERFACE_AGE</B> +<DD><A NAME="IDX167"></A> +</DL> + +</P> +<P> +These macros are integers holding the version numbers. They should be +used for compile-time checking only. To check version numbers at +run-time, use the equivalent variables. Note that at present (4.1.x +development branch) the library interface version numbers are not used. + +</P> + + +<H3><A NAME="SEC25" HREF="gimpprint_toc.html#TOC25">4.8.2 Version variables</A></H3> + +<P> +<DL> +<DT><U>Variable:</U> const unsigned int <B>gimpprint_major_version</B> +<DD><A NAME="IDX168"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Variable:</U> const unsigned int <B>gimpprint_minor_version</B> +<DD><A NAME="IDX169"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Variable:</U> const unsigned int <B>gimpprint_micro_version</B> +<DD><A NAME="IDX170"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Variable:</U> const unsigned int <B>gimpprint_current_interface</B> +<DD><A NAME="IDX171"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Variable:</U> const unsigned int <B>gimpprint_binary_age</B> +<DD><A NAME="IDX172"></A> +</DL> + +</P> +<P> +<DL> +<DT><U>Variable:</U> const unsigned int <B>gimpprint_interface_age</B> +<DD><A NAME="IDX173"></A> +</DL> + +</P> +<P> +These variables hold the library version numbers. Because the version of +the library may change on a system using shared libraries, these should +be used instead of the equivalent macros when checking the library +version at run-time. Note that library interface version numbers are not +used in the development branch, but are in the stable branch. +<P><HR><P> +Go to the <A HREF="gimpprint_1.html">first</A>, <A HREF="gimpprint_17.html">previous</A>, <A HREF="gimpprint_19.html">next</A>, <A HREF="gimpprint_47.html">last</A> section, <A HREF="gimpprint_toc.html">table of contents</A>. +</BODY> +</HTML> |