[vlc-commits] opengl: clarify comments

[Zhao Zhili]

vlc | branch: master | Zhao Zhili <quinkblack at foxmail.com> | Mon Apr 16 20:13:51 2018 +0800| [a060f674757c55ac407d2488acb6a01ed707151c] | committer: Thomas Guillem

opengl: clarify comments

Signed-off-by: Thomas Guillem <thomas at gllm.fr>

> http://git.videolan.org/gitweb.cgi/vlc.git/?a=commit;h=a060f674757c55ac407d2488acb6a01ed707151c
---

 modules/video_output/opengl/converter.h | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/modules/video_output/opengl/converter.h b/modules/video_output/opengl/converter.h
index 470758e876..b1a18f7fdd 100644
--- a/modules/video_output/opengl/converter.h
+++ b/modules/video_output/opengl/converter.h
@@ -341,7 +341,7 @@ struct opengl_tex_converter_t
     /* Private context */
     void *priv;
 
-    /*
+    /**
      * Callback to allocate data for bound textures
      *
      * This function pointer can be NULL. Software converters should call
@@ -349,7 +349,7 @@ struct opengl_tex_converter_t
      * caller when calling glDeleteTextures()). Won't be called if
      * handle_texs_gen is true.
      *
-     * \param fc OpenGL tex converter
+     * \param tc OpenGL tex converter
      * \param textures array of textures to bind (one per plane)
      * \param tex_width array of tex width (one per plane)
      * \param tex_height array of tex height (one per plane)
@@ -358,26 +358,26 @@ struct opengl_tex_converter_t
     int (*pf_allocate_textures)(const opengl_tex_converter_t *tc, GLuint *textures,
                                 const GLsizei *tex_width, const GLsizei *tex_height);
 
-    /*
+    /**
      * Callback to allocate a picture pool
      *
      * This function pointer *can* be NULL. If NULL, A generic pool with
      * pictures allocated from the video_format_t will be used.
      *
-     * \param fc OpenGL tex converter
+     * \param tc OpenGL tex converter
      * \param requested_count number of pictures to allocate
      * \return the picture pool or NULL in case of error
      */
-    picture_pool_t *(*pf_get_pool)(const opengl_tex_converter_t *fc,
+    picture_pool_t *(*pf_get_pool)(const opengl_tex_converter_t *tc,
                                    unsigned requested_count);
 
-    /*
+    /**
      * Callback to update a picture
      *
      * This function pointer cannot be NULL. The implementation should upload
      * every planes of the picture.
      *
-     * \param fc OpenGL tex converter
+     * \param tc OpenGL tex converter
      * \param textures array of textures to bind (one per plane)
      * \param tex_width array of tex width (one per plane)
      * \param tex_height array of tex height (one per plane)
@@ -386,39 +386,39 @@ struct opengl_tex_converter_t
      * (one per plane, can be NULL)
      * \return VLC_SUCCESS or a VLC error
      */
-    int (*pf_update)(const opengl_tex_converter_t *fc, GLuint *textures,
+    int (*pf_update)(const opengl_tex_converter_t *tc, GLuint *textures,
                      const GLsizei *tex_width, const GLsizei *tex_height,
                      picture_t *pic, const size_t *plane_offset);
 
-    /*
+    /**
      * Callback to fetch locations of uniform or attributes variables
      *
      * This function pointer cannot be NULL. This callback is called one time
      * after init.
      *
-     * \param fc OpenGL tex converter
+     * \param tc OpenGL tex converter
      * \param program linked program that will be used by this tex converter
      * \return VLC_SUCCESS or a VLC error
      */
-    int (*pf_fetch_locations)(opengl_tex_converter_t *fc, GLuint program);
+    int (*pf_fetch_locations)(opengl_tex_converter_t *tc, GLuint program);
 
-    /*
+    /**
      * Callback to prepare the fragment shader
      *
      * This function pointer cannot be NULL. This callback can be used to
      * specify values of uniform variables.
      *
-     * \param fc OpenGL tex converter
+     * \param tc OpenGL tex converter
      * \param tex_width array of tex width (one per plane)
      * \param tex_height array of tex height (one per plane)
      * \param alpha alpha value, used only for RGBA fragment shader
      */
-    void (*pf_prepare_shader)(const opengl_tex_converter_t *fc,
+    void (*pf_prepare_shader)(const opengl_tex_converter_t *tc,
                               const GLsizei *tex_width, const GLsizei *tex_height,
                               float alpha);
 };
 
-/*
+/**
  * Generate a fragment shader
  *
  * This utility function can be used by hw opengl tex converters that need a