summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2008-10-02 05:16:25 +0000
committerDavid Robillard <d@drobilla.net>2008-10-02 05:16:25 +0000
commit38761ec2b70605e7ad126691075a448a357db912 (patch)
tree03b22c7a14fecbe3509f996ec486c6b58515fc7c
parent0da0c8f334f441261e8e113c583413a9d9122248 (diff)
downloadingen-38761ec2b70605e7ad126691075a448a357db912.tar.gz
ingen-38761ec2b70605e7ad126691075a448a357db912.tar.bz2
ingen-38761ec2b70605e7ad126691075a448a357db912.zip
Make --build-docs at configure time trigger documentation building at build time.
git-svn-id: http://svn.drobilla.net/lad/trunk/ingen@1589 a436a847-0d15-0410-975c-d299462d15a1
-rw-r--r--doc/reference.doxygen.in4
-rw-r--r--src/client/DeprecatedLoader.cpp1
-rw-r--r--src/engine/AudioBuffer.hpp2
-rw-r--r--src/engine/PortImpl.hpp2
-rw-r--r--src/engine/QueuedEngineInterface.hpp14
-rw-r--r--src/gui/Port.cpp2
-rw-r--r--src/serialisation/Parser.cpp3
7 files changed, 7 insertions, 21 deletions
diff --git a/doc/reference.doxygen.in b/doc/reference.doxygen.in
index 2573740d..5ef60590 100644
--- a/doc/reference.doxygen.in
+++ b/doc/reference.doxygen.in
@@ -282,7 +282,7 @@ EXTRACT_ALL = YES
# If the EXTRACT_PRIVATE tag is set to YES all private members of a class
# will be included in the documentation.
-EXTRACT_PRIVATE = YES
+EXTRACT_PRIVATE = NO
# If the EXTRACT_STATIC tag is set to YES all static members of a file
# will be included in the documentation.
@@ -293,7 +293,7 @@ EXTRACT_STATIC = NO
# defined locally in source files will be included in the documentation.
# If set to NO only classes defined in header files are included.
-EXTRACT_LOCAL_CLASSES = YES
+EXTRACT_LOCAL_CLASSES = NO
# This flag is only useful for Objective-C code. When set to YES local
# methods, which are defined in the implementation section but not in
diff --git a/src/client/DeprecatedLoader.cpp b/src/client/DeprecatedLoader.cpp
index a07893f7..2b4e34a4 100644
--- a/src/client/DeprecatedLoader.cpp
+++ b/src/client/DeprecatedLoader.cpp
@@ -202,7 +202,6 @@ DeprecatedLoader::add_variable(GraphObject::Variables& data, string old_key, str
* to the root patch)
*
* @param name Name of this patch (loaded/generated if the empty string)
- * @param poly Polyphony of this patch (loaded/generated if 0)
*
* @param initial_data will be set last, so values passed there will override
* any values loaded from the patch file.
diff --git a/src/engine/AudioBuffer.hpp b/src/engine/AudioBuffer.hpp
index 513c188f..b93e2267 100644
--- a/src/engine/AudioBuffer.hpp
+++ b/src/engine/AudioBuffer.hpp
@@ -74,7 +74,7 @@ private:
size_t _size; ///< Allocated buffer size
size_t _filled_size; ///< Usable buffer size (for MIDI ports etc)
State _state; ///< State of buffer for setting values next cycle
- Sample _set_value; ///< Value set by @ref set (may need to be set next cycle)
+ Sample _set_value; ///< Value set by set_value (for completing the set next cycle)
FrameTime _set_time; ///< Time _set_value was set (to reset next cycle)
};
diff --git a/src/engine/PortImpl.hpp b/src/engine/PortImpl.hpp
index be96a910..a2eaf2c9 100644
--- a/src/engine/PortImpl.hpp
+++ b/src/engine/PortImpl.hpp
@@ -65,7 +65,7 @@ public:
*
* Audio thread.
*
- * \param poly Must be < the most recent value passed to prepare_poly.
+ * \a poly Must be < the most recent value passed to prepare_poly.
*/
virtual bool apply_poly(Raul::Maid& maid, uint32_t poly);
diff --git a/src/engine/QueuedEngineInterface.hpp b/src/engine/QueuedEngineInterface.hpp
index 73c790c8..89810434 100644
--- a/src/engine/QueuedEngineInterface.hpp
+++ b/src/engine/QueuedEngineInterface.hpp
@@ -41,20 +41,10 @@ class Engine;
* This is the bridge between the EngineInterface presented to the client, and
* the EventSource that needs to be presented to the AudioDriver.
*
- * This is sort of a state machine, \ref set_responder sets the Responder that
- * will be used to send the response from all future function calls. Stateless
- * protocols like UDP/OSC can use this to set a different response address for
- * each event (eg incoming UDP port), but engine/client interfaces that don't
- * need to change an 'address' constantly can just set it once on initialisation.
- * Blocking control interfaces can be made by setting a Responder which signals
- * the caller when the 'response' is 'sent'.
- *
+ * Responses occur through the event mechanism (which notified clients in
+ * event post_process methods) and are related to an event by an integer ID.
* If you do not register a responder, you have no way of knowing if your calls
* are successful.
- *
- * FIXME: this isn't really "queued" entirely, since some events aren't queued
- * events and get pushed directly into the realtime event queue. Should that
- * be separated into a different interface/client?
*/
class QueuedEngineInterface : public QueuedEventSource, public EngineInterface
{
diff --git a/src/gui/Port.cpp b/src/gui/Port.cpp
index 031c74c5..38db6d25 100644
--- a/src/gui/Port.cpp
+++ b/src/gui/Port.cpp
@@ -34,7 +34,7 @@ namespace Ingen {
namespace GUI {
-/** @param flip Make an input port appear as an output port, and vice versa.
+/** @a flip Make an input port appear as an output port, and vice versa.
*/
Port::Port(
boost::shared_ptr<FlowCanvas::Module> module,
diff --git a/src/serialisation/Parser.cpp b/src/serialisation/Parser.cpp
index aed49a38..3eae4814 100644
--- a/src/serialisation/Parser.cpp
+++ b/src/serialisation/Parser.cpp
@@ -52,9 +52,6 @@ Parser::uri_relative_to_base(Glib::ustring base, const Glib::ustring uri)
/** Parse a patch from RDF into a CommonInterface (engine or client).
- *
- * @param document_uri URI of file to load objects from.
- * @param parent Path of parent under which to load objects.
* @return whether or not load was successful.
*/
bool