Some documentation fixes.
authorAndre Noll <maan@systemlinux.org>
Sat, 15 Sep 2007 21:33:52 +0000 (23:33 +0200)
committerAndre Noll <maan@systemlinux.org>
Sat, 15 Sep 2007 21:33:52 +0000 (23:33 +0200)
MAke doxygen happy again and add documentation for com_setatt().

afs.cmd
attribute.c
net.h
osl.c
time.c

diff --git a/afs.cmd b/afs.cmd
index 79cb84e..019bcc9 100644 (file)
--- a/afs.cmd
+++ b/afs.cmd
@@ -28,9 +28,10 @@ H: -v        Verbose mode. Print what is being done.
 ---
 N: init
 P: AFS_READ | AFS_WRITE
-D: FIXME
-U: FIXME
-H: FIXME
+D: Initialize the osl tables for the audio file selector.
+U: init [table_name ...]
+H: When invoked without arguments, this command creates all tables. Otherwise
+H: only the tables given by table_name... are created.
 ---
 N: afs_ls
 P: AFS_READ
@@ -70,21 +71,28 @@ N: lsatt
 P: AFS_READ
 D: List attributes
 U: lsatt [-a] [-l]
-H: 
+H:
 H: Print the list of all defined attributes.
-H: 
+H:
 H: Options:
-H: -a Sort attributes alphabetically by name. The default is to sort by attribute
-H: identifier.
-H: 
-H: -l Print a long listing containing both identifier and attribute name. The
-H: default is to print only the name.
+H: -a  Sort attributes alphabetically by name. The default is to sort by
+H:     identifier.
+H:
+H: -l  Print a long listing containing both identifier and attribute name. The
+H:     default is to print only the name.
 ---
 N: setatt
 P: AFS_READ | AFS_WRITE
 D: FIXME
-U: FIXME
-H: FIXME
+U: setatt attribute1{+|-} [attribute2{+|-}...] pattern
+
+H: Set ('+') or unset ('-') the given attributes for all audio files matching
+H: pattern.  Example:
+H:
+H:         sa rock+ punk+ classic- '*foo.mp3'
+H:
+H: sets the 'rock' and the 'punk' attribute but unsets the 'classic'
+H: attribute of all files ending with 'foo.mp3'.
 ---
 N: addatt
 P: AFS_READ | AFS_WRITE
@@ -123,7 +131,7 @@ N: ls@member@
 O: int com_ls@member@(int fd, int argc, char * const * const argv);
 P: AFS_READ
 D: FIXME
-U: cat@member@ <pattern>
+U: ls@member@ pattern
 H: FIXME
 ---
 T: rm
index 66312b2..9a7cb45 100644 (file)
@@ -373,7 +373,7 @@ int com_rmatt(__a_unused int fd, int argc, char * const * const argv)
  * \param buf Result.
  *
  * This function prints a string of at most 64 characters plus the terminating
- * \p NULL character into \buf which must be provided by the caller and at
+ * \p NULL character into \buf which must be provided by the caller and at
  * least 65 bytes long. The "x" character is used for set attributes and "-" is
  * used for unset attributes.
  *
diff --git a/net.h b/net.h
index 8fdaa3e..d42031e 100644 (file)
--- a/net.h
+++ b/net.h
@@ -45,7 +45,8 @@ void disable_crypt(int fd);
  * A wrapper around connect(2).
  *
  * \param fd The file descriptor.
- * \param their_addr The address to connect.
+ * \param addr The address to connect.
+ * \param len The size of \a addr.
  *
  * This should not be called directly. Always use the PARA_CONNECT macro.
  *
@@ -53,7 +54,7 @@ void disable_crypt(int fd);
  *
  * \sa connect(2), PARA_CONNECT.
  */
-_static_inline_ int _para_connect(int fd, void *addr, socklen_t len)
+static inline int _para_connect(int fd, void *addr, socklen_t len)
 {
        if (connect(fd, (struct sockaddr *)addr, len) == -1)
                return -E_CONNECT;
diff --git a/osl.c b/osl.c
index 6743b66..b1aaf3e 100644 (file)
--- a/osl.c
+++ b/osl.c
@@ -12,9 +12,6 @@
 #include <dirent.h> /* readdir() */
 #include <assert.h>
 
-//#define FMT_OFF_T "%li"
-
-
 /**
  * A wrapper for lseek(2).
  *
@@ -41,7 +38,7 @@ int para_lseek(int fd, off_t *offset, int whence)
 }
 
 /**
- * Waraper for the write system call.
+ * Wrapper for the write system call.
  *
  * \param fd The file descriptor to write to.
  * \param buf The buffer to write.
diff --git a/time.c b/time.c
index 809cefc..b771382 100644 (file)
--- a/time.c
+++ b/time.c
@@ -53,7 +53,7 @@ void d2tv(double x, struct timeval *tv)
  * If \a diff is not \p NULL, it contains the absolute value |\a b - \a a| on
  * return.
  *
- * \return If \a b < \a, this function returns -1, otherwise it returns 1.
+ * \return If \a b < \a a, this function returns -1, otherwise it returns 1.
  */
 int tv_diff(const struct timeval *b, const struct timeval *a, struct timeval *diff)
 {
@@ -82,8 +82,7 @@ int tv_diff(const struct timeval *b, const struct timeval *a, struct timeval *di
  *
  * \param a First addend.
  * \param b Second addend.
- *
- * \param \a Sum contains the sum \a + \a b on return.
+ * \param sum Contains the sum \a + \a b on return.
  */
 void tv_add(const struct timeval *a, const struct timeval *b,
        struct timeval *sum)