<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://jogamp.org/bugzilla/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.2"
          urlbase="https://jogamp.org/bugzilla/"
          
          maintainer="sgothel@jausoft.com"
>

    <bug>
          <bug_id>321</bug_id>
          
          <creation_ts>2007-10-09 03:18:30 +0200</creation_ts>
          <short_desc>GL doc could be improved</short_desc>
          <delta_ts>2015-09-27 03:15:01 +0200</delta_ts>
          <reporter_accessible>0</reporter_accessible>
          <cclist_accessible>0</cclist_accessible>
          <classification_id>3</classification_id>
          <classification>JogAmp</classification>
          <product>Jogl</product>
          <component>core</component>
          <version>1</version>
          <rep_platform>All</rep_platform>
          <op_sys>all</op_sys>
          <bug_status>VERIFIED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P5</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Sven Gothel">sgothel</reporter>
          <assigned_to name="Michael Bien">bienator</assigned_to>
          
          
          <cf_type>FEATURE</cf_type>
          <cf_scm_refs></cf_scm_refs>
          <cf_workaround>---</cf_workaround>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>337</commentid>
    <comment_count>0</comment_count>
    <who name="Sven Gothel">sgothel</who>
    <bug_when>2010-03-24 07:50:53 +0100</bug_when>
    <thetext>


---- Reported by mbien@fh-landshut.de 2007-10-09 15:18:30 ----

The GL interface doc could be improved by adding additional to  &quot;Entry point
(through function pointer) to C language function: ...&quot; the doc inside the
OpenGL reference pages (http://www.opengl.org/sdk/docs/man/) for each method.



---- Additional Comments From kbr 2007-10-09 18:37:13 ----

This is already done for some of the API entry points. See
jogl/make/native-taglet.properties. Please contribute to the project by
expanding the set of functions for which these links are generated.




---- Additional Comments From mbien@fh-landshut.de 2007-10-10 09:26:47 ----

ah I see, the native-taglet.properties seems to be complete. But currently just
the function headers like void &quot;glAccum(GLenum op, GLfloat value);&quot; are added to
the doc. What about the rest like Parameters, Description, Notes, Errors...? The
important stuff is missing.



---- Additional Comments From kbr 2007-10-10 09:31:23 ----

These are things that could plausibly be added to the native taglet. The source
code to it is in the GlueGen workspace under src/java/net/highteq/nativetaglet/
. The code which produced the native-taglet.properties (which, by the way, isn&apos;t
complete -- it only has links for the core OpenGL functions) is I believe in the
GlueGen workspace under make/lib/JOGLDocLinksGeneratorAndLibs.jar .

Any contributions you could make in this area would be welcome.




--- Bug imported by sgothel@jausoft.com 2010-03-24 07:50 EDT  ---

This bug was previously known as _bug_ 321 at https://jogl.dev.java.net/bugs/show_bug.cgi?id=321
</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>