consistently use @returns code documentation tag

Author: rdmark

etc/afpd/dircache.c

@@ -814,7 +814,7 @@ void dircache_remove_children(const struct vol *vol, struct dir *dir)
  *
  * @param reqsize   (r) requested maximum size from afp.conf
  *
- * @return 0 on success, -1 on error
+ * @returns 0 on success, -1 on error
  */
 int dircache_init(int reqsize)
 {

etc/afpd/directory.c

@@ -923,7 +923,7 @@ void dir_free_invalid_q(void)
  *
  * @param vol  (r) volume pointer
  * @param dir  (rw) directory/file entry to remove from cache
- * @return 0 on success
+ * @returns 0 on success
  */
 int dir_remove(const struct vol *vol, struct dir *dir)
 {

etc/afpd/fork.c

@@ -861,7 +861,7 @@ int afp_bytelock_ext(AFPObj *obj, char *ibuf, size_t ibuflen, char *rbuf,
  * @param rbuf     (r)  data buffer
  * @param rbuflen  (rw) in: number of bytes to read, out: bytes read
  *
- * @return         AFP status code
+ * @returns         AFP status code
  */
 static int read_file(const struct ofork *ofork, int eid, off_t offset,
                      char *rbuf, size_t *rbuflen)

etc/afpd/volume.c

@@ -75,7 +75,7 @@ extern int afprun(char *cmd, int *outfd);
  * @brief Read band-size info from Info.plist XML file of an TM sparsebundle
  *
  * @param path   (r) path to Info.plist file
- * @return           band-size in bytes, -1 on error
+ * @returns           band-size in bytes, -1 on error
  */
 static long long int get_tm_bandsize(const char *path)
 {
@@ -121,7 +121,7 @@ static long long int get_tm_bandsize(const char *path)
  * @brief Return number on entries in a directory
  *
  * @param path   (r) path to dir
- * @return           number of entries, -1 on error
+ * @returns           number of entries, -1 on error
  */
 static long long int get_tm_bands(const char *path)
 {
@@ -171,7 +171,7 @@ static long long int get_tm_bands(const char *path)
  * appends X bytes to a file (in fork.c).
  *
  * @param vol     (rw) volume to calculate
- * @return             0 on success, -1 on error
+ * @returns             0 on success, -1 on error
  */
 static int get_tm_used(struct vol *restrict vol)
 {

etc/cnid_dbd/cnid_metad.c

@@ -164,7 +164,7 @@ static struct server *test_usockfn(const char *path)
  * @param[in] volpath  Path of AFP volume
  * @param[in] username  Optional username, may be NULL
  *
- * @return 0 on success, -1 on error
+ * @returns 0 on success, -1 on error
  */
 int maybe_start_dbd(const AFPObj *obj, char *dbdpn, const char *volpath,
                     const char *username)

libatalk/dsi/dsi_stream.c

@@ -644,7 +644,7 @@ int dsi_stream_send(DSI *dsi, void *buf, size_t length)
  *
  * @param  dsi   (rw) DSI handle
  *
- * @return    DSI function on success, 0 on failure
+ * @returns    DSI function on success, 0 on failure
  */
 int dsi_stream_receive(DSI *dsi)
 {

libatalk/util/netatalk_conf.c

@@ -604,7 +604,7 @@ static char *volxlate(const AFPObj *obj,
  * Example:
  * user1 user2, user3, "@group1", "@group2", "@group3", "user name1", "@group name1"
  * A NULL argument allows everybody to have access.
- * @return three things:
+ * @returns three things:
  *     -1: no list
  *      0: list exists, but name isn't in it
  *      1: in list

libatalk/util/server_child.c

@@ -104,7 +104,7 @@ server_child_t *server_child_alloc(int connections)
 
 /*!
  * @brief add a child
- * @return pointer to struct server_child_data on success, NULL on error
+ * @returns pointer to struct server_child_data on success, NULL on error
  */
 afp_child_t *server_child_add(server_child_t *children, pid_t pid, int ipc_fd)
 {

libatalk/util/unix.c

@@ -113,7 +113,7 @@ int run_cmd(const char *cmd, char **cmd_argv)
 /*!
  * @brief Fork, exit parent, setsid(), chdir("/"), close all fds
  *
- * @return -1 on failure, but you can't do much except exit in that case
+ * @returns -1 on failure, but you can't do much except exit in that case
  * since we may already have forked
  */
 int daemonize(void)