From cd89304706629a8b7f295bccd020bdca05fee010 Mon Sep 17 00:00:00 2001
From: Leon <L_1_L_0@yahoo.com>
Date: Wed, 9 Nov 2022 22:41:55 +1000
Subject: [PATCH] Add `help` warnings for `path exists` and `path type`
 regarding usage (#7062)

* Add help warnings to `path exists` and `path type`

* Correction
---
 crates/nu-command/src/conversions/into/duration.rs | 2 +-
 crates/nu-command/src/path/exists.rs               | 5 +++++
 crates/nu-command/src/path/type.rs                 | 5 +++++
 3 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/crates/nu-command/src/conversions/into/duration.rs b/crates/nu-command/src/conversions/into/duration.rs
index 31e2b02ce..b6459e146 100644
--- a/crates/nu-command/src/conversions/into/duration.rs
+++ b/crates/nu-command/src/conversions/into/duration.rs
@@ -36,7 +36,7 @@ impl Command for SubCommand {
     }
 
     fn extra_usage(&self) -> &str {
-        "into duration does not take leap years into account and every month is calculated with 30 days"
+        "This command does not take leap years into account, and every month is assumed to have 30 days."
     }
 
     fn search_terms(&self) -> Vec<&str> {
diff --git a/crates/nu-command/src/path/exists.rs b/crates/nu-command/src/path/exists.rs
index eb88d13e2..e5dab5ef6 100644
--- a/crates/nu-command/src/path/exists.rs
+++ b/crates/nu-command/src/path/exists.rs
@@ -38,6 +38,11 @@ impl Command for SubCommand {
         "Check whether a path exists"
     }
 
+    fn extra_usage(&self) -> &str {
+        r#"This only checks if it is possible to either `open` or `cd` to the given path.
+If you need to distinguish dirs and files, please use `path type`."#
+    }
+
     fn run(
         &self,
         engine_state: &nu_protocol::engine::EngineState,
diff --git a/crates/nu-command/src/path/type.rs b/crates/nu-command/src/path/type.rs
index c00123b3d..2a5689a1b 100644
--- a/crates/nu-command/src/path/type.rs
+++ b/crates/nu-command/src/path/type.rs
@@ -36,6 +36,11 @@ impl Command for SubCommand {
         "Get the type of the object a path refers to (e.g., file, dir, symlink)"
     }
 
+    fn extra_usage(&self) -> &str {
+        r#"This checks the file system to confirm the path's object type.
+If nothing is found, an empty string will be returned."#
+    }
+
     fn run(
         &self,
         engine_state: &nu_protocol::engine::EngineState,