Doxygen tweaks.

git-svn-id: svn://localhost/ardour2/branches/3.0@10644 d708f5d6-7413-0410-9779-e7cbd77b26cf

gtk2_ardour/ardour_ui.cc

@@ -2511,8 +2511,6 @@ ARDOUR_UI::build_session_from_nsd (const std::string& session_path, const std::s
 			bus_profile.input_ac = AutoConnectOption (0);
 		}
 
-		/// @todo some minor tweaks.
-
 		bus_profile.output_ac = AutoConnectOption (0);
 
 		if (_startup->connect_outputs ()) {

libs/ardour/ardour/diskstream.h

@@ -50,6 +50,9 @@ class Session;
 class Track;
 class Location;
 
+/** Parent class for classes which can stream data to and from disk.
+ *  These are used by Tracks to get playback and put recorded data.
+ */
 class Diskstream : public SessionObject, public PublicDiskstream
 {
   public:
@@ -69,6 +72,10 @@ class Diskstream : public SessionObject, public PublicDiskstream
 	boost::shared_ptr<ARDOUR::IO> io() const { return _io; }
 	void set_track (ARDOUR::Track *);
 
+	/** @return A number between 0 and 1, where 0 indicates that the playback buffer
+	 *  is dry (ie the disk subsystem could not keep up) and 1 indicates that the
+	 *  buffer is full.
+	 */
 	virtual float playback_buffer_load() const = 0;
 	virtual float capture_buffer_load() const = 0;
 

libs/evoral/src/libsmf/smf.h

@@ -33,7 +33,7 @@
 
 /**
  *
- * \mainpage libsmf - general usage instructions
+ * \page libsmf libsmf - general usage instructions
  *
  * An smf_t structure represents a "song".  Every valid smf contains one or more tracks.
  * Tracks contain zero or more events.  Libsmf doesn't care about actual MIDI data, as long