[lldb] Improve help for platform put-file

[keith]

Summary

Previously it was not clear what arguments this required, or what it would do if you didn't pass the destination argument.

[labath]

lldb/source/Commands/CommandObjectPlatform.cpp

1079

It would be more correct to say "the platform working directory" (as selected by platform settings -w).

It might also be nice to mention what happens with relative paths. I guess they are going to be interpreted relative to the remove WD (?)

[keith]

Update text about resolving paths

[labath]

looks good. thanks.

lldb/source/Commands/CommandObjectPlatform.cpp

 };
 
 // "platform put-file"
 class CommandObjectPlatformPutFile : public CommandObjectParsed {
 public:
   CommandObjectPlatformPutFile(CommandInterpreter &interpreter)
       : CommandObjectParsed(
             interpreter, "platform put-file",
-            "Transfer a file from this system to the remote end.", nullptr, 0) {
+            "Transfer a file from this system to the remote end.",
+            "platform put-file <source> [<destination>]", 0) {
+    SetHelpLong(
+        R"(Examples:
+
+(lldb) platform put-file /source/foo.txt /destination/bar.txt
+
+(lldb) platform put-file /source/foo.txt
+
+    Relative source file paths are resolved against lldb's local working directory.
+
+    Omitting the destination places the file in the platform working directory.)");
   }
 
   ~CommandObjectPlatformPutFile() override = default;
 
   void
   HandleArgumentCompletion(CompletionRequest &request,
                            OptionElementVector &opt_element_vector) override {
     if (request.GetCursorIndex() == 0)