diff --git a/core/commands/files.go b/core/commands/files.go
index ab55545557f..db498d815ff 100644
--- a/core/commands/files.go
+++ b/core/commands/files.go
@@ -419,7 +419,7 @@ var filesLsCmd = &cmds.Command{
 	Helptext: cmds.HelpText{
 		Tagline: "List directories in the local mutable namespace.",
 		ShortDescription: `
-List directories in the local mutable namespace.
+List directories in the local mutable namespace (works on both IPFS and MFS paths).
 
 Examples:
 
diff --git a/core/commands/unixfs/ls.go b/core/commands/unixfs/ls.go
index 58c57797b70..fee64c713fd 100644
--- a/core/commands/unixfs/ls.go
+++ b/core/commands/unixfs/ls.go
@@ -34,7 +34,7 @@ type LsOutput struct {
 
 var LsCmd = &cmds.Command{
 	Helptext: cmds.HelpText{
-		Tagline: "List directory contents for Unix filesystem objects.",
+		Tagline: "List directory contents for Unix filesystem objects. Deprecated: Use 'ipfs ls' instead.",
 		ShortDescription: `
 Displays the contents of an IPFS or IPNS object(s) at the given path.
 
@@ -42,8 +42,8 @@ The JSON output contains size information. For files, the child size
 is the total size of the file contents. For directories, the child
 size is the IPFS link size.
 
-This functionality is deprecated, and will be removed in future versions. If
-possible, please use 'ipfs ls' instead.
+This functionality is deprecated, and will be removed in future versions as it duplicates the functionality of 'ipfs ls'.
+If possible, please use 'ipfs ls' instead.
 `,
 		LongDescription: `
 Displays the contents of an IPFS or IPNS object(s) at the given path.
@@ -62,8 +62,8 @@ Example:
     > ipfs file ls /ipfs/QmW2WQi7j6c7UgJTarActp7tDNikE4B2qXtFCfLPdsgaTQ
     cat.jpg
 
-This functionality is deprecated, and will be removed in future versions. If
-possible, please use 'ipfs ls' instead.
+This functionality is deprecated, and will be removed in future versions as it duplicates the functionality of 'ipfs ls'.
+If possible, please use 'ipfs ls' instead.
 `,
 	},