some strategic documentation

Prevent class descriptions inheriting the doc from PBD:Stateful by
adding some specific doc.

diff --git a/libs/ardour/ardour/location.h b/libs/ardour/ardour/location.h
index fccccac14430c2c8e7af52d21720fa91d63a53eb..530f757c65fa38be1a58f9412148c0961800480e 100644 (file)
--- a/libs/ardour/ardour/location.h
+++ b/libs/ardour/ardour/location.h
@@ -164,6 +164,7 @@ class LIBARDOUR_API Location : public SessionHandleRef, public PBD::StatefulDest
        void recompute_bbt_from_frames ();
 };
 
+/** A collection of session locations including unique dedicated locations (loop, punch, etc) */
 class LIBARDOUR_API Locations : public SessionHandleRef, public PBD::StatefulDestructible
 {
   public:

diff --git a/libs/ardour/ardour/plugin.h b/libs/ardour/ardour/plugin.h
index 087f5968bd0e66586d60a2e8856d7dfa7dd171a2..e48201e73c4b9255dfb5566f05cb9e85bb2ea343 100644 (file)
--- a/libs/ardour/ardour/plugin.h
+++ b/libs/ardour/ardour/plugin.h
@@ -55,6 +55,14 @@ typedef boost::shared_ptr<Plugin> PluginPtr;
 typedef boost::shared_ptr<PluginInfo> PluginInfoPtr;
 typedef std::list<PluginInfoPtr> PluginInfoList;
 
+/** A plugin is an external module (usually 3rd party provided) loaded into Ardour
+ * for the purpose of digital signal processing.
+ *
+ * This class provides an abstraction for methords provided by
+ * all supported plugin standards such as presets, name, parameters etc.
+ *
+ * Plugins are not used directly in Ardour but always wrapped by a PluginInsert.
+ */
 class LIBARDOUR_API Plugin : public PBD::StatefulDestructible, public Latent
 {
   public:

diff --git a/libs/ardour/ardour/track.h b/libs/ardour/ardour/track.h
index da5e2bbae80eda606152ca386deb8f99aabf3c8b..c49cbd00e24c4a2bd92d4a3e43259bbe6cd15aab 100644 (file)
--- a/libs/ardour/ardour/track.h
+++ b/libs/ardour/ardour/track.h
@@ -35,6 +35,11 @@ class Region;
 class Diskstream;
 class IO;
 
+/** A track is an route (bus) with a recordable diskstream and
+ * related objects relevant to tracking, playback and editing.
+ *
+ * Specifically a track has regions and playlist objects.
+ */
 class LIBARDOUR_API Track : public Route, public PublicDiskstream
 {
   public:

diff --git a/libs/ardour/route.cc b/libs/ardour/route.cc
index 730176405ee5e6a6cce8d4ae306e4c1d61423c32..5132c275ac0b160991c16c9a546cb7d01ee10f1b 100644 (file)
--- a/libs/ardour/route.cc
+++ b/libs/ardour/route.cc
@@ -79,6 +79,7 @@ using namespace PBD;
 PBD::Signal0<void> Route::SyncOrderKeys;
 PBD::Signal0<void> Route::RemoteControlIDChange;
 
+/** Base class for all routable/mixable objects (tracks and busses) */
 Route::Route (Session& sess, string name, Flag flg, DataType default_type)
        : SessionObject (sess, name)
        , Automatable (sess)

diff --git a/libs/pbd/pbd/command.h b/libs/pbd/pbd/command.h
index 337140e786f2af0ccb16dd51e6c9246069bafe8f..a9b313f4fa5ed7dee4414d0c82212f70dc80e7b4 100644 (file)
--- a/libs/pbd/pbd/command.h
+++ b/libs/pbd/pbd/command.h
@@ -28,6 +28,7 @@
 #include "pbd/signals.h"
 #include "pbd/statefuldestructible.h"
 
+/** Base class for Undo/Redo commands and changesets */
 class LIBPBD_API Command : public PBD::StatefulDestructible, public PBD::ScopedConnectionList
 {
 public:

diff --git a/libs/pbd/pbd/controllable.h b/libs/pbd/pbd/controllable.h
index 5ac6895d6feac291604f6dbbf22d79ff195ae5c3..cd26ff019f09ca3924c2eeb1c9dd22e07193bbfe 100644 (file)
--- a/libs/pbd/pbd/controllable.h
+++ b/libs/pbd/pbd/controllable.h
@@ -37,7 +37,7 @@ class XMLNode;
 
 namespace PBD {
 
-/* This is a pure virtual class to represent a scalar control.
+/** This is a pure virtual class to represent a scalar control.
  *
  * Note that it contains no storage/state for the controllable thing that it
  * represents. Derived classes must provide set_value()/get_value() methods,
@@ -49,7 +49,6 @@ namespace PBD {
  * as a control whose value can range between 0 and 1.0.
  *
  */
-
 class LIBPBD_API Controllable : public PBD::StatefulDestructible {
   public:
        enum Flag {

diff --git a/libs/pbd/pbd/id.h b/libs/pbd/pbd/id.h
index 1f33e6d732cc408ae080da6fec1e063fbd119355..5316e7c20e32ccfc940dbb2d7d3d79644c6ec3bc 100644 (file)
--- a/libs/pbd/pbd/id.h
+++ b/libs/pbd/pbd/id.h
@@ -29,6 +29,7 @@
 
 namespace PBD {
 
+/** a unique ID to identify objects numerically */
 class LIBPBD_API ID {
   public:
        ID ();