doxygen: add some missing docstrings.

diff --git a/clients/resample.c b/clients/resample.c
index bc41013b6fb343b55d7b0b759b475aab0271a661..6291c8336decc2798fd23e8b6a2b3c2cabcc28f7 100644 (file)
--- a/clients/resample.c
+++ b/clients/resample.c
@@ -15,6 +15,9 @@
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
+/** @file clients/resample.c
+ * @brief Audio resampler
+ */
 #include "common.h"
 
 #include <unistd.h>

diff --git a/lib/strptime.c b/lib/strptime.c
index 91d57d55451ae2212bd785004cc581226e35c250..27ef40aeffebae51b88188245631b0cb0418067e 100644 (file)
--- a/lib/strptime.c
+++ b/lib/strptime.c
@@ -26,10 +26,13 @@
  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  * SUCH DAMAGE.
  */
-
-/* strptime() is here reimplemented because the FreeBSD (and older MacOS) one
+/** @file lib/strptime.c
+ * @brief strptime() reimplementation
+ *
+ * strptime() is here reimplemented because the FreeBSD (and older MacOS) one
  * is broken and does not report errors properly.  See TODO remarks below for
- * some missing bits. */
+ * some missing bits.
+ */
 
 #include <ctype.h>
 #include <limits.h>

diff --git a/lib/strptime.h b/lib/strptime.h
index 324f88d1bd8d133986b6bcb43ae4646998ca4aab..b2b3715d244fca205998874a11d54266f530930c 100644 (file)
--- a/lib/strptime.h
+++ b/lib/strptime.h
@@ -1,5 +1,8 @@
 #ifndef STRPTIME_H
 #define STRPTIME_H
+/** @file lib/strptime.h
+ * @brief strptime() reimplementation
+ */
 
 #include <time.h>
 

diff --git a/lib/validity.h b/lib/validity.h
index 8ce2505842f5dff6716cca1d7aef420293676399..6254708e14f328e17b64242c7e3b268bc7d0bbf4 100644 (file)
--- a/lib/validity.h
+++ b/lib/validity.h
@@ -17,7 +17,7 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  * USA
  */
-/** @file lib/validity.c
+/** @file lib/validity.h
  * @brief Various validity checks
  */
 #ifndef VALIDITY_H

diff --git a/plugins/tracklength.h b/plugins/tracklength.h
index c8e22a44cf404c5bb1a4df2f4f371c5b442dadb0..112b652ebd7a364ac78d1554ebb98e014c2767ff 100644 (file)
--- a/plugins/tracklength.h
+++ b/plugins/tracklength.h
@@ -15,6 +15,9 @@
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
+/** @file plugins/tracklength.h
+ * @brief Plugin to compute track lengths
+ */
 
 #ifndef TRACKLENGTH_H
 #define TRACKLENGTH_H

diff --git a/server/decode-flac.c b/server/decode-flac.c
index f1399fba925813dca31f165d6bc8829f1ec47b49..9577d9db0fc40bf2e2268dc23fb6e0578b1c393f 100644 (file)
--- a/server/decode-flac.c
+++ b/server/decode-flac.c
@@ -15,7 +15,7 @@
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
-/** @file server/decode.c
+/** @file server/decode-flac.c
  * @brief General-purpose decoder for use by speaker process
  */
 #include "decode.h"

diff --git a/server/decode-ogg.c b/server/decode-ogg.c
index d499955225cf444cb732fe8f062c7f9379af8472..efa10a7d35c526b12dd758f197fb8a8807c518c5 100644 (file)
--- a/server/decode-ogg.c
+++ b/server/decode-ogg.c
@@ -15,7 +15,7 @@
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
-/** @file server/decode.c
+/** @file server/decode-ogg.c
  * @brief General-purpose decoder for use by speaker process
  */
 #include "decode.h"

diff --git a/server/decode-wav.c b/server/decode-wav.c
index fd58a140349b6d007f7dd638bd2eb55c7b8c7858..8fdc10e66e104ff4b600f12e4464d3d724080c28 100644 (file)
--- a/server/decode-wav.c
+++ b/server/decode-wav.c
@@ -15,7 +15,7 @@
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
-/** @file server/decode.c
+/** @file server/decode-wav.c
  * @brief General-purpose decoder for use by speaker process
  */
 #include "decode.h"