[www] list command: lldb run <args>

[kkleine]

Summary

The run command is only an abbreviation for the more verbose process launch -- <args>
but it works just as with GDB and therefore should be
mentioned in the GDB to LLDB command map.

For educational purposes I've not listed it as the first option on the LLDB side so that new LLDB user can, if they want, also know what the "native" way is for LLDB.

Here's the help documentation for the run command in lldb which gives
proof:

(lldb) help run
     Launch the executable in the debugger.

Syntax: run [<run-args>]

Command Options Usage:
  run [<run-args>]

'run' is an abbreviation for 'process launch -c /bin/sh --'

[kkleine]

Amend previous commit with copy paste error.

[kkleine]

• [www] move run <args> command down for educational purposes

[teemperor]

LGTM, seems consistent with the row above

[labath]

This is the old documentation. You should edit the new one in docs/use/map.rst.

[kkleine]

• [www] move run <args> command down for educational purposes
• Add documentation to docs/use/map.rst

[kwk]

In D61483#1489264, @labath wrote:

This is the old documentation. You should edit the new one in docs/use/map.rst.

Oh, good to know. The new documentation is also updated. May I ask why we have two documentation and don't just throw away one of them? What are they both used for?

[jingham]

The www was the original version, which Jonas replaced with with the rst version. We were waiting to get rid of the www version till we were sure we could iron out all the wrinkles of generating the docs on lldb.llvm.org from the rst version. That's close, though we still don't have the API docs working yet.

[kkleine]

@labath @jingham @teemperor I've updated the documentation in both, the new and the old places. Can you please merge this?

lldb/www/lldb-gdb.html

<div id="content">
 
 
                     <tr><td class="header" colspan="2">Launch a process with arguments <code>&lt;args&gt;</code>.</td></tr>
                         <td class="content">
                             <b>(gdb)</b> run &lt;args&gt;<br>
                             <b>(gdb)</b> r &lt;args&gt;
                         </td>
                         <td class="content">
+                            <b>(lldb)</b> run &lt;args&gt;<br>
                             <b>(lldb)</b> process launch -- &lt;args&gt;<br>
                             <b>(lldb)</b> r &lt;args&gt;
                         </td>
                     </tr>
 
                     <tr><td class="header" colspan="2">Launch a process for with arguments <b><code>a.out 1 2 3</code></b> without having to supply the args every time.</td></tr>
                         <td class="content">
                             <b>%</b> gdb --args a.out 1 2 3<br>