~ubuntu-branches/ubuntu/trusty/khronos-opencl-man/trusty

« back to all changes in this revision

Viewing changes to fma.xml

  • Committer: Package Import Robot
  • Author(s): Mathieu Malaterre
  • Date: 2013-05-21 18:06:15 UTC
  • Revision ID: package-import@ubuntu.com-20130521180615-6e0s2n3pai95ip2f
Tags: upstream-1.0~svn21772
ImportĀ upstreamĀ versionĀ 1.0~svn21772

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
 
3
              "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd" [
 
4
<!ENTITY mathFunctionsInc SYSTEM "mathFunctionsInc.xml">
 
5
]>
 
6
 
 
7
<refentry>
 
8
    <refentryinfo>
 
9
        <keywordset>
 
10
            <keyword>fma</keyword>
 
11
        </keywordset>
 
12
    </refentryinfo>
 
13
 
 
14
    <refmeta>
 
15
        <refentrytitle>fma</refentrytitle>
 
16
 
 
17
        <refmiscinfo>
 
18
            <copyright>
 
19
                <year>2007-2011</year>
 
20
                <holder>The Khronos Group Inc.
 
21
 Permission is hereby granted, free of charge, to any person obtaining a
 
22
copy of this software and/or associated documentation files (the
 
23
"Materials"), to deal in the Materials without restriction, including
 
24
without limitation the rights to use, copy, modify, merge, publish,
 
25
distribute, sublicense, and/or sell copies of the Materials, and to
 
26
permit persons to whom the Materials are furnished to do so, subject to
 
27
the condition that this copyright notice and permission notice shall be included
 
28
in all copies or substantial portions of the Materials.</holder>
 
29
            </copyright>
 
30
        </refmiscinfo>
 
31
        <manvolnum>3</manvolnum>
 
32
    </refmeta>
 
33
 
 
34
<!-- ================================ SYNOPSIS -->
 
35
 
 
36
    <refnamediv id="fma">
 
37
        <refname>fma</refname>
 
38
 
 
39
        <refpurpose>
 
40
            Multiply and add, then round.
 
41
        </refpurpose>
 
42
    </refnamediv>
 
43
 
 
44
    <refsynopsisdiv xmlns:xlink="http://www.w3.org/1999/xlink"><title></title>
 
45
        <funcsynopsis>
 
46
            <funcprototype>
 
47
                <funcdef>
 
48
                    gentype
 
49
                    <function>
 
50
                        fma
 
51
                    </function>
 
52
                </funcdef>
 
53
                <paramdef>gentype<parameter>a</parameter></paramdef>
 
54
                <paramdef>gentype<parameter>b</parameter></paramdef>
 
55
                <paramdef>gentype<parameter>c</parameter></paramdef>
 
56
            </funcprototype>
 
57
        </funcsynopsis>
 
58
    </refsynopsisdiv>
 
59
 
 
60
<!-- ================================ DESCRIPTION  -->
 
61
 
 
62
    <refsect1 id="description"><title>Description</title>
 
63
        <para>
 
64
          Returns the correctly rounded floating-point representation of the sum of
 
65
          <varname>c</varname> with the infinitely precise product of <varname>a</varname>
 
66
          and <varname>b</varname>. Rounding of intermediate products shall not occur. Edge
 
67
          case behavior is per the IEEE 754-2008 standard.
 
68
        </para>
 
69
    </refsect1>
 
70
 
 
71
<!-- ================================ NOTES  -->
 
72
 
 
73
    <refsect1 id="notes"><title>Notes</title>
 
74
 
 
75
        &mathFunctionsInc;
 
76
 
 
77
    </refsect1>
 
78
 
 
79
<!-- ================================ EXAMPLE  -->
 
80
<!-- DO NOT DELETE IN CASE AN EXAMPLE IS ADDED IN THE FUTURE -->
 
81
<!--
 
82
    <refsect2 id="example1">
 
83
        <title>
 
84
            Example
 
85
        </title>
 
86
 
 
87
        <informaltable frame="none">
 
88
            <tgroup cols="1" align="left" colsep="0" rowsep="0">
 
89
                <colspec colname="col1" colnum="1" />
 
90
                <tbody>
 
91
                    <row>
 
92
                        <entry>
 
93
                            Example goes here - it will be set in "code" type with white space preserved.
 
94
                        </entry>
 
95
                    </row>
 
96
                </tbody>
 
97
            </tgroup>
 
98
        </informaltable>
 
99
    </refsect2>
 
100
-->
 
101
 
 
102
<!-- ================================ SPECIFICATION  -->
 
103
<!-- Set the "uri" attribute in the <olink /> element to the "named destination" for the PDF page
 
104
-->
 
105
    <refsect1 id="specification"><title>Specification</title>
 
106
        <para>
 
107
            <imageobject>
 
108
                <imagedata fileref="pdficon_small1.gif" format="gif" />
 
109
            </imageobject>
 
110
 
 
111
            <olink uri="mathFunctions">OpenCL Specification</olink>
 
112
        </para>
 
113
    </refsect1>
 
114
 
 
115
<!-- ================================ ALSO SEE  -->
 
116
 
 
117
    <refsect1 id="seealso"><title>Also see</title>
 
118
        <para>
 
119
            <citerefentry href="mathFunctions"><refentrytitle>Math Functions</refentrytitle></citerefentry>,
 
120
            <citerefentry><refentrytitle>FP_CONTRACT</refentrytitle></citerefentry>,
 
121
            <citerefentry href="FP_CONTRACT"><refentrytitle>FP_FAST_FMA</refentrytitle></citerefentry>
 
122
        </para>
 
123
    </refsect1>
 
124
 
 
125
<!-- ============================== COPYRIGHT -->
 
126
<!-- Content included from copyright.inc.xsl -->
 
127
 
 
128
    <refsect3 id="Copyright"><title></title>
 
129
        <imageobject>
 
130
                <imagedata fileref="KhronosLogo.jpg" format="jpg" />
 
131
        </imageobject>
 
132
        <para />
 
133
    </refsect3>
 
134
 
 
135
<!-- 17-Oct-2011 -->
 
136
</refentry>
 
137