svn: /phpdoc/en/trunk/reference/exif/functions/ exif-tagname.xml

frozenfire Mon, 22 Nov 2010 05:50:53 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=305636 Log: Documented exif_tagname(). Changed paths: U phpdoc/en/trunk/reference/exif/functions/exif-tagname.xml Modified: phpdoc/en/trunk/reference/exif/functions/exif-tagname.xml =================================================================== --- phpdoc/en/trunk/reference/exif/functions/exif-tagname.xml 2010-11-22 05:10:14 UTC (rev 305635) +++ phpdoc/en/trunk/reference/exif/functions/exif-tagname.xml 2010-11-22 05:50:53 UTC (rev 305636) @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<refentry xml:id="function.exif-tagname" xmlns="http://docbook.org/ns/docbook"> +<refentry xml:id="function.exif-tagname" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>exif_tagname</refname> <refpurpose>Get the header name for an index</refpurpose> @@ -11,9 +11,6 @@ <type>string</type><methodname>exif_tagname</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> </methodsynopsis> - - &warn.undocumented.func; - </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -23,7 +20,7 @@ <term><parameter>index</parameter></term> <listitem> <para> - The image index + The Tag ID for which a Tag Name will be looked up. </para> </listitem> </varlistentry> @@ -34,14 +31,39 @@ &reftitle.returnvalues; <para> Returns the header name, or &false; if <parameter>index</parameter> is - undefined. + not a defined EXIF tag id. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>exif_tagname</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo "256: ".exif_tagname(256).PHP_EOL; +echo "257: ".exif_tagname(257).PHP_EOL; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +256: ImageWidth +257: ImageLength +]]> + </screen> + </example> + </para> + </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>exif_imagetype</function></member> + <member><link xlink:href="&url.exifspec;">EXIF Specification</link></member> + <member><link xlink:href="http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/EXIF.html">EXIF Tags</link></member> </simplelist> </para> </refsect1>