Fix several doxygen warnings, to minimize noise. Only changes comments.

Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>

3 files changed, 20 insertions, 20 deletions

diff --git a/src/mds/MDCache.cc b/src/mds/MDCache.cc
index 953a89e0d83..fb7fec66301 100644
--- a/src/mds/MDCache.cc
+++ b/src/mds/MDCache.cc
@@ -3393,8 +3393,8 @@ void MDCache::rejoin_send_rejoins()
 /** 
  * rejoin_walk - build rejoin declarations for a subtree
  * 
- * @dir subtree root
- * @rejoin rejoin message
+ * @param dir subtree root
+ * @param rejoin rejoin message
  *
  * from a rejoining node:
  *  weak dirfrag
@@ -3739,8 +3739,8 @@ public:
 /**
  * parallel_fetch -- make a pass at fetching a bunch of paths in parallel
  *
- * @pathmap - map of inodeno to full pathnames.  we remove items from this map 
- *            as we discover we have them.
+ * @param pathmap map of inodeno to full pathnames.  we remove items
+ *            from this map as we discover we have them.
  *
  *	      returns true if there is work to do, false otherwise.
  */
@@ -6919,9 +6919,9 @@ CInode *MDCache::cache_traverse(const filepath& fp)
 /**
  * open_remote_dir -- open up a remote dirfrag
  *
- * @diri - base inode
- * @approxfg - approximate fragment.
- * @fin - completion callback
+ * @param diri base inode
+ * @param approxfg approximate fragment.
+ * @param fin completion callback
  */
 void MDCache::open_remote_dirfrag(CInode *diri, frag_t approxfg, Context *fin) 
 {
@@ -6947,8 +6947,8 @@ void MDCache::open_remote_dirfrag(CInode *diri, frag_t approxfg, Context *fin)
 /** 
  * get_dentry_inode - get or open inode
  *
- * @dn the dentry
- * @mdr current request
+ * @param dn the dentry
+ * @param mdr current request
  *
  * will return inode for primary, or link up/open up remote link's inode as necessary.
  * If it's not available right now, puts mdr on wait list and returns null.
@@ -9343,9 +9343,9 @@ void MDCache::handle_dentry_unlink(MDentryUnlink *m)
 /** 
  * adjust_dir_fragments -- adjust fragmentation for a directory
  *
- * @diri - directory inode
- * @basefrag - base fragment
- * @bits - bit adjustment.  positive for split, negative for merge.
+ * @param diri directory inode
+ * @param basefrag base fragment
+ * @param bits bit adjustment.  positive for split, negative for merge.
  */
 void MDCache::adjust_dir_fragments(CInode *diri, frag_t basefrag, int bits,
 				   list<CDir*>& resultfrags, 
diff --git a/src/mds/MDCache.h b/src/mds/MDCache.h
index 0662cfa28e7..236f644458f 100644
--- a/src/mds/MDCache.h
+++ b/src/mds/MDCache.h
@@ -665,10 +665,10 @@ public:
    * @param mdr The MDRequest associated with the path. Can be null.
    * @param req The Message associated with the path. Can be null.
    * @param fin The Context associated with the path. Can be null.
-   * @param filepath The path to traverse to.
-   * @pdnvec Data return parameter -- on success, contains a vector of dentries.
-   * On failure, is either empty or contains the full trace of traversable
-   * dentries.
+   * @param path The path to traverse to.
+   * @param pdnvec Data return parameter -- on success, contains a
+   * vector of dentries. On failure, is either empty or contains the
+   * full trace of traversable dentries.
    * @param pin Data return parameter -- if successful, points to the inode
    * associated with filepath. If unsuccessful, is null.
    * @param onfail Specifies different lookup failure behaviors. If set to
diff --git a/src/mds/Server.cc b/src/mds/Server.cc
index d44bd7ea377..55e5a579efe 100644
--- a/src/mds/Server.cc
+++ b/src/mds/Server.cc
@@ -2041,10 +2041,10 @@ CDentry* Server::rdlock_path_xlock_dentry(MDRequest *mdr, int n,
 /**
  * try_open_auth_dirfrag -- open dirfrag, or forward to dirfrag auth
  *
- * @diri base indoe
- * @fg the exact frag we want
- * @mdr request
- * Returns: the pointer, or NULL if it had to be delayed (but mdr is taken care of)
+ * @param diri base inode
+ * @param fg the exact frag we want
+ * @param mdr request
+ * @returns the pointer, or NULL if it had to be delayed (but mdr is taken care of)
  */
 CDir* Server::try_open_auth_dirfrag(CInode *diri, frag_t fg, MDRequest *mdr)
 {