diff --git a/swh/model/git.py b/swh/model/git.py
index c8b4bbe844522c0883f25b94388734fe39e27fe7..1f95b7b62ac701b86152f42ae2e6d5dee5d3d5cc 100644
--- a/swh/model/git.py
+++ b/swh/model/git.py
@@ -157,12 +157,13 @@ def compute_link_metadata(linkpath):
 
 
 def compute_blob_metadata(filepath):
-    """Given a filepath, compute the git metadata.
+    """Given a filepath resolving to a regular file, compute the metadata.
+    Other file types (fifo, character or block device, symlink) will
+    be considered empty regular file.  To deal properly with symlinks,
+    use swh.model.git.compute_link_metadata.
 
     Args:
-        filepath: absolute pathname of the file.
-                  This could be special files (fifo, character or
-                  block device), they will be considered empty files.
+        filepath: absolute pathname of the regular file.
 
     Returns:
         Dictionary of values: