rename upstream-man-pages to upstream-doc
[clinton/guile-figl.git] / upstream-doc / manglsl / log2.xml
CommitLineData
7faf1d71
AW
1<?xml version="1.0" encoding="UTF-8"?>\r
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"\r
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">\r
4<refentry id="log2">\r
5 <refmeta>\r
6 <refmetainfo>\r
7 <copyright>\r
8 <year>2011</year>\r
9 <holder>Khronos Group</holder>\r
10 </copyright>\r
11 </refmetainfo>\r
12 <refentrytitle>log2</refentrytitle>\r
13 <manvolnum>3G</manvolnum>\r
14 </refmeta>\r
15 <refnamediv>\r
16 <refname>log2</refname>\r
17 <refpurpose>return the base 2 logarithm of the parameter</refpurpose>\r
18 </refnamediv>\r
19 <refsynopsisdiv><title>Declaration</title>\r
20 <funcsynopsis>\r
21 <funcprototype>\r
22 <funcdef>genType <function>log2</function></funcdef>\r
23 <paramdef>genType <parameter>x</parameter></paramdef>\r
24 </funcprototype>\r
25 </funcsynopsis>\r
26 </refsynopsisdiv>\r
27 <refsect1 id="parameters"><title>Parameters</title>\r
28 <variablelist>\r
29 <varlistentry>\r
30 <term><parameter>x</parameter></term>\r
31 <listitem>\r
32 <para>\r
33 Specify the value of which to take the base 2 logarithm.\r
34 </para>\r
35 </listitem>\r
36 </varlistentry>\r
37 </variablelist>\r
38 </refsect1>\r
39 <refsect1 id="description"><title>Description</title>\r
40 <para>\r
41 <function>log2</function> returns the base 2 logarithm of <parameter>x</parameter>. i.e., the value\r
42 <inlineequation><mml:math><mml:mi>y</mml:mi></mml:math></inlineequation> which satisfies\r
43 <inlineequation><mml:math><mml:apply><mml:eq /><mml:mi>x</mml:mi><mml:mrow><mml:msup><mml:mi>2</mml:mi><mml:mi>y</mml:mi></mml:msup></mml:mrow></mml:apply></mml:math></inlineequation>.\r
44 Results are undefined if <inlineequation><mml:math><mml:apply><mml:leq /><mml:mi>x</mml:mi><mml:mn>0</mml:mn></mml:apply></mml:math></inlineequation>.\r
45 </para>\r
46 </refsect1>\r
47 <refsect1 id="versions"><title>Version Support</title>\r
48 <informaltable frame="topbot">\r
49 #VARTABLECOLS#\r
50 <thead>\r
51 #FUNCTABLEHEADER#\r
52 <row>\r
53 <entry>log2</entry>#newin11#\r
54 </row>\r
55 </thead>\r
56 </tgroup>\r
57 </informaltable>\r
58 </refsect1>\r
59 <refsect1 id="seealso"><title>See Also</title>\r
60 <para>\r
61 <citerefentry><refentrytitle>exp</refentrytitle></citerefentry>,\r
62 <citerefentry><refentrytitle>log</refentrytitle></citerefentry>,\r
63 <citerefentry><refentrytitle>exp2</refentrytitle></citerefentry>\r
64 </para>\r
65 </refsect1>\r
66 <refsect1 id="Copyright"><title>Copyright</title>\r
67 <para>\r
68 Copyright <trademark class="copyright"></trademark> 2011 Khronos Group. \r
69 This material may be distributed subject to the terms and conditions set forth in \r
70 the Open Publication License, v 1.0, 8 June 1999.\r
71 <ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
72 </para>\r
73 </refsect1>\r
74</refentry>\r