X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/6f2623fd69f41978c79e7bc38cabe45d677f2853..67684d038de4c18431af0ccc17f55efbf4f20eb8:/flist.c

diff --git a/flist.c b/flist.c
index cbae6442..381eb8e4 100644
--- a/flist.c
+++ b/flist.c
@@ -196,8 +196,15 @@ static void list_file_entry(struct file_struct *f)
  * Stat either a symlink or its referent, depending on the settings of
  * copy_links, copy_unsafe_links, etc.
  *
- * @return -1 on error; or 0.  If a symlink, then @p Linkbuf (of size
+ * @retval -1 on error
+ *
+ * @retval 0 for success
+ *
+ * @post If @p path is a symlink, then @p linkbuf (of size @c
  * MAXPATHLEN) contains the symlink target.
+ *
+ * @post @p buffer contains information about the link or the
+ * referrent as appropriate, if they exist.
  **/
 int readlink_stat(const char *path, STRUCT_STAT * buffer, char *linkbuf)
 {