btrfs: reformat remaining kdoc style comments

[linux-2.6-microblaze.git] / fs / btrfs / disk-io.c

diff --git a/fs/btrfs/disk-io.c b/fs/btrfs/disk-io.c
index 68f60d5..4895890 100644 (file)
--- a/fs/btrfs/disk-io.c
+++ b/fs/btrfs/disk-io.c
@@ -318,9 +318,10 @@ static bool check_tree_block_fsid(struct extent_buffer *eb)
                           BTRFS_FSID_SIZE);
 
        /*
-        * alloc_fs_devices() copies the fsid into metadata_uuid if the
-        * metadata_uuid is unset in the superblock, including for a seed device.
-        * So, we can use fs_devices->metadata_uuid.
+        * alloc_fsid_devices() copies the fsid into fs_devices::metadata_uuid.
+        * This is then overwritten by metadata_uuid if it is present in the
+        * device_list_add(). The same true for a seed device as well. So use of
+        * fs_devices::metadata_uuid is appropriate here.
         */
        if (memcmp(fsid, fs_info->fs_devices->metadata_uuid, BTRFS_FSID_SIZE) == 0)
                return false;
@@ -1402,7 +1403,8 @@ struct btrfs_root *btrfs_get_new_fs_root(struct btrfs_fs_info *fs_info,
 }
 
 /*
- * btrfs_get_fs_root_commit_root - return a root for the given objectid
+ * Return a root for the given objectid.
+ *
  * @fs_info:   the fs_info
  * @objectid:  the objectid we need to lookup
  *
@@ -1699,11 +1701,11 @@ static void backup_super_roots(struct btrfs_fs_info *info)
 }
 
 /*
- * read_backup_root - Reads a backup root based on the passed priority. Prio 0
- * is the newest, prio 1/2/3 are 2nd newest/3rd newest/4th (oldest) backup roots
+ * Reads a backup root based on the passed priority. Prio 0 is the newest, prio
+ * 1/2/3 are 2nd newest/3rd newest/4th (oldest) backup roots
  *
- * fs_info - filesystem whose backup roots need to be read
- * priority - priority of backup root required
+ * @fs_info:  filesystem whose backup roots need to be read
+ * @priority: priority of backup root required
  *
  * Returns backup root index on success and -EINVAL otherwise.
  */