Adjust formatting of namespace docs.

include/asset.hpp

@@ -15,8 +15,7 @@ struct Module;
 } // namespace engine
 
 
-/** Handles common path locations.
-*/
+/** Handles common path locations */
 namespace asset {
 
 

include/audio.hpp

@@ -8,10 +8,7 @@
 #include <context.hpp>
 
 namespace rack {
-
-
-/** Abstraction for all audio drivers in Rack
-*/
+/** Abstraction for all audio drivers in Rack */
 namespace audio {
 
 

include/color.hpp

@@ -6,9 +6,7 @@
 
 
 namespace rack {
-
-/** Utilities for `NVGcolor`
-*/
+/** Utilities for `NVGcolor` */
 namespace color {
 
 

include/common.hpp

@@ -161,8 +161,7 @@ namespace std {
 #endif
 
 
-/** Root namespace for the Rack API
-*/
+/** Root namespace for the Rack API */
 namespace rack {
 
 

include/discord.hpp

@@ -1,10 +1,9 @@
 #pragma once
 #include <common.hpp>
 
-namespace rack {
 
-/** Updates Discord "now playing" status with IPC
-*/
+namespace rack {
+/** Updates Discord "now playing" status with IPC */
 namespace discord {
 
 

include/gamepad.hpp

@@ -3,10 +3,7 @@
 
 
 namespace rack {
-
-
-/** Gamepad/joystick/controller MIDI driver
-*/
+/** Gamepad/joystick/controller MIDI driver */
 namespace gamepad {
 
 

include/history.hpp

@@ -19,8 +19,7 @@ struct CableWidget;
 } // namespace app
 
 
-/** Action history for UI undo/redo
-*/
+/** Action history for UI undo/redo */
 namespace history {
 
 

include/keyboard.hpp

@@ -4,10 +4,7 @@
 
 
 namespace rack {
-
-
-/** Computer keyboard MIDI driver
-*/
+/** Computer keyboard MIDI driver */
 namespace keyboard {
 
 

include/library.hpp

@@ -5,10 +5,7 @@
 
 
 namespace rack {
-
-
-/** Synchronizes plugins with the VCV Library and handles VCV accounts with the vcvrack.com API
-*/
+/** Synchronizes plugins with the VCV Library and handles VCV accounts with the vcvrack.com API */
 namespace library {
 
 

include/logger.hpp

@@ -16,10 +16,7 @@ will print something like
 
 
 namespace rack {
-
-
-/** Logs messages to a file or the terminal
-*/
+/** Logs messages to a file or the terminal */
 namespace logger {
 
 

include/math.hpp

@@ -6,10 +6,7 @@
 
 
 namespace rack {
-
-
-/** Extends `<cmath>` with extra functions and types
-*/
+/** Extends `<cmath>` with extra functions and types */
 namespace math {
 
 

include/midi.hpp

@@ -9,10 +9,7 @@
 
 
 namespace rack {
-
-
-/** Abstraction for all MIDI drivers in Rack
-*/
+/** Abstraction for all MIDI drivers in Rack */
 namespace midi {
 
 

include/network.hpp

@@ -7,10 +7,7 @@
 
 
 namespace rack {
-
-
-/** Networking functions for HTTP requests, downloads, and URLs
-*/
+/** Networking functions for HTTP requests, downloads, and URLs */
 namespace network {
 
 

include/patch.hpp

@@ -5,6 +5,7 @@
 
 
 namespace rack {
+/** Handles the Rack patch file state */
 namespace patch {
 
 

include/plugin.hpp

@@ -7,10 +7,7 @@
 
 
 namespace rack {
-
-
-/** Loads and manages Rack plugins
-*/
+/** Loads and manages Rack plugins */
 namespace plugin {
 
 

include/random.hpp

@@ -5,10 +5,7 @@
 
 
 namespace rack {
-
-
-/** Random number generation
-*/
+/** Random number generation */
 namespace random {
 
 

include/settings.hpp

@@ -13,10 +13,7 @@
 
 
 namespace rack {
-
-
-/** Process-scope globals, most of which are persisted to a file
-*/
+/** Process-scope globals, most of which are persisted across launches */
 namespace settings {
 
 

include/string.hpp

@@ -6,10 +6,7 @@
 
 
 namespace rack {
-
-
-/** Supplemental `std::string` functions
-*/
+/** Supplemental `std::string` functions */
 namespace string {
 
 

include/system.hpp

@@ -5,10 +5,7 @@
 
 
 namespace rack {
-
-
-/** Cross-platform functions for operating system, file path, and filesystem routines
-*/
+/** Cross-platform functions for OS, file path, and filesystem routines */
 namespace system {
 
 

include/tag.hpp

@@ -5,8 +5,7 @@
 
 
 namespace rack {
-/** Tags describing the functions of modules
-*/
+/** Tags describing the function(s) of modules */
 namespace tag {
 
 

include/weakptr.hpp

@@ -12,8 +12,7 @@ struct WeakHandle {
 };
 
 
-/** Base class for classes that allow `WeakPtr`s to be used.
-*/
+/** Base class for classes that allow `WeakPtr`s to be used. */
 struct WeakBase {
 	WeakHandle* weakHandle = nullptr;
 

include/widget/SvgWidget.hpp

@@ -6,7 +6,7 @@ namespace rack {
 namespace widget {
 
 
-/** Draws an Svg */
+/** Owns and draws a window::Svg */
 struct SvgWidget : Widget {
 	std::shared_ptr<window::Svg> svg;
 

include/widget/Widget.hpp

@@ -10,10 +10,7 @@
 
 
 namespace rack {
-
-
-/** Basic UI widget types
-*/
+/** Base UI widget types */
 namespace widget {
 
 
@@ -469,7 +466,7 @@ struct Widget : WeakBase {
 		recurseEvent(&Widget::onHide, e);
 	}
 
-	/** Occurs after the Window, OpenGL context, and Nanovg are created.
+	/** Occurs after the Window (including OpenGL and NanoVG contexts) are created.
 	Recurses.
 	*/
 	struct ContextCreateEvent : BaseEvent {
@@ -479,7 +476,7 @@ struct Widget : WeakBase {
 		recurseEvent(&Widget::onContextCreate, e);
 	}
 
-	/** Occurs before the Window, OpenGL context, and Nanovg are destroyed.
+	/** Occurs before the Window (including OpenGL and NanoVG contexts) are destroyed.
 	Recurses.
 	*/
 	struct ContextDestroyEvent : BaseEvent {

include/window/Svg.hpp

@@ -36,6 +36,7 @@ inline math::Vec mm2px(math::Vec mm) {
 }
 
 
+/** Scalable Vector Graphics document */
 struct Svg {
 	NSVGimage* handle = NULL;