From d99c378bdcbc80d6108003141cc2c7a2b4264bbb Mon Sep 17 00:00:00 2001
From: Stephen Gold <sgold@sonic.net>
Date: Sat, 18 Apr 2020 13:25:44 -0700
Subject: [PATCH] add missing javadoc tags to BufferUtils

---
 jme3-core/src/main/java/com/jme3/util/BufferUtils.java | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/jme3-core/src/main/java/com/jme3/util/BufferUtils.java b/jme3-core/src/main/java/com/jme3/util/BufferUtils.java
index c81926f91..e592ba387 100644
--- a/jme3-core/src/main/java/com/jme3/util/BufferUtils.java
+++ b/jme3-core/src/main/java/com/jme3/util/BufferUtils.java
@@ -144,6 +144,7 @@ public final class BufferUtils {
      *
      * @param data
      *            array of Vector3f objects to place into a new FloatBuffer
+     * @return a new direct, flipped FloatBuffer, or null if data was null
      */
     public static FloatBuffer createFloatBuffer(Vector3f... data) {
         if (data == null) {
@@ -167,6 +168,7 @@ public final class BufferUtils {
      *
      * @param data
      *            array of Quaternion objects to place into a new FloatBuffer
+     * @return a new direct, flipped FloatBuffer, or null if data was null
      */
     public static FloatBuffer createFloatBuffer(Quaternion... data) {
         if (data == null) {
@@ -190,6 +192,7 @@ public final class BufferUtils {
      *
      * @param data
      *            array of Vector4 objects to place into a new FloatBuffer
+     * @return a new direct, flipped FloatBuffer, or null if data was null
      */
     public static FloatBuffer createFloatBuffer(Vector4f... data) {
         if (data == null) {
@@ -213,6 +216,7 @@ public final class BufferUtils {
      *
      * @param data
      *            array of ColorRGBA objects to place into a new FloatBuffer
+     * @return a new direct, flipped FloatBuffer, or null if data was null
      */
     public static FloatBuffer createFloatBuffer(ColorRGBA... data) {
         if (data == null) {
@@ -235,6 +239,7 @@ public final class BufferUtils {
      *
      * @param data
      *            array of float primitives to place into a new FloatBuffer
+     * @return a new direct, flipped FloatBuffer, or null if data was null
      */
     public static FloatBuffer createFloatBuffer(float... data) {
         if (data == null) {
@@ -524,6 +529,7 @@ public final class BufferUtils {
      *
      * @param data
      *            array of Vector2f objects to place into a new FloatBuffer
+     * @return a new direct, flipped FloatBuffer, or null if data was null
      */
     public static FloatBuffer createFloatBuffer(Vector2f... data) {
         if (data == null) {
@@ -730,6 +736,7 @@ public final class BufferUtils {
      *
      * @param data
      *            array of ints to place into a new IntBuffer
+     * @return a new direct, flipped IntBuffer, or null if data was null
      */
     public static IntBuffer createIntBuffer(int... data) {
         if (data == null) {
@@ -1269,6 +1276,8 @@ public final class BufferUtils {
      * and cleans the direct buffers. However, as this doesn't happen
      * immediately after discarding all references to a direct buffer, it's easy
      * to OutOfMemoryError yourself using direct buffers.
+     *
+     * @param toBeDestroyed the buffer to de-allocate (not null)
      */
     public static void destroyDirectBuffer(Buffer toBeDestroyed) {
         if (!isDirect(toBeDestroyed)) {