mirror of
https://github.com/apache/nuttx.git
synced 2026-09-20 21:06:58 +08:00
Documentation: Use a little more care with the trademarked Unix name.
This commit is contained in:
@@ -4360,7 +4360,7 @@ set FOOBAR ABC_${FOO}_${BAR}
|
||||
<p>
|
||||
<b>Overview.</b>
|
||||
The NuttShell (NSH) is a simple shell application that may be used with NuttX.
|
||||
It supports a variety of commands and is (very) loosely based on the bash shell and the common utilities used in Unix shell programming.
|
||||
It supports a variety of commands and is (very) loosely based on the Bash shell and the common utilities used with Bash shell programming.
|
||||
The paragraphs in this appendix will focus on customizing NSH: Adding new commands, changing the initialization sequence, etc.
|
||||
</p>
|
||||
|
||||
@@ -4858,7 +4858,7 @@ context:
|
||||
Without <i>binfs</i>, you can see the installed builtin applications using the NSH help command.
|
||||
<i>binfs</i> will create a tiny pseudo-file system mounted at <code>/bin</code>.
|
||||
Using <i>binfs</i>, you can see the available builtin applications by listing the contents of <code>/bin</code> directory.
|
||||
This gives some superficial Unix compatibility, but does not really add any new functionality.
|
||||
This gives some superficial Unix-like compatibility, but does not really add any new functionality.
|
||||
</p>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
@@ -259,7 +259,7 @@
|
||||
<h2>1.2 <a name="lines">Lines</a></h2>
|
||||
<p>
|
||||
<b>Line Endings</b>.
|
||||
Files should be formatted with <code>\n</code> as the line ending (Unix line endings), not <code>\r\n</code> (Windows line endings).
|
||||
Files should be formatted with <code>\n</code> as the line ending (Unix-style line endings), not <code>\r\n</code> (Windows line endings).
|
||||
There should be no extra whitespace at the end of the line.
|
||||
In addition, all text files should end in a single newline (<code>\n</code>). This avoids the <i>"No newline at end of file"</i> warning generated by certain tools.
|
||||
</p>
|
||||
|
||||
@@ -833,7 +833,7 @@ pid_t vfork(void);
|
||||
</p>
|
||||
<p>
|
||||
<b>POSIX Compatibility:</b>
|
||||
Compatible with the Unix interface of the same name.
|
||||
Compatible with the BSD/Linux interface of the same name. POSIX marks this interface as Obsolete.
|
||||
</p>
|
||||
|
||||
<H3><a name="exec">2.1.12 exec</a></H3>
|
||||
@@ -941,7 +941,7 @@ int execv(FAR const char *path, FAR char *const argv[]);
|
||||
<p>
|
||||
Note the inefficiency when <code>execv()</code> or <code>execl()</code> is called in the normal, two-step process:
|
||||
(1) first call <code>vfork()</code> to create a new thread, then (2) call <code>execv()</code> or <code>execl()</code> to replace the new thread with a program from the file system.
|
||||
Since the new thread will be terminated by the <code>execv()</code> or <code>execl()</code> call, it really served no purpose other than to support Unix compatibility.
|
||||
Since the new thread will be terminated by the <code>execv()</code> or <code>execl()</code> call, it really served no purpose other than to support POSIX compatibility.
|
||||
</p>
|
||||
<p>
|
||||
The non-standard binfmt function <code>exec()</code> needs to have (1) a symbol table that provides the list of symbols exported by the base code, and (2) the number of symbols in that table.
|
||||
@@ -991,7 +991,7 @@ int execv(FAR const char *path, FAR char *const argv[]);
|
||||
</p>
|
||||
<p>
|
||||
<b>POSIX Compatibility:</b>
|
||||
Similar with the Unix interface of the same name.
|
||||
Similar with the POSIX interface of the same name.
|
||||
There are, however, several compatibility issues as detailed in the description above.
|
||||
</p>
|
||||
|
||||
@@ -1035,7 +1035,7 @@ int execl(FAR const char *path, ...);
|
||||
</p>
|
||||
<p>
|
||||
<b>POSIX Compatibility:</b>
|
||||
Similar with the Unix interface of the same name.
|
||||
Similar with the POSIX interface of the same name.
|
||||
There are, however, several compatibility issues as detailed in the description of <a href="#execv">execv()</a>.
|
||||
</p>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user