You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by pr...@apache.org on 2020/10/22 13:27:40 UTC
[incubator-nuttx] 01/02: Revert "Docs: Fix broken links and
references in docs"
This is an automated email from the ASF dual-hosted git repository.
protobits pushed a commit to branch revert-2045-docfix
in repository https://gitbox.apache.org/repos/asf/incubator-nuttx.git
commit e1b440e1d8f7294bd1542956f038344a28832235
Author: Matias N <v0...@users.noreply.github.com>
AuthorDate: Thu Oct 22 10:27:31 2020 -0300
Revert "Docs: Fix broken links and references in docs"
This reverts commit 23cd1e030ef1ced162d3008baf8aae9436b8aa8d.
---
.github/workflows/doc.yml | 17 +-
Documentation/applications/nsh/commands.rst | 217 ++++-----------------
Documentation/applications/nsh/config.rst | 164 ++++++++--------
Documentation/components/binfmt.rst | 6 +-
Documentation/components/drivers/block/index.rst | 2 +-
.../components/drivers/character/index.rst | 8 +-
.../components/drivers/character/serial.rst | 2 +-
.../components/drivers/character/timer.rst | 14 +-
.../components/drivers/special/usbdev.rst | 4 +-
Documentation/components/nxflat.rst | 2 -
Documentation/components/nxgraphics/appendix.rst | 2 +-
Documentation/components/nxgraphics/index.rst | 4 +-
Documentation/components/nxwidgets.rst | 12 +-
Documentation/components/paging.rst | 2 -
Documentation/conf.py | 8 -
Documentation/guides/drivers.rst | 2 -
Documentation/guides/nfs.rst | 5 +-
Documentation/guides/tasktraceinternal.rst | 4 +-
Documentation/guides/tasktraceuser.rst | 2 +-
Documentation/guides/usbtrace.rst | 2 -
Documentation/introduction/about.rst | 2 +-
Documentation/introduction/detailed_support.rst | 48 +++--
Documentation/introduction/resources.rst | 6 +-
Documentation/quickstart/compiling.rst | 2 +-
Documentation/quickstart/organization.rst | 16 +-
Documentation/reference/os/paging.rst | 2 +-
Documentation/reference/user/01_task_control.rst | 4 +-
Documentation/reference/user/10_filesystem.rst | 4 +-
Documentation/reference/user/11_network.rst | 4 +-
Documentation/reference/user/index.rst | 8 +-
Documentation/reference/user/structures.rst | 2 +-
31 files changed, 198 insertions(+), 379 deletions(-)
diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
index a6e1b4a..0801cce 100644
--- a/.github/workflows/doc.yml
+++ b/.github/workflows/doc.yml
@@ -16,7 +16,7 @@ on:
push:
jobs:
- build-html:
+ docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v1
@@ -28,7 +28,6 @@ jobs:
cd Documentation/
pip3 install pipenv
pipenv lock -r > requirements.txt
- - uses: ammaraskar/sphinx-problem-matcher@master
- uses: ammaraskar/sphinx-action@master
with:
docs-folder: "Documentation/"
@@ -36,17 +35,3 @@ jobs:
with:
name: sphinx-docs
path: Documentation/_build/html/
- linkcheck:
- runs-on: ubuntu-latest
- steps:
- - uses: actions/checkout@v1
- - uses: actions/setup-python@v2
- with:
- python-version: '3.8'
- - uses: ammaraskar/sphinx-problem-matcher@master
- - name: Run linkcheck
- run: |
- cd Documentation/
- pip3 install pipenv
- pipenv install
- pipenv run make linkcheck
diff --git a/Documentation/applications/nsh/commands.rst b/Documentation/applications/nsh/commands.rst
index 3524128..39d642a 100644
--- a/Documentation/applications/nsh/commands.rst
+++ b/Documentation/applications/nsh/commands.rst
@@ -1,11 +1,9 @@
-========
+********
Commands
-========
-
-.. _cmdtest:
+********
Evaluate Expression (test)
-**************************
+--------------------------
**Command Syntax:**
@@ -40,10 +38,8 @@ the conditional command following the ``if`` in the
numeric-binary = integer -eq integer | integer -ge integer | integer -gt integer | integer -le integer | integer -lt integer | integer -ne integer
-.. _cmdaddroute:
-
Add a Routing Table Entry (addroute)
-************************************
+------------------------------------
**Command Syntax:**
@@ -75,8 +71,6 @@ which is equivalent to
The second form of the addroute command can be used to set the
default gateway.
-.. _cmdarp:
-
Access the ARP table (arp)
**************************
@@ -108,8 +102,6 @@ Access the ARP table (arp)
nsh> arp -a 10.0.0.1
nsh: arp: no such ARP entry: 10.0.0.1
-.. _cmdbase64dec:
-
Base64 Decode (base64dec)
*************************
@@ -119,8 +111,6 @@ Base64 Decode (base64dec)
**Synopsis**. *To be provided.*
-.. _cmdbase64enc:
-
Base64 Encode (base64enc)
*************************
@@ -130,8 +120,6 @@ Base64 Encode (base64enc)
**Synopsis**. *To be provided.*
-.. _cmdbasename:
-
Extract Base File/Directory Name (basename)
*******************************************
@@ -143,8 +131,6 @@ Extract Base File/Directory Name (basename)
removing the preceding path segments and (optionally) removing any
trailing ``<suffix>``.
-.. _cmdbreak:
-
Terminate a Loop (break)
************************
@@ -153,15 +139,13 @@ Terminate a Loop (break)
break
**Synopsis**. The ``break`` command is only meaningful within the
-body of the a ``while`` or ``until`` loop,
+body of the a `while <#looping>`__ or `until <#looping>`__ loop,
between the ``do`` and ``done`` tokens. Outside of a loop,
``break`` command does nothing. If the ``break`` command is
executed within the body of a loop, the loop will immediately
terminate and execution will continue with the next command
immediately following the ``done`` token.
-.. _cmdcat:
-
Concatenate Files (cat)
***********************
@@ -173,8 +157,6 @@ Concatenate Files (cat)
files at ``<path>`` to the console (or to another file if the
output is redirected).
-.. _cmdcd:
-
Change Current Working Directory (cd)
*************************************
@@ -198,8 +180,6 @@ Also sets the previous working directory environment variable
``cd ..`` sets the current working directory to the parent directory.
================== =====================================
-.. _cmdcmp:
-
Compare Files (cmp)
*******************
@@ -211,8 +191,6 @@ Compare Files (cmp)
with the contents of the file at ``<path2>``. Returns an
indication only if the files differ.
-.. _cmdcp:
-
Copy Files (cp)
***************
@@ -224,8 +202,6 @@ Copy Files (cp)
``<source-path>`` to the location in the file system indicated by
``<dest-path>``.
-.. _cmddate:
-
Show or set the date and time (date)
************************************
@@ -240,8 +216,6 @@ date/time: ``MMM DD HH:MM:SS YYYY``. For example,
24-hour time is used.
-.. _cmddd:
-
Copy and Convert Files (dd)
***************************
@@ -283,8 +257,6 @@ bucket::
brw-rw-rw- 0 ram0
nsh> dd if=/dev/ram0 of=/dev/null
-.. _cmddelroute:
-
Delete a Routing Table Entry (delroute)
***************************************
@@ -307,8 +279,6 @@ which is equivalent to::
nsh> delroute 11.0.0.0/24
-.. _cmddf:
-
Show Volume Status (df)
***********************
@@ -334,8 +304,6 @@ configuration, then the ``df`` will also support an option ``-h``
which may be used to show the volume information in *human
readable* format.
-.. _cmddirname:
-
Extract Path to a File/Directory (dirname)
******************************************
@@ -346,8 +314,6 @@ Extract Path to a File/Directory (dirname)
**Synopsis**. Extract the path string leading up to the full
``<path>`` by removing the final directory or file name.
-.. _cmddmesg:
-
Dump Buffered SYSLOG Output (dmesg)
***********************************
@@ -364,8 +330,6 @@ that in-memory, circular buffer to the NSH console output.
``dmesg`` has the side effect of clearing the buffered data so
that entering ``dmesg`` again will show only newly buffered data.
-.. _cmdecho:
-
Echo Strings and Variables (echo)
*********************************
@@ -379,8 +343,6 @@ output is re-directed).
The ``-n`` option suppresses the trailing newline character.
-.. _cmdenv:
-
Show Environment Variables (env)
********************************
@@ -408,8 +370,6 @@ environment. Example::
.. note::NSH local variables are *not* shown by the ``env``
command.
-.. _cmdexec:
-
Execute User Code (exec)
************************
@@ -421,8 +381,6 @@ Execute User Code (exec)
NSH will pause until the execution unless the user logic is
executed in background via ``exec <hex-address> &``.
-.. _cmdexit:
-
Exit NSH (exit)
***************
@@ -435,8 +393,6 @@ you have started some other tasks (perhaps using the ``exec``
command) and you would like to have NSH out of the way. For the
telnet front-end, ``exit`` terminates the telnet session.
-.. _cmdexport:
-
Set an Environment Variable (export)
************************************
@@ -482,8 +438,6 @@ examples:
The ``export`` command is not supported by NSH unless both
``CONFIG_NSH_VARS=y`` and ``CONFIG_DISABLE_ENVIRON``\ is not set.
-.. _cmdfree:
-
Show Memory Manager Status (free)
*********************************
@@ -508,8 +462,6 @@ free This is the total size of memory occupied by free (not in use) chunks.
largest Size of the largest free (not in use) chunk.
======= ======================================
-.. _cmdget:
-
Get File Via TFTP (get)
***********************
@@ -528,8 +480,6 @@ whose IP address is identified by ``<ip-address>``.
``-b`` Selects binary ("octet") transfer mode
=================== ============================================
-.. _cmdhelp:
-
Show Usage Command Usage (help)
*******************************
@@ -547,8 +497,6 @@ console.
``<cmd>`` Show full command usage only for this command.
========= ====================
-.. _cmdhexdump:
-
Hexadecimal Dump of File or Device (hexdump)
********************************************
@@ -568,8 +516,6 @@ The ``skip`` and ``count`` options are only available if
``CONFIG_NSH_CMDOPT_HEXDUMP`` is defined in the NuttX
configuration.
-.. _cmdifconfig:
-
Manage Network Configuration (ifconfig)
***************************************
@@ -610,8 +556,6 @@ supported:
nsh> mount -t procfs /proc
-.. _cmdifdown:
-
Take a network down (ifdown)
****************************
@@ -626,8 +570,6 @@ Take a network down (ifdown)
ifdown eth0
-.. _cmdifup:
-
Bring a network up (ifup)
*************************
@@ -642,8 +584,6 @@ Bring a network up (ifup)
ifup eth0
-.. _cmdinsmod:
-
Install an OS module (insmod)
*****************************
@@ -680,7 +620,6 @@ module <module-name>.
NAME INIT UNINIT ARG TEXT SIZE DATA SIZE
mydriver 20404659 20404625 0 20404580 552 204047a8 0
-.. _cmdirqinfo:
Show Interrupt Status (irqinfo)
*******************************
@@ -700,8 +639,6 @@ attached interrupts.
15 0000800d 00000000 817 100.000
30 00000fd5 20000018 20 2.490
-.. _cmdkill:
-
Send a signal to a task (kill)
******************************
@@ -744,8 +681,6 @@ Send a signal to a task (kill)
and to strand resource since there is insufficient clean-up in
certain build configurations.
-.. _cmdlosetup:
-
Setup/teardown the Loop Device (losetup)
****************************************
@@ -789,8 +724,6 @@ on the loop-mounted file::
**Synopsis**. Teardown the setup for the loop device at
<dev-path>.
-.. _cmdln:
-
Link to a File or Directory (ln)
********************************
@@ -802,16 +735,14 @@ Link to a File or Directory (ln)
at <link> for the existing file or directory, <target>. This
implementation is simplified for use with NuttX in these ways:
- - Links may be created only within the NuttX top-level,
- :ref:`pseudo file system <file_system_overview>` No
+ - Links may be created only within the NuttX top-level, `pseudo
+ file system <NuttXUserGuide.html#FileSystemOverview>`__. No
file system currently supported by NuttX provides symbolic
links.
- For the same reason, only soft links are implemented.
- File privileges are ignored.
- ``c_time`` is not updated.
-.. _cmdls:
-
List Directory Contents (ls)
****************************
@@ -831,8 +762,6 @@ no other file system object.
``-l`` Show size and mode information along with the filenames in the listing.
====== ================================
-.. _cmdlsmod:
-
Show information about installed OS modules (lsmod)
***************************************************
@@ -864,8 +793,6 @@ modules. This information includes:
NAME INIT UNINIT ARG TEXT SIZE DATA SIZE
mydriver 20404659 20404625 0 20404580 552 204047a8 0
-.. _cmdmd5:
-
Calculate MD5 (md5)
*******************
@@ -875,8 +802,6 @@ Calculate MD5 (md5)
**Synopsis**. *To be provided.*
-.. _cmdmx:
-
Access Memory (mb, mh, and mw)
******************************
@@ -914,8 +839,6 @@ accesses (mh), or 32-bit access (mw). In each case,
14 = 0x0c1e
nsh>
-.. _cmdps:
-
Show Current Tasks and Threads (ps)
***********************************
@@ -940,8 +863,6 @@ have been mounted with a command like::
nsh> mount -t procfs /proc
-.. _cmdmkdir:
-
Create a Directory (mkdir)
**************************
@@ -954,10 +875,10 @@ of ``<path>`` except the final directory name must exist on a
mounted file system; the final directory must not.
**Limited to Mounted File Systems**. Recall that NuttX uses a
-:ref:`pseudo file system <file_system_overview>`
+`pseudo file system <NuttXUserGuide.html#FileSystemOverview>`__
for its root file system. The ``mkdir`` command can only be used
to create directories in volumes set up with the
-:ref:`mount <cmdmount>` command; it cannot be used to create
+```mount`` <#cmdmount>`__ command; it cannot be used to create
directories in the *pseudo* file system.
**Example**::
@@ -969,8 +890,6 @@ directories in the *pseudo* file system.
drw-rw-rw- 0 TMP/
nsh>
-.. _cmdmkfatfs:
-
Create a FAT File System (mkfatfs)
**********************************
@@ -995,12 +914,11 @@ The reported number of root directory entries used with FAT32 is
zero because the FAT32 root directory is a cluster chain.
NSH provides this command to access the
-``mkfatfs()`` NuttX API. This block device must
-reside in the NuttX :ref:`pseudo file system <file_system_overview>`
-and must have been created by some call to ``register_blockdriver()``
-(see ``include/nuttx/fs/fs.h``).
-
-.. _cmdmkfifo:
+```mkfatfs()`` <mkfatfs>`__ NuttX API. This block device must
+reside in the NuttX `pseudo file
+system <NuttXUserGuide.html#FileSystemOverview>`__ and must have
+been created by some call to ``register_blockdriver()`` (see
+``include/nuttx/fs/fs.h``).
Create a FIFO (mkfifo)
**********************
@@ -1015,7 +933,7 @@ be needed to complete the ``<path>``. By convention, however,
device drivers are place in the standard ``/dev`` directory. After
it is created, the FIFO device may be used as any other device
driver. NSH provides this command to access the
-```mkfifo()`` NuttX API.
+```mkfifo()`` <NuttXUserGuide.html#mkfifo>`__ NuttX API.
**Example**::
@@ -1034,8 +952,6 @@ driver. NSH provides this command to access the
brw-rw-rw- 0 ram0
nsh>
-.. _cmdmkrd:
-
Create a RAMDISK (mkrd)
***********************
@@ -1079,8 +995,6 @@ Once the ramdisk has been created, it may be formatted using the
/tmp:
nsh>
-.. _cmdmount:
-
Mount a File System (mount)
***************************
@@ -1103,23 +1017,24 @@ way association, binding:
``<block-device>``. As of this writing, ``vfat`` is the only
supported value for ``<fstype>``
#. **Block Device.** The ``<block-device>`` argument is the full
- or relative path to a block driver inode in the
- :ref:`pseudo file system <file_system_overview>`. By
+ or relative path to a block driver inode in the `pseudo file
+ system <NuttXUserGuide.html#FileSystemOverview>`__. By
convention, this is a name under the ``/dev`` sub-directory.
This ``<block-device>`` must have been previously formatted
with the same file system type as specified by ``<fstype>``
#. **Mount Point.** The mount point, ``<dir-path>``, is the
- location in the :ref:`pseudo file system <file_system_overview>`
- where the mounted volume will appear. This mount point can only
- reside in the NuttX
- :ref:`pseudo file system <file_system_overview>`. By
+ location in the `pseudo file
+ system <NuttXUserGuide.html#FileSystemOverview>`__ where the
+ mounted volume will appear. This mount point can only reside in
+ the NuttX `pseudo file
+ system <NuttXUserGuide.html#FileSystemOverview>`__. By
convention, this mount point is a subdirectory under ``/mnt``.
The mount command will create whatever pseudo directories that
may be needed to complete the full path but the full path must
not already exist.
-After the volume has been mounted in the NuttX
-:ref:`pseudo file system <file_system_overview>`, it may be
+After the volume has been mounted in the NuttX `pseudo file
+system <NuttXUserGuide.html#FileSystemOverview>`__, it may be
access in the same way as other objects in the file system.
**Examples**:
@@ -1153,8 +1068,6 @@ Using ``mount`` to enumerate mounts::
/mnt/fs type vfat
/tmp type vfat
-.. _cmdmv:
-
Rename a File (mv)
******************
@@ -1166,8 +1079,6 @@ Rename a File (mv)
``<new-path>``. Both paths must reside in the same mounted file
system.
-.. _cmdnfsmount:
-
Mount an NFS file system (nfsmount)
***********************************
@@ -1179,8 +1090,6 @@ Mount an NFS file system (nfsmount)
at <mount-point> on the target machine. <server-address> is the IP
address of the remote server.
-.. _cmdnslookup:
-
Lookup a network address (nslookup)
***********************************
@@ -1191,8 +1100,6 @@ Lookup a network address (nslookup)
**Synopsis**. Lookup and print the IP address associated with
``<host-name>``.
-.. _cmdpasswd:
-
Change a User's Password (passwd)
*********************************
@@ -1203,8 +1110,6 @@ Change a User's Password (passwd)
**Synopsis**. Set the password for the existing user <username> to
<password>.
-.. _cmdpmconfig:
-
Manage Power Management Subsystem (pmconfig)
********************************************
@@ -1214,8 +1119,6 @@ Manage Power Management Subsystem (pmconfig)
**Synopsis**. Control power management subsystem.
-.. _cmdpoweroff:
-
Shut the system down (poweroff)
*******************************
@@ -1231,8 +1134,6 @@ to provide power off mode to board-specific power off logic.
NOTE: Supporting both the ``poweroff`` and ``shutdown`` commands
is redundant.
-.. _cmdput:
-
Send File Via TFTP (put)
************************
@@ -1252,8 +1153,6 @@ whose IP address is identified by ``<ip-address>``.
transfer mode. Default: text.
==================== =============================================
-.. _cmdpwd:
-
Show Current Working Directory (pwd)
************************************
@@ -1274,8 +1173,6 @@ Same as ``echo $PWD``::
/dev
nsh>
-.. _cmdreadlink:
-
Show target of a link (readlink)
********************************
@@ -1286,8 +1183,6 @@ Show target of a link (readlink)
**Synopsis**. Show the target of the soft link at the path
``<link>``.
-.. _cmdreboot:
-
Reboot the system (reboot)
**************************
@@ -1303,8 +1198,6 @@ a reboot mode to board-specific reboot logic.
NOTE: Supporting both the ``reboot`` and ``shutdown`` commands is
redundant.
-.. _cmdrm:
-
Remove a File (rm)
******************
@@ -1313,11 +1206,11 @@ Remove a File (rm)
rm <file-path>
**Synopsis**. Remove the specified ``<file-path>`` name from the
-mounted file system. Recall that NuttX uses a
-:ref:`pseudo file system <file_system_overview>` for its root
+mounted file system. Recall that NuttX uses a `pseudo file
+system <NuttXUserGuide.html#FileSystemOverview>`__ for its root
file system. The ``rm`` command can only be used to remove
(unlink) files in volumes set up with the
-:ref:`mount <cmdmount>` command; it cannot be used to remove
+```mount`` <#cmdmount>`__ command; it cannot be used to remove
names in the *pseudo* file system.
**Example**::
@@ -1332,8 +1225,6 @@ names in the *pseudo* file system.
TESTFILE.TXT
nsh>
-.. _cmdrmdir:
-
Remove a Directory (rmdir)
**************************
@@ -1342,11 +1233,11 @@ Remove a Directory (rmdir)
rmdir <dir-path>
**Synopsis**. Remove the specified ``<dir-path>`` directory from
-the mounted file system. Recall that NuttX uses a
-:ref:`pseudo file system <file_system_overview>` for its root
+the mounted file system. Recall that NuttX uses a `pseudo file
+system <NuttXUserGuide.html#FileSystemOverview>`__ for its root
file system. The ``rmdir`` command can only be used to remove
-directories from volumes set up with the :ref:`mount <cmdmount>`
-command it cannot be used to remove directories from the *pseudo*
+directories from volumes set up with the ```mount`` <#cmdmount>`__
+command; it cannot be used to remove directories from the *pseudo*
file system.
**Example**::
@@ -1362,8 +1253,6 @@ file system.
drw-rw-rw- 0 TESTDIR/
nsh>
-.. _cmdrmmod:
-
Remove on OS Module (rmmod)
***************************
@@ -1385,8 +1274,6 @@ busy.
NAME INIT UNINIT ARG TEXT SIZE DATA SIZE
nsh>
-.. _cmdroute:
-
Show routing table (route)
**************************
@@ -1400,8 +1287,6 @@ If only IPv4 or IPv6 is enabled, then the argument is optional
but, if provided, must match the enabled internet protocol
version.
-.. _cmdrptun:
-
Start/Stop the OpenAMP RPC Tunnel (rptun)
*****************************************
@@ -1411,8 +1296,6 @@ Start/Stop the OpenAMP RPC Tunnel (rptun)
**Synopsis**. Start or stop the OpenAMP RPC tunnel device at <dev-path>.
-.. _cmdset:
-
Set a Variable (set)
********************
@@ -1437,7 +1320,7 @@ is to set the local NSH variable. Otherwise, the group-wide environment
variable will be set.
If the local NSH variable has already been *promoted* to an environment
-variable via the :ref:`export <cmdexport>`, then the ``set`` command
+variable via the ```export`` <#cmdexport>`__, then the ``set`` command
will set the value of the environment variable rather than the local NSH
variable.
@@ -1489,8 +1372,6 @@ script commands and set foobar to foovalue::
nsh> echo $foobar
foovalue
-.. _cmdsh:
-
Execute an NSH Script (sh)
**************************
@@ -1501,8 +1382,6 @@ Execute an NSH Script (sh)
**Synopsis**. Execute the sequence of NSH commands in the file referred
to by ``<script-path>``.
-.. _cmdshutdown:
-
Shut the system down (shutdown)
*******************************
@@ -1518,8 +1397,6 @@ behavior may be supported.
NOTE: The ``shutdown`` command duplicates the behavior of the
``poweroff`` and ``eboot`` commands.
-.. _cmdsleep:
-
Wait for Seconds (sleep)
************************
@@ -1529,8 +1406,6 @@ Wait for Seconds (sleep)
**Synopsis**. Pause execution (sleep) for ``<sec>`` seconds.
-.. _cmdtelnetd:
-
Time Start the Telnet Daemon (telnetd)
**************************************
@@ -1554,8 +1429,6 @@ command line or via other applications.
In that case, when ``nsh_telnetstart()`` is called before the the
network is initialized, it will fail.
-.. _cmdtime:
-
Time execution of another command (time)
****************************************
@@ -1610,8 +1483,6 @@ command is run in background with the sleep command::
nsh>
2.0100 sec
-.. _cmdtruncate:
-
Set the Size of a File (truncate)
*********************************
@@ -1629,8 +1500,6 @@ If a <file-path> is larger than the specified size, the extra data is
lost. If a <file-path> is shorter, it is extended and the extended part
reads as zero bytes.
-.. _cmdumount:
-
Unmount a File System (umount)
******************************
@@ -1640,7 +1509,7 @@ Unmount a File System (umount)
**Synopsis**. Un-mount the file system at mount point ``<dir-path>``.
The ``umount`` command can only be used to un-mount volumes previously
-mounted using :ref:`mount <cmdmount>` command.
+mounted using ```mount`` <#cmdmount>`__ command.
**Example**::
@@ -1653,8 +1522,6 @@ mounted using :ref:`mount <cmdmount>` command.
nsh: ls: no such directory: /mnt/fs
nsh>
-.. _cmduname:
-
Print system information (uname)
********************************
@@ -1677,8 +1544,6 @@ output is the same as -s.
``-p`` Print "unknown"
========== ========================================
-.. _cmdunset:
-
Unset an Environment Variable (unset)
*************************************
@@ -1697,8 +1562,6 @@ and the group-wide environment variables. For example::
nsh>
-.. _cmdurldecode:
-
URL Decode (urldecode)
**********************
@@ -1708,8 +1571,6 @@ URL Decode (urldecode)
**Synopsis**. *To be provided.*
-.. _cmdurlencode:
-
URL Encode (urlencode)
**********************
@@ -1719,8 +1580,6 @@ URL Encode (urlencode)
**Synopsis**. *To be provided.*
-.. _cmduseradd:
-
Add a New User (useradd)
************************
@@ -1730,8 +1589,6 @@ Add a New User (useradd)
**Synopsis**. Add a new user with <username> and <password>.
-.. _cmduserdel:
-
Delete a user (userdel)
***********************
@@ -1741,8 +1598,6 @@ Delete a user (userdel)
**Synopsis**. Delete the user with the name <username>.
-.. _cmdusleep:
-
Wait for Microseconds (usleep)
******************************
@@ -1752,8 +1607,6 @@ Wait for Microseconds (usleep)
**Synopsis**. Pause execution (sleep) of ``<usec>`` microseconds.
-.. _cmdwget:
-
Get File Via HTTP (wget)
************************
@@ -1772,8 +1625,6 @@ directory.
unless <local-path> is provided.
=================== =================================================
-.. _cmdxd:
-
Hexadecimal Dump of Memory (xd)
*******************************
@@ -1810,8 +1661,6 @@ There are several built-in applications in the ``apps/`` repository. No
attempt is made here to enumerate all of them. But a few of the more
common, useful built-in applications are listed below.
-.. _cmdping:
-
Check Network Peer (ping/ping6)
*******************************
diff --git a/Documentation/applications/nsh/config.rst b/Documentation/applications/nsh/config.rst
index fd46ce6..a2a277a 100644
--- a/Documentation/applications/nsh/config.rst
+++ b/Documentation/applications/nsh/config.rst
@@ -8,19 +8,17 @@ Configuration Settings
The availability of the above commands depends upon features that may or
may not be enabled in the NuttX configuration file. The following
-:ref:`cmdtable <cmddependencies>` indicates the dependency of each command on
+`table <#cmddependencies>`__ indicates the dependency of each command on
NuttX configuration settings. General configuration settings are
-discussed in the NuttX Porting Guide.
+discussed in the `NuttX Porting Guide. <NuttXPortingGuide.html>`__
Configuration settings specific to NSH as discussed at the
-:ref:`cmdbottom <nshconfiguration>` of this document.
+`bottom <#nshconfiguration>`__ of this document.
Note that in addition to general NuttX configuration settings, each NSH
command can be individually disabled via the settings in the rightmost
column. All of these settings make the configuration of NSH potentially
complex but also allow it to squeeze into very small memory footprints.
-.. _cmddependencies:
-
Command Dependencies on Configuration Settings
==============================================
@@ -28,125 +26,125 @@ Command Dependencies on Configuration Settings
Command Depends on Configuration Can Be Disabled with
====================== =========================================== ======================
``[`` ! ``CONFIG_NSH_DISABLESCRIPT`` ``CONFIG_NSH_DISABLE_TEST``
-:ref:`cmdaddroute` ``CONFIG_NET`` && ``CONFIG_NET_ROUTE`` ``CONFIG_NSH_DISABLE_ADDROUTE``
-:ref:`cmdarp` ``CONFIG_NET`` && ``CONFIG_NET_ARP`` ``CONFIG_NSH_DISABLE_ARP``
-:ref:`cmdbase64dec` ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_BASE64DEC``
+``addroute`` ``CONFIG_NET`` && ``CONFIG_NET_ROUTE`` ``CONFIG_NSH_DISABLE_ADDROUTE``
+``arp`` ``CONFIG_NET`` && ``CONFIG_NET_ARP`` ``CONFIG_NSH_DISABLE_ARP``
+``base64dec`` ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_BASE64DEC``
``CONFIG_CODECS_BASE64``
-:ref:`cmdbase64enc` ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_BASE64ENC``
+``base64enc`` ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_BASE64ENC``
``CONFIG_CODECS_BASE64``
-:ref:`cmdbasename` . ``CONFIG_NSH_DISABLE_BASENAME``
-:ref:`cmdbreak` ! ``CONFIG_NSH_DISABLESCRIPT`` && .
+``basename`` . ``CONFIG_NSH_DISABLE_BASENAME``
+``break`` ! ``CONFIG_NSH_DISABLESCRIPT`` && .
! ``CONFIG_NSH_DISABLE_LOOPS``
-:ref:`cmdcat` ``CONFIG_NSH_DISABLE_CAT`` .
-:ref:`cmdcd` ! ``CONFIG_DISABLE_ENVIRON`` ``CONFIG_NSH_DISABLE_CD``
-:ref:`cmdcmp` ``CONFIG_NSH_DISABLE_CMP`` .
-:ref:`cmdcp` ``CONFIG_NSH_DISABLE_CP`` .
-:ref:`cmddate` ``CONFIG_NSH_DISABLE_DATE`` .
-:ref:`cmddd` ``CONFIG_NSH_DISABLE_DD`` .
-:ref:`cmddelroute` ``CONFIG_NET`` && ``CONFIG_NET_ROUTE`` ``CONFIG_NSH_DISABLE_DELROUTE``
-:ref:`cmddf` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_DF``
-:ref:`cmddirname` ``CONFIG_NSH_DISABLE_DIRNAME`` .
-:ref:`cmddmesg` ``CONFIG_RAMLOG_SYSLOG`` ``CONFIG_NSH_DISABLE_DMESG``
-:ref:`cmdecho` ``CONFIG_NSH_DISABLE_ECHO`` .
-:ref:`cmdenv` ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_ENV``
+``cat`` ``CONFIG_NSH_DISABLE_CAT`` .
+``cd`` ! ``CONFIG_DISABLE_ENVIRON`` ``CONFIG_NSH_DISABLE_CD``
+``cmp`` ``CONFIG_NSH_DISABLE_CMP`` .
+``cp`` ``CONFIG_NSH_DISABLE_CP`` .
+``date`` ``CONFIG_NSH_DISABLE_DATE`` .
+``dd`` ``CONFIG_NSH_DISABLE_DD`` .
+``delroute`` ``CONFIG_NET`` && ``CONFIG_NET_ROUTE`` ``CONFIG_NSH_DISABLE_DELROUTE``
+``df`` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_DF``
+``dirname`` ``CONFIG_NSH_DISABLE_DIRNAME`` .
+``dmesg`` ``CONFIG_RAMLOG_SYSLOG`` ``CONFIG_NSH_DISABLE_DMESG``
+``echo`` ``CONFIG_NSH_DISABLE_ECHO`` .
+``env`` ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_ENV``
! ``CONFIG_DISABLE_ENVIRON`` && |br|
! ``CONFIG_PROCFS_EXCLUDE_ENVIRON``
-:ref:`cmdexec` ``CONFIG_NSH_DISABLE_EXEC`` .
-:ref:`cmdexit` ``CONFIG_NSH_DISABLE_EXIT`` .
-:ref:`cmdexport` ``CONFIG_NSH_VARS`` &&
+``exec`` ``CONFIG_NSH_DISABLE_EXEC`` .
+``exit`` ``CONFIG_NSH_DISABLE_EXIT`` .
+``export`` ``CONFIG_NSH_VARS`` &&
! ``CONFIG_DISABLE_ENVIRON`` ``CONFIG_NSH_DISABLE_EXPORT``
-:ref:`cmdfree` ``CONFIG_NSH_DISABLE_FREE`` .
-:ref:`cmdget` ``CONFIG_NET`` && ``CONFIG_NET_UDP`` && ``CONFIG_NSH_DISABLE_GET``
+``free`` ``CONFIG_NSH_DISABLE_FREE`` .
+``get`` ``CONFIG_NET`` && ``CONFIG_NET_UDP`` && ``CONFIG_NSH_DISABLE_GET``
*MTU* >= 58\ [#1]_
-:ref:`cmdhelp` [#3]_ ``CONFIG_NSH_DISABLE_HELP`` .
-:ref:`cmdhexdump` ``CONFIG_NSH_DISABLE_HEXDUMP`` .
-:ref:`cmdifconfig` ``CONFIG_NET`` && ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_IFCONFIG``
+``help`` [#3]_ ``CONFIG_NSH_DISABLE_HELP`` .
+``hexdump`` ``CONFIG_NSH_DISABLE_HEXDUMP`` .
+``ifconfig`` ``CONFIG_NET`` && ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_IFCONFIG``
! ``CONFIG_FS_PROCFS_EXCLUDE_NET``
-:ref:`cmdifdown` ``CONFIG_NET`` && ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_IFUPDOWN``
+``ifdown`` ``CONFIG_NET`` && ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_IFUPDOWN``
! ``CONFIG_FS_PROCFS_EXCLUDE_NET``
-:ref:`cmdifup` ``CONFIG_NET`` && ``CONFIG_FS_PROCFS`` &&
+``ifup`` ``CONFIG_NET`` && ``CONFIG_FS_PROCFS`` &&
! ``CONFIG_FS_PROCFS_EXCLUDE_NET`` ``CONFIG_NSH_DISABLE_IFUPDOWN``
-:ref:`cmdinsmod` ``CONFIG_MODULE`` ``CONFIG_NSH_DISABLE_MODCMDS``
-:ref:`cmdirqinfo` ! ``CONFIG_DISABLE_MOUNTPOINT`` && .
+``insmod`` ``CONFIG_MODULE`` ``CONFIG_NSH_DISABLE_MODCMDS``
+``irqinfo`` ! ``CONFIG_DISABLE_MOUNTPOINT`` && .
``CONFIG_FS_PROCFS`` && |br|
``CONFIG_SCHED_IRQMONITOR``
-:ref:`cmdkill` ``CONFIG_NSH_DISABLE_KILL`` .
-:ref:`cmdlosetup` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_LOSETUP``
+``kill`` ``CONFIG_NSH_DISABLE_KILL`` .
+``losetup`` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_LOSETUP``
``CONFIG_DEV_LOOP``
-:ref:`cmdln` ``CONFIG_PSEUDOFS_SOFTLINKS`` ``CONFIG_NSH_DISABLE_LN``
-:ref:`cmdls` ``CONFIG_NSH_DISABLE_LS`` .
-:ref:`cmdlsmod` ``CONFIG_MODULE`` && ``CONFIG_FS_PROCFS`` ``CONFIG_NSH_DISABLE_MODCMDS``
+``ln`` ``CONFIG_PSEUDOFS_SOFTLINKS`` ``CONFIG_NSH_DISABLE_LN``
+``ls`` ``CONFIG_NSH_DISABLE_LS`` .
+``lsmod`` ``CONFIG_MODULE`` && ``CONFIG_FS_PROCFS`` ``CONFIG_NSH_DISABLE_MODCMDS``
&& |br|
! ``CONFIG_FS_PROCFS_EXCLUDE_MODULE``
-:ref:`cmdmd5` ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_MD5``
+``md5`` ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_MD5``
``CONFIG_CODECS_HASH_MD5``
-:ref:`cmdmx` . ``CONFIG_NSH_DISABLE_MB``, |br|
+``mb,mh,mw`` . ``CONFIG_NSH_DISABLE_MB``, |br|
``CONFIG_NSH_DISABLE_MH``, |br|
``CONFIG_NSH_DISABLE_MW``
-:ref:`cmdmkdir` (! ``CONFIG_DISABLE_MOUNTPOINT`` \|\| ``CONFIG_NSH_DISABLE_MKDIR``
+``mkdir`` (! ``CONFIG_DISABLE_MOUNTPOINT`` \|\| ``CONFIG_NSH_DISABLE_MKDIR``
! ``CONFIG_DISABLE_PSEUDOFS_OPERATIONS``)
-:ref:`cmdmkfatfs` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_MKFATFS``
+``mkfatfs`` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_MKFATFS``
``CONFIG_FSUTILS_MKFATFS``
-:ref:`cmdmkfifo` ``CONFIG_PIPES`` && ``CONFIG_NSH_DISABLE_MKFIFO``
+``mkfifo`` ``CONFIG_PIPES`` && ``CONFIG_NSH_DISABLE_MKFIFO``
``CONFIG_DEV_FIFO_SIZE`` > 0
-:ref:`cmdmkrd` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_MKRD``
-:ref:`cmdmount` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_MOUNT``
-:ref:`cmdmv` ! ``CONFIG_DISABLE_MOUNTPOINT`` \|\| ``CONFIG_NSH_DISABLE_MV``
+``mkrd`` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_MKRD``
+``mount`` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_MOUNT``
+``mv`` ! ``CONFIG_DISABLE_MOUNTPOINT`` \|\| ``CONFIG_NSH_DISABLE_MV``
! ``CONFIG_DISABLE_PSEUDOFS_OPERATIONS``
-:ref:`cmdnfsmount` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_NFSMOUNT``
+``nfsmount`` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_NFSMOUNT``
``CONFIG_NET`` && ``CONFIG_NFS``
-:ref:`cmdnslookup` ``CONFIG_LIBC_NETDB`` && ``CONFIG_NSH_DISABLE_NSLOOKUP``
+``nslookup`` ``CONFIG_LIBC_NETDB`` && ``CONFIG_NSH_DISABLE_NSLOOKUP``
``CONFIG_NETDB_DNSCLIENT``
-:ref:`cmdpasswd` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_PASSWD``
+``passwd`` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_PASSWD``
``CONFIG_NSH_LOGIN_PASSWD``
-:ref:`cmdpmconfig` ``CONFIG_PM`` ``CONFIG_NSH_DISABLE_PMCONFIG``
-:ref:`cmdpoweroff` ``CONFIG_BOARDCTL_POWEROFF`` ``CONFIG_NSH_DISABLE_POWEROFF``
-:ref:`cmdps` ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_PS``
+``pmconfig`` ``CONFIG_PM`` ``CONFIG_NSH_DISABLE_PMCONFIG``
+``poweroff`` ``CONFIG_BOARDCTL_POWEROFF`` ``CONFIG_NSH_DISABLE_POWEROFF``
+``ps`` ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_PS``
! ``CONFIG_FS_PROCFS_EXCLUDE_PROC``
-:ref:`cmdput` ``CONFIG_NET`` && ``CONFIG_NET_UDP`` && ``CONFIG_NSH_DISABLE_PUT``
+``put`` ``CONFIG_NET`` && ``CONFIG_NET_UDP`` && ``CONFIG_NSH_DISABLE_PUT``
``MTU >= 558`` [#1]_, [#2]_
-:ref:`cmdpwd` ! ``CONFIG_DISABLE_ENVIRON`` ``CONFIG_NSH_DISABLE_PWD``
-:ref:`cmdreadlink` ``CONFIG_PSEUDOFS_SOFTLINKS`` ``CONFIG_NSH_DISABLE_READLINK``
-:ref:`cmdreboot` ``CONFIG_BOARD_RESET`` ``CONFIG_NSH_DISABLE_REBOOT``
-:ref:`cmdrm` ! ``CONFIG_DISABLE_MOUNTPOINT`` \|\| ``CONFIG_NSH_DISABLE_RM``
+``pwd`` ! ``CONFIG_DISABLE_ENVIRON`` ``CONFIG_NSH_DISABLE_PWD``
+``readlink`` ``CONFIG_PSEUDOFS_SOFTLINKS`` ``CONFIG_NSH_DISABLE_READLINK``
+``reboot`` ``CONFIG_BOARD_RESET`` ``CONFIG_NSH_DISABLE_REBOOT``
+``rm`` ! ``CONFIG_DISABLE_MOUNTPOINT`` \|\| ``CONFIG_NSH_DISABLE_RM``
! ``CONFIG_DISABLE_PSEUDOFS_OPERATIONS``
-:ref:`cmdrmdir` ! ``CONFIG_DISABLE_MOUNTPOINT`` \|\
+``rmdir`` ! ``CONFIG_DISABLE_MOUNTPOINT`` \|\
! ``CONFIG_DISABLE_PSEUDOFS_OPERATIONS`` ``CONFIG_NSH_DISABLE_RMDIR``
-:ref:`cmdrmmod` ``CONFIG_MODULE`` ``CONFIG_NSH_DISABLE_MODCMDS``
-:ref:`cmdroute` ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_ROUTE``
+``rmmod`` ``CONFIG_MODULE`` ``CONFIG_NSH_DISABLE_MODCMDS``
+``route`` ``CONFIG_FS_PROCFS`` && ``CONFIG_NSH_DISABLE_ROUTE``
``CONFIG_FS_PROCFS_EXCLUDE_NET`` && |br|
! ``CONFIG_FS_PROCFS_EXCLUDE_ROUTE`` &&
``CONFIG_NET_ROUTE`` && |br|
! ``CONFIG_NSH_DISABLE_ROUTE`` && |br|
(``CONFIG_NET_IPv4`` \|\
``CONFIG_NET_IPv6``)
-:ref:`cmdrptun` ``CONFIG_RPTUN`` ``CONFIG_NSH_DISABLE_RPTUN``
-:ref:`cmdset` ``CONFIG_NSH_VARS`` \|\| ``CONFIG_NSH_DISABLE_SET``
+``rptun`` ``CONFIG_RPTUN`` ``CONFIG_NSH_DISABLE_RPTUN``
+``set`` ``CONFIG_NSH_VARS`` \|\| ``CONFIG_NSH_DISABLE_SET``
! ``CONFIG_DISABLE_ENVIRON``
-:ref:`cmdshutdown` ``CONFIG_BOARDCTL_POWEROFF`` \|\| ``CONFIG_NSH_DISABLE_SHUTDOWN``
+``shutdown`` ``CONFIG_BOARDCTL_POWEROFF`` \|\| ``CONFIG_NSH_DISABLE_SHUTDOWN``
``CONFIG_BOARD_RESET``
-:ref:`cmdsleep` . ``CONFIG_NSH_DISABLE_SLEEP``
-``cmdsource`` ``CONFIG_FILE_STREAM`` && ``CONFIG_NSH_DISABLE_SOURCE``
+``sleep`` . ``CONFIG_NSH_DISABLE_SLEEP``
+``source`` ``CONFIG_FILE_STREAM`` && ``CONFIG_NSH_DISABLE_SOURCE``
! ``CONFIG_NSH_DISABLESCRIPT``
-:ref:`cmdtelnetd` ``CONFIG_NSH_TELNET`` ``CONFIG_NSH_DISABLE_TELNETD``
-:ref:`cmdtest` ! ``CONFIG_NSH_DISABLESCRIPT`` ``CONFIG_NSH_DISABLE_TEST``
-:ref:`cmdtime` . ``CONFIG_NSH_DISABLE_TIME``
-:ref:`cmdtruncate` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_TRUNCATE``
-:ref:`cmdumount` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_UMOUNT``
-:ref:`cmduname` . ``CONFIG_NSH_DISABLE_UNAME``
-:ref:`cmdunset` ``CONFIG_NSH_VARS`` \|\| ``CONFIG_NSH_DISABLE_UNSET``
+``telnetd`` ``CONFIG_NSH_TELNET`` ``CONFIG_NSH_DISABLE_TELNETD``
+``test`` ! ``CONFIG_NSH_DISABLESCRIPT`` ``CONFIG_NSH_DISABLE_TEST``
+``time`` . ``CONFIG_NSH_DISABLE_TIME``
+``truncate`` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_TRUNCATE``
+``umount`` ! ``CONFIG_DISABLE_MOUNTPOINT`` ``CONFIG_NSH_DISABLE_UMOUNT``
+``uname`` . ``CONFIG_NSH_DISABLE_UNAME``
+``unset`` ``CONFIG_NSH_VARS`` \|\| ``CONFIG_NSH_DISABLE_UNSET``
! ``CONFIG_DISABLE_ENVIRON``
-:ref:`cmdurldecode` ! ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_URLDECODE``
+``urldecode`` ! ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_URLDECODE``
``CONFIG_CODECS_URLCODE``
-:ref:`cmdurlencode` ! ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_URLENCODE``
+``urlencode`` ! ``CONFIG_NETUTILS_CODECS`` && ``CONFIG_NSH_DISABLE_URLENCODE``
``CONFIG_CODECS_URLCODE``
-:ref:`cmduseradd` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_USERADD``
+``useradd`` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_USERADD``
``CONFIG_NSH_LOGIN_PASSWD``
-:ref:`cmduserdel` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_USERDEL``
+``userdel`` ! ``CONFIG_DISABLE_MOUNTPOINT`` && ``CONFIG_NSH_DISABLE_USERDEL``
``CONFIG_NSH_LOGIN_PASSWD``
-:ref:`cmdusleep` . ``CONFIG_NSH_DISABLE_USLEEP``
-:ref:`cmdwget` ``CONFIG_NET`` && ``CONFIG_NET_TCP`` ``CONFIG_NSH_DISABLE_WGET``
-:ref:`cmdxd` . ``CONFIG_NSH_DISABLE_XD``
+``usleep`` . ``CONFIG_NSH_DISABLE_USLEEP``
+``wget`` ``CONFIG_NET`` && ``CONFIG_NET_TCP`` ``CONFIG_NSH_DISABLE_WGET``
+``xd`` . ``CONFIG_NSH_DISABLE_XD``
====================== =========================================== ======================
.. [#1] Because of hardware padding, the actual required packet size may be larger
@@ -167,8 +165,6 @@ Command Depends on Configuration
``ping6`` ``CONFIG_NET`` && ``CONFIG_NET_ICMPv6`` && ``CONFIG_NET_ICMPv6_SOCKET`` && ``CONFIG_SYSTEM_PING6``
============= ==================================================================================================
-.. _nshconfiguration:
-
NSH-Specific Configuration Settings
===================================
@@ -253,7 +249,7 @@ Configuration Description
command works very must like the set command except that is
operates on environment variables. When CONFIG_NSH_VARS
is enabled, there are changes in the behavior of certain commands.
- See following :ref:`cmdtable <nsh_vars_table>`.
+ See following :ref:`table <nsh_vars_table>`.
``CONFIG_NSH_QUOTE`` Enables back-slash quoting of certain characters within the
command. This option is useful for the case where an NSH script
diff --git a/Documentation/components/binfmt.rst b/Documentation/components/binfmt.rst
index d109a70..61b6f65 100644
--- a/Documentation/components/binfmt.rst
+++ b/Documentation/components/binfmt.rst
@@ -1,5 +1,3 @@
-.. _binfmt:
-
=============
Binary Loader
=============
@@ -28,8 +26,8 @@ At present, the following binary formats are support by NuttX:
- **ELF**. Standard ELF formatted files.
- **NXFLAT**. NuttX NXFLAT formatted files. More information about the
- NXFLAT binary format can be found in the :ref:`NXFLAT
- documentation <nxflat>`.
+ NXFLAT binary format can be found in the `NXFLAT
+ documentation <NuttXNxFlat.html>`__.
**Executables and Libraries** The generic binary loader logic does not
care what it is that it being loaded. It could load an executable
diff --git a/Documentation/components/drivers/block/index.rst b/Documentation/components/drivers/block/index.rst
index f82ca26..51a09ec 100644
--- a/Documentation/components/drivers/block/index.rst
+++ b/Documentation/components/drivers/block/index.rst
@@ -14,7 +14,7 @@ Block device drivers have these properties:
- ``int register_blockdriver(const char *path, const struct block_operations *bops, mode_t mode, void *priv);``.
Each block driver registers itself by calling
``register_blockdriver()``, passing it the ``path`` where it
- will appear in the :ref:`pseudo file system <file_system_overview>` and
+ will appear in the `pseudo-file-system <#NxFileSystem>`__ and
it's initialized instance of ``struct block_operations``.
- **User Access**. Users do not normally access block drivers
diff --git a/Documentation/components/drivers/character/index.rst b/Documentation/components/drivers/character/index.rst
index d72b6cc..6983fbb 100644
--- a/Documentation/components/drivers/character/index.rst
+++ b/Documentation/components/drivers/character/index.rst
@@ -1,5 +1,3 @@
-.. _chardev:
-
========================
Character Device Drivers
========================
@@ -17,12 +15,12 @@ Character device drivers have these properties:
- ``int register_driver(const char *path, const struct file_operations *fops, mode_t mode, void *priv);``.
Each character driver registers itself by calling
``register_driver()``, passing it the ``path`` where it will
- appear in the :ref:`pseudo file system <file_system_overview>` and it's
+ appear in the `pseudo-file-system <#NxFileSystem>`__ and it's
initialized instance of ``struct file_operations``.
- **User Access**. After it has been registered, the character
- driver can be accessed by user code using the standard driver
- operations including
+ driver can be accessed by user code using the standard `driver
+ operations <NuttXUserGuide.html#driveroperations>`__ including
``open()``, ``close()``, ``read()``, ``write()``, etc.
- **Specialized Character Drivers**. Within the common character
diff --git a/Documentation/components/drivers/character/serial.rst b/Documentation/components/drivers/character/serial.rst
index f45e45a..2d1f5eb 100644
--- a/Documentation/components/drivers/character/serial.rst
+++ b/Documentation/components/drivers/character/serial.rst
@@ -13,7 +13,7 @@ Serial Device Drivers
- ``int uart_register(FAR const char *path, FAR uart_dev_t *dev);``.
A serial driver may register itself by calling
``uart_register()``, passing it the ``path`` where it will
- appear in the :ref:`pseudo file system <file_system_overview>` and it's
+ appear in the `pseudo-file-system <#NxFileSystem>`__ and it's
initialized instance of ``struct uart_ops_s``. By convention,
serial device drivers are registered at paths like
``/dev/ttyS0``, ``/dev/ttyS1``, etc. See the
diff --git a/Documentation/components/drivers/character/timer.rst b/Documentation/components/drivers/character/timer.rst
index 4ca1256..c557d00 100644
--- a/Documentation/components/drivers/character/timer.rst
+++ b/Documentation/components/drivers/character/timer.rst
@@ -56,7 +56,7 @@ Timer Example
The previously selected example will basically consult the timer status, set a timer alarm interval, set a timer signal handler function to be notified at the alarm, which only increments a variable, and then it will start the timer. The application will periodically consult the timer status at the sample rate previously configured through the ``menuconfig`` to follow the time left until the timer expires. After the samples have been read, the application stops de timer.
-The `example code <https://github.com/apache/incubator-nuttx-apps/blob/master/examples/timer/timer_main.c>`_ may be explored, its path is at ``/examples/timer/timer_main.c`` in the apps' repository.
+The `example code <https://github.com/apache/incubator-nuttx-apps/blob/master/examples/timer/timer_main.c#ref-example>`_ may be explored, its path is at ``/examples/timer/timer_main.c`` in the apps' repository.
In NuttX, the timer driver is a character driver and when a chip supports multiple timers, each one is accessible through its respective file in ``/dev`` directory. Each timer is registered using a unique numeric identifier (i.e. ``/dev/timer0``, ``/dev/timer1``, ...).
@@ -84,12 +84,12 @@ The first necessary thing to be done in order to use the timer driver in an appl
At an application level, the timer functionalities may be accessed through ``ioctl`` systems calls. The available ``ioctl`` commands are:
- * :c:macro:`TCIOC_START`
- * :c:macro:`TCIOC_STOP`
- * :c:macro:`TCIOC_GETSTATUS`
- * :c:macro:`TCIOC_SETTIMEOUT`
- * :c:macro:`TCIOC_NOTIFICATION`
- * :c:macro:`TCIOC_MAXTIMEOUT`
+.. c:macro:: TCIOC_START
+.. c:macro:: TCIOC_STOP
+.. c:macro:: TCIOC_GETSTATUS
+.. c:macro:: TCIOC_SETTIMEOUT
+.. c:macro:: TCIOC_NOTIFICATION
+.. c:macro:: TCIOC_MAXTIMEOUT
These ``ioctl`` commands internally call lower-half layer operations and the parameters are forwarded to these ops through the ``ioctl`` system call. The return of a system call is the return of an operation.
These ``struct timer_ops_s`` keeps pointers to the implementation of each operation. Following is the struct.
diff --git a/Documentation/components/drivers/special/usbdev.rst b/Documentation/components/drivers/special/usbdev.rst
index 589a60b..23c0a6a 100644
--- a/Documentation/components/drivers/special/usbdev.rst
+++ b/Documentation/components/drivers/special/usbdev.rst
@@ -8,8 +8,8 @@ USB Device-Side Drivers
- ``include/nuttx/usb/usbdev_trace.h``. Declarations needed
to work with the NuttX USB device driver trace capability. That
- USB trace capability is detailed in :ref:`separate
- document <usbtrace>`.
+ USB trace capability is detailed in `separate
+ document <UsbTrace.html>`__.
- ``struct usbdev_s``. Each USB device controller driver must
implement an instance of ``struct usbdev_s``. This structure is
diff --git a/Documentation/components/nxflat.rst b/Documentation/components/nxflat.rst
index ca1dffd..f7547cb 100644
--- a/Documentation/components/nxflat.rst
+++ b/Documentation/components/nxflat.rst
@@ -1,5 +1,3 @@
-.. _nxflat:
-
======
NXFLAT
======
diff --git a/Documentation/components/nxgraphics/appendix.rst b/Documentation/components/nxgraphics/appendix.rst
index ec0e4b8..6167f86 100644
--- a/Documentation/components/nxgraphics/appendix.rst
+++ b/Documentation/components/nxgraphics/appendix.rst
@@ -46,7 +46,7 @@ provided in sub-directories under ``nuttx/libnx``.
built on top of NX and works with the multi-user NX front-end. See
``include/nuttx/nx/nxtk.h``.
``apps/graphics/NxWidgets``
- The :ref:`NxWidgets <nxwidgets>` code is provided as a separate
+ The `NxWidgets <NxWidgets.html>`__ code is provided as a separate
package provided in the ``apps/`` repository.
``graphics/nxterm``
The NxTerm driver is built on top of NX and works with the multi-user
diff --git a/Documentation/components/nxgraphics/index.rst b/Documentation/components/nxgraphics/index.rst
index 7c0614b..aecda44 100644
--- a/Documentation/components/nxgraphics/index.rst
+++ b/Documentation/components/nxgraphics/index.rst
@@ -1,5 +1,3 @@
-.. _nxgraphics:
-
=====================
NX Graphics Subsystem
=====================
@@ -137,7 +135,7 @@ than some utilities and types from NXGLIB.
NX Widgets (``NxWidgets``)
--------------------------
-:ref:`NxWidgets <nxwidgets>` is a higher level, C++, object-oriented
+`NxWidgets <NxWidgets.html>`__ is a higher level, C++, object-oriented
library for object-oriented access to graphical "widgets." NxWidgets is
provided as a separate library in the ``apps/`` repository NxWidgets is
built on top of the core NuttX graphics subsystem, but is part of the
diff --git a/Documentation/components/nxwidgets.rst b/Documentation/components/nxwidgets.rst
index 6db9cb6..ce88051 100644
--- a/Documentation/components/nxwidgets.rst
+++ b/Documentation/components/nxwidgets.rst
@@ -1,13 +1,11 @@
-.. _nxwidgets:
-
=========
NxWidgets
=========
In order to better support NuttX based platforms, a special graphical
userinterface has been created called NXWidgets. NXWidgets is written in
-C++ and integrates seamlessly with the NuttX :ref:`NX graphics
-subsystem <nxgraphics>` in order to provide graphic
+C++ and integrates seamlessly with the NuttX `NX graphics
+subsystem <NXGraphicsSubsystem.html>`__ in order to provide graphic
objects, or "widgets," in the NX Graphics Subsystem
Some of the features of NXWidgets include:
@@ -16,8 +14,8 @@ Some of the features of NXWidgets include:
only selected "embedded friendly" C++ constructs that are fully
supported under NuttX. No additional C++ support libraries are
required.
-- **NX Integration**. NXWidgets integrate seamlessly with the
- :ref:`NX graphics subsystem <nxgraphics>`. Think of the X
+- **NX Integration**. NXWidgets integrate seamlessly with the `NX
+ graphics subsystem <NXGraphicsSubsystem.html>`__. Think of the X
server under Linux … the NX graphics system is like a tiny X server
that provides windowing under NuttX. By adding NXWidgets, you can
support graphics objects like buttons and text boxes in the NX
@@ -42,7 +40,7 @@ Some of the features of NXWidgets include:
- **DOxygen Documentation** DOxygen documentation is available.
Note: Many of the fundamental classed in NxWidgets derive from the
-Antony Dzeryn's "Woopsi" project which also has a
+Antony Dzeryn's "Woopsi" project: http://woopsi.org/ which also has a
BSD style license. See the COPYING file for details.
NXWidgets Doxygen Documentation
diff --git a/Documentation/components/paging.rst b/Documentation/components/paging.rst
index 5aa55fb..ecede3a 100644
--- a/Documentation/components/paging.rst
+++ b/Documentation/components/paging.rst
@@ -1,5 +1,3 @@
-.. _ondemandpaging:
-
================
On-Demand Paging
================
diff --git a/Documentation/conf.py b/Documentation/conf.py
index 734e95b..40cda45 100644
--- a/Documentation/conf.py
+++ b/Documentation/conf.py
@@ -117,11 +117,3 @@ c_id_attributes = [
'noreturn_function'
]
-# This is required to allow running linkcheck with sphinx-tabs
-sphinx_tabs_valid_builders = ['linkcheck']
-
-# There are some sites where the linkchecker cannot handle anchors
-linkcheck_ignore = [
- 'https://github.com/pyenv/pyenv#installation',
- 'http://openocd.zylin.com/#/c/4103/',
-]
diff --git a/Documentation/guides/drivers.rst b/Documentation/guides/drivers.rst
index 4ff167f..983c701 100644
--- a/Documentation/guides/drivers.rst
+++ b/Documentation/guides/drivers.rst
@@ -7,8 +7,6 @@ Drivers
Some NuttX boards don't have full support for all the on-chip peripherals. If you need support for this hardware,
you will either need to port a driver from another chip, or write one yourself. This section discusses how to do that.
-.. _drivers-porting:
-
Porting a Driver
----------------
diff --git a/Documentation/guides/nfs.rst b/Documentation/guides/nfs.rst
index d603613..fda1a84 100644
--- a/Documentation/guides/nfs.rst
+++ b/Documentation/guides/nfs.rst
@@ -26,7 +26,8 @@ Mount Interface
A low-level, C-callable interface is provided to mount a file system.
That interface is called ``mount()`` and is mentioned in the
-porting guide and is prototyped in the header file ``include/sys/mount.h``:
+```porting guide`` <NuttXPortingGuide.html#NxFileSystem>`__ and is
+prototyped in the header file ``include/sys/mount.h``:
.. c:function:: int mount(const char *source, const char *target, const char *filesystemtype, unsigned long mountflags, const void *data)
@@ -107,7 +108,7 @@ is defined as:
NFS Mount Command
=================
-The :ref:`NuttShell (NSH) <nsh>` also supports a command called
+The `NuttShell (NSH) <NuttShell.html>`__ also supports a command called
``nfsmount`` that can be used to mount a remote file system via the NSH
command line.
diff --git a/Documentation/guides/tasktraceinternal.rst b/Documentation/guides/tasktraceinternal.rst
index d2eefd6..3e01598 100644
--- a/Documentation/guides/tasktraceinternal.rst
+++ b/Documentation/guides/tasktraceinternal.rst
@@ -42,14 +42,14 @@ Noteram device driver (``nuttx/drivers/note/noteram_driver.c``)
- Accumurate incoming note records into the buffer.
- Read the note records from the buffer by user requests.
- The notes are recorded in the binary format of ``struct note_*_s``.
-- The detail function is described in :doc:`../components/drivers/character/note`.
+- The detail function is described in :doc:`../reference/os/note`.
Notectl device driver (``nuttx/drivers/note/notectl_driver.c``)
---------------------------------------------------------------
- ``/dev/notectl`` device driver.
- Control the filter logic in ``sched_note.c`` by calling note filter APIs.
-- The detail function is described in :doc:`../components/drivers/character/note`.
+- The detail function is described in :doc:`../reference/os/note`.
"``trace``" Built-In Application (``apps/system/trace/trace.c``)
----------------------------------------------------------------
diff --git a/Documentation/guides/tasktraceuser.rst b/Documentation/guides/tasktraceuser.rst
index a17657f..b04db80 100644
--- a/Documentation/guides/tasktraceuser.rst
+++ b/Documentation/guides/tasktraceuser.rst
@@ -59,7 +59,7 @@ The following configurations are configurable parameters for trace.
After the configuration, rebuild the NuttX kernel and application.
-If the trace function is enabled, "``trace``" :doc:`../applications/nsh/builtin` will be available.
+If the trace function is enabled, "``trace``" :doc:`../components/nsh/builtin` will be available.
How to get trace data
=====================
diff --git a/Documentation/guides/usbtrace.rst b/Documentation/guides/usbtrace.rst
index 2935845..0140a72 100644
--- a/Documentation/guides/usbtrace.rst
+++ b/Documentation/guides/usbtrace.rst
@@ -1,5 +1,3 @@
-.. _usbtrace:
-
================
USB Device Trace
================
diff --git a/Documentation/introduction/about.rst b/Documentation/introduction/about.rst
index fdee8aa..1cd8097 100644
--- a/Documentation/introduction/about.rst
+++ b/Documentation/introduction/about.rst
@@ -222,7 +222,7 @@ Key features of NuttX include:
The following packages are available to extend the basic NuttX feature set:
* **NuttShell (NSH)**
- A small, scalable, bash-like shell for NuttX with rich feature set and small footprint. See the :doc:`/applications/nsh/index`.
+ A small, scalable, bash-like shell for NuttX with rich feature set and small footprint. See the :doc:`/components/nsh/index`.
* **BAS 2.4**
Seamless integration of Michael Haardt's BAS 2.4: "Bas is an interpreter for the classic dialect of the programming language BASIC. It is pretty compatible to typical BASIC interpreters of the 1980s, unlike some other UNIX BASIC interpreters, that implement a different syntax, breaking compatibility to existing programs. Bas offers many ANSI BASIC statements for structured programming, such as procedures, local variables and various loop types. Further there are matrix operations, au [...]
diff --git a/Documentation/introduction/detailed_support.rst b/Documentation/introduction/detailed_support.rst
index a9948cc..4c49ff2 100644
--- a/Documentation/introduction/detailed_support.rst
+++ b/Documentation/introduction/detailed_support.rst
@@ -70,7 +70,8 @@ TI TMS320-DM320
(also called **DM320**)
NuttX operates on the ARM9 of
-this dual core processor. This port uses the Neuros OSD
+this dual core processor. This port uses the `Neuros
+OSD <http://wiki.neurostechnology.com/index.php/Developer_Welcome>`__
with a GNU arm-nuttx-elf toolchain\* under Linux or Cygwin. The port was
performed using the OSD v1.0, development board.
@@ -79,12 +80,15 @@ NXP LPC3131
Two boards based on the NXP LPC3131 are supported:
-- First, a port for the NXP LPC3131
- on the Embedded Artists EA3131
+- First, a port for the NXP
+ `LPC3131 <http://ics.nxp.com/products/lpc3000/lpc313x.lpc314x.lpc315x/>`__
+ on the `Embedded Artists
+ EA3131 <http://www.embeddedartists.com/products/kits/lpc3131_kit.php>`__
development board was first released in NuttX-5.1 (but was not
functional until NuttX-5.2).
-- A second port to the NXP LPC3131
+- A second port to the NXP
+ `LPC3131 <http://ics.nxp.com/products/lpc3000/lpc313x.lpc314x.lpc315x/>`__
on the `Olimex
LPC-H3131 <https://www.olimex.com/Products/ARM/NXP/LPC-H3131/>`__
development board was added in NuttX-6.32.
@@ -92,7 +96,8 @@ Two boards based on the NXP LPC3131 are supported:
NXP LPC315x
-----------
-Support for the NXP LPC315x
+Support for the NXP
+`LPC315x <http://ics.nxp.com/products/lpc3000/lpc313x.lpc314x.lpc315x/>`__
family has been incorporated into the code base as of NuttX-6.4. Support
was added for the Embedded Artists EA3152 board in NuttX-6.11.
@@ -510,7 +515,7 @@ TI/Stellaris LM3S6432S2E
------------------------
This port uses Serial-to-Ethernet Reference
-Design Kit and has
+Design Kit (`RDK-S2E <http://www.ti.com/tool/rdk-s2e>`__) and has
similar support as for the other Stellaris family members. A
configuration is available for the NuttShell (NSH) (see :ref:`NSH <nsh>`). The NSH
configuration including networking support with a Telnet NSH console.
@@ -520,7 +525,7 @@ TI/Stellaris LM3S6918
---------------------
This port uses the
-`Micromint <http://www.micromint.com/>`__ Eagle-100 development board
+`Micromint <%20http://www.micromint.com/>`__ Eagle-100 development board
with a GNU arm-nuttx-elf toolchain\* under either Linux or Cygwin.
**Development Environments:** 1) Linux with native Linux GNU toolchain,
@@ -618,7 +623,7 @@ This is a port for the Silicon Laboratories' EFM32
required to make further progress in testing.
Refer to the Olimex EFM32G880F120-STK
- `README.txt <https://github.com/apache/incubator-nuttx/blob/master/boards/arm/efm32/olimex-efm32g880f128-stk/README.txt>`__
+ `README.txt <https://github.com/apache/incubator-nuttx/blob/master/boards/arm/efm32/olimex-efm32g880f129-stk/README.txt>`__
for further information.
SiLabs EFM32 Giant Gecko
@@ -845,7 +850,7 @@ specifically for: STM32F103ZET6, STM32F103RET6, STM32F103VCT,
STM32F103VET6, STM32F103RBT6, and STM32103CBT6. Boards supported
include:
-#. **STM3210E-EVAL**. A port for the `STMicro <http://www.st.com/>`__
+#. **STM3210E-EVAL**. A port for the `STMicro <%20http://www.st.com/>`__
STM3210E-EVAL development board that features the STM32F103ZET6 MCU.
Refer to the NuttX board
`README <https://github.com/apache/incubator-nuttx/blob/master/boards/arm/stm32/stm3210e-eval/README.txt>`__
@@ -957,8 +962,8 @@ board
`README <https://github.com/apache/incubator-nuttx/blob/master/boards/arm/stm32/shenzhou/README.txt>`__
file for further information.
-**ViewTool STM32F103/F107** Support for the Viewtool
-STM32F103/F107 board was added in
+**ViewTool STM32F103/F107** Support for the `Viewtool
+STM32F103/F107 <https://http://www.viewtool.com/>`__ board was added in
NuttX-6.32. That board features the STMicro STM32F107VCT6 MCU.
Networking, LCD, and touchscreen support were added in NuttX-6.33.
@@ -1179,6 +1184,7 @@ boards.
This board configuration was contributed and made available in
NuttX-6.20. As contributed board support, I am unsure of what all has
been verfied and what has not. See the Microment website
+ `Lincoln60 <http://micromint.com/Products/lincoln60.html>`__ board
and the NuttX board
`README <https://github.com/apache/incubator-nuttx/blob/master/boards/arm/lpc17xx_40xx/lincoln60/README.txt>`__
file for further information about the Lincoln board.
@@ -1216,7 +1222,7 @@ The port of NuttX to the WaveShare Open1788 is a
collaborative effort between Rommel Marcelo and myself (with Rommel
being the leading contributor and I claiming only a support role). You
can get more information at the Open1788 board from the WaveShare
-website.
+`website <http://www.wvshare.com/product/Open1788-Standard.htm>`__.
ON Semiconductor LC823450
-------------------------
@@ -1852,7 +1858,8 @@ Three boards are supported in this family:
- **STM32L476 MDK**. Very basic support for NuttX on the Motorola Moto
Z MDK was contributed by Jim Wylder in NuttX 7.18. A simple NSH
- configuration is available for the STM32L476 chip. See the board
+ configuration is available for the STM32L476 chip. See the `Moto Mods
+ Development Kit <http://developer.motorola.com/buy/>`__ and the board
`README <https://github.com/apache/incubator-nuttx/blob/master/boards/arm/stm32l4/stm32l476-mdk/README.txt>`__
file for further information.
@@ -2859,7 +2866,12 @@ Microchip PIC32MX4xx
**PIC32MX440F512H**. This port uses the "Advanced USB Storage Demo
Board," Model DB-DP11215, from `Sure
Electronics <http://www.sureelectronics.net>`__. This board features the
-Microchip PIC32MX440F512H.
+Microchip PIC32MX440F512H. See the `Sure
+website <http://www.sureelectronics.net/goods.php?id=1168>`__ for
+further information about the DB-DP11215 board. (I believe that that the
+DB-DP11215 may be obsoleted now but replaced with the very similar,
+DB-DP11212. The DB-DP11212 board differs, I believe, only in its serial
+port configuration.)
**PIC32MX460F512L**. There one two board ports using this chip:
@@ -2883,7 +2895,7 @@ PIC32MX795F512L. There one two board ports using this chip:
- **Microchip PIC32 Ethernet Starter Kit**. This port uses the
Microchip PIC32 Ethernet Starter Kit (DM320004) with the Expansion
- I/O board. See the `Microchip website <http://www.microchip.com>`__
+ I/O board. See the `Microchip website <http://ww.microchip.com>`__
for further information.
- **Mikroelektronika PIC32MX7 Mulitmedia Board (MMB)**. A port has been
completed for the Mikroelektronika PIC32MX7 Multimedia Board (MMB).
@@ -3110,11 +3122,13 @@ environment is either Windows native or Cygwin under Windows.
**STATUS:** This release has been verified only on the ZiLOG ZDS-II
Z8Encore! chip simulation as of nuttx-0.3.9. Refer to the NuttX board
README files for the
-`z8encore000zco <https://github.com/apache/incubator-nuttx/blob/master/boards/z80/z8/z8encore000zco/README.txt>`__
+`z8encore000zco <https://github.com/apache/incubator-nuttx/blob/master/boards/ez80/z8/z8encore000zco/README.txt>`__
and for
-the\ `z8f64200100kit <https://github.com/apache/incubator-nuttx/blob/master/boards/z80/z8/z8f64200100kit/README.txt>`__
+the\ `z8f64200100kit <https://github.com/apache/incubator-nuttx/blob/master/boards/ez80/z8/z8f64200100kit/README.txt>`__
for further information.
+
+
Zilog Z180
==========
diff --git a/Documentation/introduction/resources.rst b/Documentation/introduction/resources.rst
index 0ac8cf4..8fc4855 100644
--- a/Documentation/introduction/resources.rst
+++ b/Documentation/introduction/resources.rst
@@ -8,12 +8,12 @@ Here's a list of Apache NuttX resources that you might find helpful:
* Apache NuttX
- * `Apache NuttX website <https://nuttx.apache.org>`_
- * `Apache NuttX online documentation <https://cwiki.apache.org/confluence/display/NUTTX/Nuttx>`_
+ * `Apache NuttX website <https://apache.nuttx.org>`_
+ * `Apache NuttX online documentation <https://cwiki.apache.org/confluence/display/NUTTX/NuttX>`_
* `Apache NuttX mailing list <https://nuttx.apache.org/community/>`_ – a very active mailing list, the place to get help with your application or any questions you have about NuttX.
* `Apache NuttX YouTube channel <https://www.youtube.com/channel/UC0QciIlcUnjJkL5yJJBmluw/videos>`_ – Alan Carvalho de Assis's YouTube channel on NuttX. It's a source of a lot of great practical information.
* `Apache NuttX Coding Standard <https://cwiki.apache.org/confluence/display/NUTTX/Coding+Standard>`_ — How code should look when you submit new files or modify existing ones.
- * `Apache NuttX Code Contribution Guidlines <https://cwiki.apache.org/confluence/display/NUTTX/Code+Contribution+Workflow>`_ — The full workflow to follow for submitting code with all the details.
+ * `Apache NuttX Code Contribution Guidlines <https://cwiki.apache.org/confluence/display/NUTTX/Code+Contribution+Workflow+--+Brennan+Ashton>`_ — The full workflow to follow for submitting code with all the details.
* Git
diff --git a/Documentation/quickstart/compiling.rst b/Documentation/quickstart/compiling.rst
index 55f81d1..94cc5cd 100644
--- a/Documentation/quickstart/compiling.rst
+++ b/Documentation/quickstart/compiling.rst
@@ -23,7 +23,7 @@ a pre-existing configuration. To list all supported configurations you can do:
The output is in the format ``<board name>:<board configuration>``. You will see that
generally all boards support the ``nsh`` configuration which is a good sarting point
since it enables booting into the interactive command line
-:doc:`/applications/nsh/index`.
+:doc:`/components/nsh/index`.
To choose a configuration you pass the ``<board name>:<board configuration>`` option
to ``configure.sh`` and indicate your host platform, such as:
diff --git a/Documentation/quickstart/organization.rst b/Documentation/quickstart/organization.rst
index e2a1044..eaf3b95 100644
--- a/Documentation/quickstart/organization.rst
+++ b/Documentation/quickstart/organization.rst
@@ -78,8 +78,8 @@ README.md file for information on how to build it.
``nuttx/arch``
==============
-Arch Subdirectory Structure
----------------------------
+Subdirectory Structure
+----------------------
This directory contains several sub-directories, each containing
architecture-specific logic. The task of porting NuttX to a new
@@ -91,8 +91,8 @@ directory (plus the board-specific configurations in the
subdirectory, *<arch-name>* under ``arch/`` with the following
characteristics:
-Arch Summary of Files
----------------------
+Summary of Files
+----------------
- ``include/``\ *<chip-name>*\ ``/`` This sub-directory contains
chip-specific header files.
@@ -252,16 +252,16 @@ configurations plus the architecture-specific configurations in
the ``arch/`` subdirectory complete define a customized port of
NuttX.
-Boards Subdirectory Structure
------------------------------
+Subdirectory Structure
+----------------------
The ``boards/`` directory contains board specific configuration
files. Each board must provide a sub-directory <board-name> under
``boards/``\ *<arch-name>*\ ``/``>\ *<chip-name>*\ ``/`` with the
following characteristics:
-Boards Summary of Files
------------------------
+Summary of Files
+----------------
**Board Specific Logic**
diff --git a/Documentation/reference/os/paging.rst b/Documentation/reference/os/paging.rst
index 9a4c5ba..3c30382 100644
--- a/Documentation/reference/os/paging.rst
+++ b/Documentation/reference/os/paging.rst
@@ -9,5 +9,5 @@ NuttX can provide on-demand paging: It can copy .text from the
large program in non-volatile media into RAM as needed to execute
a huge program from the small RAM. Design and porting issues for
this feature are discussed in a separate document. Please see the
-:ref:`NuttX Demand Paging <ondemandpaging>` design document
+`NuttX Demand Paging <NuttXDemandPaging.html>`__ design document
for further information.
diff --git a/Documentation/reference/user/01_task_control.rst b/Documentation/reference/user/01_task_control.rst
index 3b4566f..f0deda4 100644
--- a/Documentation/reference/user/01_task_control.rst
+++ b/Documentation/reference/user/01_task_control.rst
@@ -30,8 +30,8 @@ pthreads the were started from the same parent thread.
**Executing Programs within a File System**. NuttX also provides
internal interfaces for the execution of separately built programs that
reside in a file system. These internal interfaces are, however,
-non-standard and are documented with the NuttX binary
-loader and NXFLAT documentation.
+non-standard and are documented with the NuttX `binary
+loader <NuttXBinfmt.html>`__ and `NXFLAT <NuttXNxFlat.html#binfmt>`__.
**Task Control Interfaces**. The following task control interfaces are
provided by NuttX:
diff --git a/Documentation/reference/user/10_filesystem.rst b/Documentation/reference/user/10_filesystem.rst
index e867a31..4d2762e 100644
--- a/Documentation/reference/user/10_filesystem.rst
+++ b/Documentation/reference/user/10_filesystem.rst
@@ -2,8 +2,6 @@
File System Interfaces
======================
-.. _file_system_overview:
-
NuttX File System Overview
==========================
@@ -22,7 +20,7 @@ system).
Any user supplied data or logic can be accessed via the pseudo-file
system. Built in support is provided for character and block
-:ref:`driver <drivers-porting>` *nodes* in the any
+`driver <NuttXPortingGuide.html#DeviceDrivers>`__ *nodes* in the any
pseudo file system directory. (By convention, however, all driver nodes
should be in the ``/dev`` pseudo file system directory).
diff --git a/Documentation/reference/user/11_network.rst b/Documentation/reference/user/11_network.rst
index 0165485..f3bbe0d 100644
--- a/Documentation/reference/user/11_network.rst
+++ b/Documentation/reference/user/11_network.rst
@@ -3,8 +3,8 @@ Network Interfaces
==================
NuttX supports a BSD-compatible socket interface layer. These socket
-interface can be enabled by settings in the architecture configuration
-file. Those socket APIs are discussed in
+interface can be enabled by settings in the architecture `configuration
+file <NuttXConfigVariables.html>`__. Those socket APIs are discussed in
the following paragraphs.
- :c:func:`socket`
diff --git a/Documentation/reference/user/index.rst b/Documentation/reference/user/index.rst
index ce0aa48..4eb87e1 100644
--- a/Documentation/reference/user/index.rst
+++ b/Documentation/reference/user/index.rst
@@ -12,12 +12,12 @@ implementing applications on NuttX. Specifically, this documented is
limited to addressing only NuttX RTOS APIs that are available to the
application developer. As such, this document does not focus on any
technical details of the organization or implementation of NuttX. Those
-technical details are provided in the NuttX Porting
-Guide.
+technical details are provided in the `NuttX Porting
+Guide <NuttXPortingGuide.html>`__.
Information about configuring and building NuttX is also needed by the
-application developer. That information can also be found in the NuttX
-Porting Guide.
+application developer. That information can also be found in the `NuttX
+Porting Guide <NuttXPortingGuide.html#configandbuild>`__.
.. toctree::
:maxdepth: 1
diff --git a/Documentation/reference/user/structures.rst b/Documentation/reference/user/structures.rst
index 73df918..f291cc1 100644
--- a/Documentation/reference/user/structures.rst
+++ b/Documentation/reference/user/structures.rst
@@ -106,7 +106,7 @@ NuttX and a MoBY application:
size_t mq_curmsgs; /* Number of messages currently in queue */
};
-.. note that this gives a warning due to https://github.com/sphinx-doc/sphinx/issues/7819 https://github.com/sphinx-doc/sphinx/pull/8313
+.. note that this gives a warning due to https://github.com/sphinx-doc/sphinx/issues/7819
.. c:struct:: sigaction