Fix JavaDoc 21 warning and clean up generated files

JavaDoc 21 warns about missing docs for implicit constructors. `<cstdint>` was replaced with `<stdint.h>` because the latter provides the typedefs without the `std::` prefix. Using `<cstdint>` for it is UB.
SleipnirGroup · Feb 23, 2025 · 9501324 · 9501324
1 parent 4d82133
commit 9501324
Show file tree

Hide file tree

Showing 5 changed files with 18 additions and 1 deletion.
diff --git a/choreolib/src/main/java/choreo/util/TrajSchemaVersion.java b/choreolib/src/main/java/choreo/util/TrajSchemaVersion.java
@@ -1,10 +1,14 @@
 // Copyright (c) Choreo contributors
 
 // Auto-generated by update_traj_schema.py
+
 package choreo.util;
 
 /** Internal autogenerated class for storing the current trajectory schema version. */
 public class TrajSchemaVersion {
   /** The current trajectory schema version. */
   public static final int TRAJ_SCHEMA_VERSION = 1;
+
+  /** Utility class. */
+  private TrajSchemaVersion() {}
 }
diff --git a/choreolib/src/main/native/include/choreo/util/TrajSchemaVersion.h b/choreolib/src/main/native/include/choreo/util/TrajSchemaVersion.h
@@ -1,11 +1,15 @@
 // Copyright (c) Choreo contributors
 
 // Auto-generated by update_traj_schema.py
+
 #pragma once
+
 #include <stdint.h>
 
 namespace choreo {
+
 [[deprecated("Use kTrajSchemaVersion.")]]
 inline constexpr uint32_t kTrajSpecVersion = 1;
 inline constexpr uint32_t kTrajSchemaVersion = 1;
+
 }  // namespace choreo
diff --git a/update_field_dimensions.py b/update_field_dimensions.py
diff --git a/update_project_schema.py b/update_project_schema.py
diff --git a/update_traj_schema.py b/update_traj_schema.py
@@ -39,12 +39,16 @@ class Location:
         template=lambda version: f"""// Copyright (c) Choreo contributors
 
 // Auto-generated by update_traj_schema.py
+
 package choreo.util;
 
 /** Internal autogenerated class for storing the current trajectory schema version. */
 public class TrajSchemaVersion {{
   /** The current trajectory schema version. */
   public static final int TRAJ_SCHEMA_VERSION = {version};
+
+  /** Utility class. */
+  private TrajSchemaVersion() {{}}
 }}""",
     ),
     # Python ChoreoLib
@@ -61,12 +65,17 @@ class Location:
         template=lambda version: f"""// Copyright (c) Choreo contributors
 
 // Auto-generated by update_traj_schema.py
+
 #pragma once
-#include <cstdint>
+
+#include <stdint.h>
+
 namespace choreo {{
+
 [[deprecated("Use kTrajSchemaVersion.")]]
 inline constexpr uint32_t kTrajSpecVersion = {version};
 inline constexpr uint32_t kTrajSchemaVersion = {version};
+
 }}  // namespace choreo""",
     ),
 ]