Remove useless doc comments

7 files changed, 4 insertions, 33 deletions

diff --git a/src/AlsaDriver.cpp b/src/AlsaDriver.cpp
index a132d54..89ef94e 100644
--- a/src/AlsaDriver.cpp
+++ b/src/AlsaDriver.cpp
@@ -54,7 +54,6 @@ AlsaDriver::~AlsaDriver()
 	detach();
 }
 
-/** Attach to ALSA. */
 void
 AlsaDriver::attach(bool /*launch_daemon*/)
 {
@@ -100,8 +99,6 @@ is_alsa_port(const PatchagePort* port)
 	return port->type() == PortType::alsa_midi;
 }
 
-/** Destroy all JACK (canvas) ports.
- */
 void
 AlsaDriver::destroy_all()
 {
@@ -110,8 +107,6 @@ AlsaDriver::destroy_all()
 	_port_addrs.clear();
 }
 
-/** Refresh all Alsa Midi ports and connections.
- */
 void
 AlsaDriver::refresh()
 {
@@ -402,10 +397,6 @@ AlsaDriver::ignore(const snd_seq_addr_t& addr, bool add)
 	return false;
 }
 
-/** Connects two Alsa Midi ports.
- *
- * \return Whether connection succeeded.
- */
 bool
 AlsaDriver::connect(const PortID tail_id, const PortID head_id)
 {
@@ -460,10 +451,6 @@ AlsaDriver::connect(const PortID tail_id, const PortID head_id)
 	return (!result);
 }
 
-/** Disconnects two Alsa Midi ports.
- *
- * \return Whether disconnection succeeded.
- */
 bool
 AlsaDriver::disconnect(const PortID tail_id, const PortID head_id)
 {
diff --git a/src/AlsaDriver.hpp b/src/AlsaDriver.hpp
index 2680509..33d8542 100644
--- a/src/AlsaDriver.hpp
+++ b/src/AlsaDriver.hpp
@@ -33,8 +33,7 @@ class ILog;
 class Patchage;
 class PatchagePort;
 
-/** Handles all externally driven functionality, registering ports etc.
- */
+/// Driver for ALSA Sequencer ports
 class AlsaDriver : public Driver
 {
 public:
diff --git a/src/Driver.hpp b/src/Driver.hpp
index 5a9883c..664ed94 100644
--- a/src/Driver.hpp
+++ b/src/Driver.hpp
@@ -26,7 +26,7 @@
 class PatchagePort;
 class PatchageCanvas;
 
-/** Trival driver base class */
+/// Base class for drivers that handle system clients and ports
 class Driver
 {
 public:
diff --git a/src/JackDbusDriver.cpp b/src/JackDbusDriver.cpp
index 855acf8..25ba144 100644
--- a/src/JackDbusDriver.cpp
+++ b/src/JackDbusDriver.cpp
@@ -96,8 +96,6 @@ is_jack_port(const PatchagePort* port)
 	       port->type() == PortType::jack_midi;
 }
 
-/** Destroy all JACK (canvas) ports.
- */
 void
 JackDriver::destroy_all()
 {
@@ -152,7 +150,6 @@ JackDriver::on_jack_disappeared()
 	_server_started = false;
 }
 
-/** Handle signals we have subscribed for in attach(). */
 DBusHandlerResult
 JackDriver::dbus_message_hook(DBusConnection* /*connection*/,
                               DBusMessage* message,
diff --git a/src/JackDriver.cpp b/src/JackDriver.cpp
index 8127f42..b1cf0aa 100644
--- a/src/JackDriver.cpp
+++ b/src/JackDriver.cpp
@@ -61,8 +61,6 @@ JackDriver::~JackDriver()
 	detach();
 }
 
-/** Connect to Jack.
- */
 void
 JackDriver::attach(bool launch_daemon)
 {
@@ -126,8 +124,6 @@ is_jack_port(const PatchagePort* port)
 	        port->type() == PortType::jack_cv);
 }
 
-/** Destroy all JACK (canvas) ports.
- */
 void
 JackDriver::destroy_all()
 {
@@ -276,9 +272,6 @@ JackDriver::shutdown()
 	signal_detached.emit();
 }
 
-/** Refresh all Jack audio ports/connections.
- * To be called from GTK thread only.
- */
 void
 JackDriver::refresh()
 {
diff --git a/src/JackDriver.hpp b/src/JackDriver.hpp
index 7500f6e..03ff365 100644
--- a/src/JackDriver.hpp
+++ b/src/JackDriver.hpp
@@ -33,11 +33,7 @@ class PatchageEvent;
 class PatchageModule;
 class PatchagePort;
 
-/** Handles all externally driven functionality, registering ports etc.
- *
- * Jack callbacks and connect methods and things like that live here.
- * Right now just for jack ports, but that will change...
- */
+/// Driver for JACK audio and midi ports
 class JackDriver : public Driver
 {
 public:
diff --git a/src/PatchagePort.hpp b/src/PatchagePort.hpp
index 32b0cec..54fa185 100644
--- a/src/PatchagePort.hpp
+++ b/src/PatchagePort.hpp
@@ -35,8 +35,7 @@ PATCHAGE_RESTORE_WARNINGS
 
 #include <string>
 
-/** A Port on a PatchageModule
- */
+/// A port on a PatchageModule
 class PatchagePort : public Ganv::Port
 {
 public: