Skip to content

Commit ea8ddee

Browse files
author
AnotherButler
committed
Update link formats
Update link formats.
1 parent 0699f5d commit ea8ddee

36 files changed

+173
-173
lines changed

docs/reference/api/connectivity/networksocket/WifiInterface.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
The WifiInterface provides a simple C++ API for connecting to the internet over a Wi-Fi device.
44

5-
There are multiple <a href="https://os.mbed.com/components/cat/wifi/" target="_blank">Wi-Fi components</a> that implement the WiFiInterface class. The example below uses the <a href="https://github.com/armmbed/esp8266-driver" target="_blank">ESP8266Interface</a>.
5+
There are multiple [Wi-Fi components](https://os.mbed.com/components/cat/wifi/) that implement the WiFiInterface class. The example below uses the [ESP8266Interface](https://github.com/armmbed/esp8266-driver).
66

77
### Wi-Fi class reference
88

@@ -14,7 +14,7 @@ To bring up the network interface:
1414

1515
1. Instantiate an implementation of the WiFiInterface class (for example, the ESP8266Interface).
1616
1. Call the `connect` function with an SSID and password for the Wi-Fi network.
17-
1. Once connected, the WiFiInterface can be used as a target for opening <a href="/docs/v5.7/reference/network-socket.html" target="_blank">network sockets</a>.
17+
1. Once connected, the WiFiInterface can be used as a target for opening [network sockets](/docs/v5.7/reference/network-socket.html).
1818

1919
### Wi-Fi example
2020

@@ -24,5 +24,5 @@ Here is an example of an HTTP client program. The program brings up an ESP8266 a
2424

2525
### Related content
2626

27-
- <a href="https://os.mbed.com/components/cat/wifi/" target="_blank">Wi-Fi components</a>.
28-
- <a href="/docs/v5.7/reference/network-socket.html" target="_blank">Network socket</a> API overview.
27+
- [Wi-Fi components](https://os.mbed.com/components/cat/wifi/).
28+
- [Network socket](/docs/v5.7/reference/network-socket.html) API overview.

docs/reference/api/drivers/RawSerial.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ _9600-8-N-1_, a common notation for serial port settings, describes the default
2020

2121
[![View code](https://www.mbed.com/embed/?type=library)](http://os-doc-builder.test.mbed.com/docs/v5.7/mbed-os-api-doxy/classmbed_1_1_raw_serial.html)
2222

23-
<span class="notes">**Note**: On a Windows machine, you need to install a USB serial driver. See <a href="/docs/v5.7/tutorials/serial-communication.html#windows-serial-driver" target="_blank">Windows serial configuration</a>.</span>
23+
<span class="notes">**Note**: On a Windows machine, you need to install a USB serial driver. See [Windows serial configuration](/docs/v5.7/tutorials/serial-communication.html#windows-serial-driver).</span>
2424

2525
### RawSerial hello, world
2626

@@ -36,4 +36,4 @@ Write a message to a device at a baud rate of 19200.
3636

3737
#### Mbed OS example
3838

39-
Common use cases for RawSerial are IRQ heavy UART operations, such as the <a href="https://github.com/ARMmbed/ATParser/blob/3209400df676cbf0183a5894f648c71727602d30/BufferedSerial/BufferedSerial.cpp#L29" target="_blank">ATParser</a> in the ESP8266 driver. This driver uses UART on user supplied pins to communicate with the offchip ESP8266 module.
39+
Common use cases for RawSerial are IRQ heavy UART operations, such as the [ATParser](https://github.com/ARMmbed/ATParser/blob/3209400df676cbf0183a5894f648c71727602d30/BufferedSerial/BufferedSerial.cpp#L29) in the ESP8266 driver. This driver uses UART on user supplied pins to communicate with the offchip ESP8266 module.

docs/reference/api/platform/Callback.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,11 @@ The Callback API provides a convenient way to pass arguments to spawned threads.
1919

2020
### Sonar example
2121

22-
Here is an example that uses everything discussed in the <a href="/docs/v5.7/reference/platform.html#callbacks" target="_blank">introduction to callbacks</a> document in the form of a minimal Sonar class.
22+
Here is an example that uses everything discussed in the [introduction to callbacks](/docs/v5.7/reference/platform.html#callbacks) document in the form of a minimal Sonar class.
2323

2424
[![View code](https://www.mbed.com/embed/?url=https://os.mbed.com/teams/mbed_example/code/callback-sonar-example/)](https://os.mbed.com/teams/mbed_example/code/callback-sonar-example/file/1713cdc51510/main.cpp)
2525

2626
### Related content
2727

28-
- <a href="/docs/v5.7/reference/platform.html" target="_blank">Platform overview</a>.
29-
- <a href="/docs/v5.7/reference/platform.html#callbacks" target="_blank">Introduction to callbacks</a>.
28+
- [Platform overview](/docs/v5.7/reference/platform.html).
29+
- [Introduction to callbacks](/docs/v5.7/reference/platform.html#callbacks).

docs/reference/api/platform/NonCopyable.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@ Copying objects of classes used for locking, network encapsulation, hardware bus
1414

1515
### Related content
1616

17-
- <a href="/docs/v5.7/reference/mutex.html" target="_blank">Mutex</a> API reference.
18-
- <a href="/docs/v5.7/reference/eventflags.html" target="_blank">EventFlags</a> API reference.
19-
- <a href="/docs/v5.7/reference/busout.html" target="_blank">BusOut</a> API reference.
20-
- <a href="/docs/v5.7/reference/interruptin.html" target="_blank">InterruptIn</a> API reference.
21-
- <a href="/docs/v5.7/reference/i2c.html" target="_blank">I2C</a> API reference.
17+
- [Mutex](/docs/v5.7/reference/mutex.html) API reference.
18+
- [EventFlags](/docs/v5.7/reference/eventflags.html) API reference.
19+
- [BusOut](/docs/v5.7/reference/busout.html) API reference.
20+
- [InterruptIn](/docs/v5.7/reference/interruptin.html) API reference.
21+
- [I2C](/docs/v5.7/reference/i2c.html) API reference.

docs/reference/api/platform/PlatformMutex.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,8 @@ Mbed OS uses the PlarformMutex class instead of the RTOS mutex for all drivers.
1616

1717
### Related content
1818

19-
- <a href="/docs/v5.6/reference/analogin.html" target="_blank">AnalogIn</a>.
20-
- <a href="/docs/v5.6/reference/busout.html" target="_blank">BusOut</a>.
21-
- <a href="/docs/v5.6/reference/spi.html" target="_blank">SPI</a>.
22-
- <a href="/docs/v5.6/reference/serial.html" target="_blank">Serial</a>.
23-
- <a href="/docs/v5.6/reference/i2c.html" target="_blank">I2C</a>.
19+
- [AnalogIn](/docs/v5.6/reference/analogin.html).
20+
- [BusOut](/docs/v5.6/reference/busout.html).
21+
- [SPI](/docs/v5.6/reference/spi.html).
22+
- [Serial](/docs/v5.6/reference/serial.html).
23+
- [I2C](/docs/v5.6/reference/i2c.html).

docs/reference/api/platform/platform.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,16 @@
22

33
The role of the platform modules is to provide a consistent user experience on top of different standard libraries and toolchains. This section consists of the `Callback`, `Wait` and `Time` APIs. This page contains reference material about these subjects. You can also jump straight to the APIs:
44

5-
- <a href="/docs/v5.7/reference/wait.html" target="_blank">Wait</a>: An API that provides simple wait capabilities.
6-
- <a href="/docs/v5.7/reference/callback.html" target="_blank">Callback</a>: An API that executes the user’s code in its own context.
7-
- <a href="/docs/v5.7/reference/deepsleeplock.html" target="_blank">DeepSleepLock</a>: The sleep function for Mbed OS.
8-
- <a href="/docs/v5.7/reference/sleep-manager.html" target="_blank">SleepManager</a>: The function that provides an API to control sleep modes.
9-
- <a href="/docs/v5.7/reference/criticalsectionlock.html" target="_blank">CriticalSectionLock</a>: An object that establishes the beginning of a critical section and uses RAII to disable and restore interrupt state when the current scope exits.
10-
- <a href="/docs/v5.7/reference/time.html" target="_blank">Time</a>: A group of functions in the standard library of the C programming language implementing date and time manipulation operations.
11-
- <a href="/docs/v5.7/reference/error.html" target="_blank">Error</a>: A functions that generates a fatal runtime error.
12-
- <a href="/docs/v5.7/reference/noncopyable.html" target="_blank">NonCopyable</a>: An API that tags a class as not supporting copy operations. It creates a compile-time error if you copy the object.
13-
- <a href="/docs/v5.7/reference/circularbuffer.html" target="_blank">CircularBuffer</a>: The class that provides APIs to push and pop data from a buffer
14-
- <a href="/docs/v5.7/reference/atcmdparser.html" target="_blank">ATCmdParser</a>: An Mbed OS compatible AT command parser.
5+
- [Wait](/docs/v5.7/reference/wait.html): An API that provides simple wait capabilities.
6+
- [Callback](/docs/v5.7/reference/callback.html): An API that executes the user’s code in its own context.
7+
- [DeepSleepLock](/docs/v5.7/reference/deepsleeplock.html): The sleep function for Mbed OS.
8+
- [SleepManager](/docs/v5.7/reference/sleep-manager.html): The function that provides an API to control sleep modes.
9+
- [CriticalSectionLock](/docs/v5.7/reference/criticalsectionlock.html): An object that establishes the beginning of a critical section and uses RAII to disable and restore interrupt state when the current scope exits.
10+
- [Time](/docs/v5.7/reference/time.html): A group of functions in the standard library of the C programming language implementing date and time manipulation operations.
11+
- [Error](/docs/v5.7/reference/error.html): A functions that generates a fatal runtime error.
12+
- [NonCopyable](/docs/v5.7/reference/noncopyable.html): An API that tags a class as not supporting copy operations. It creates a compile-time error if you copy the object.
13+
- [CircularBuffer](/docs/v5.7/reference/circularbuffer.html): The class that provides APIs to push and pop data from a buffer
14+
- [ATCmdParser](/docs/v5.7/reference/atcmdparser.html): An Mbed OS compatible AT command parser.
1515

1616
<h4 id="callbacks">Callbacks</h4>
1717

@@ -36,7 +36,7 @@ Serial serial(USBTX, USBRX);
3636
}
3737
```
3838
39-
The Callback class manages C/C++ function pointers so you don't have to. If you are asking yourself why you should use the Callback class, you should read the <a href="/docs/v5.7/reference/platform.html#the-importance-of-state" target="_blank">Importance of State</a> section.
39+
The Callback class manages C/C++ function pointers so you don't have to. If you are asking yourself why you should use the Callback class, you should read the [Importance of State](/docs/v5.7/reference/platform.html#the-importance-of-state) section.
4040
4141
#### Why should you use Callbacks?
4242
@@ -209,7 +209,7 @@ public:
209209

210210
<h4 id="the-importance-of-state">The importance of state</h4>
211211

212-
A callback is a user provided function that a user may pass to an API. The callback allows the API to execute the user’s code in its own context. You can find more information on how to use callbacks in the <a href="/docs/v5.7/reference/callback.html" target="_blank">technical callback documentation</a>.
212+
A callback is a user provided function that a user may pass to an API. The callback allows the API to execute the user’s code in its own context. You can find more information on how to use callbacks in the [technical callback documentation](/docs/v5.7/reference/callback.html).
213213

214214
##### Why not function pointers?
215215

docs/reference/api/rtos/rtos.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,21 +8,21 @@ The code of the Mbed RTOS can be found in the <a href="https://github.com/ARMmbe
88

99
System tick timer (SysTick) is a standard timer available on most Cortex-M cores. Its main purpose is to raise an interrupt with set frequency (usually 1ms). You can use it to perform any task in the system, but for platforms using RTOS, including Mbed OS, it provides an interval for the OS for counting the time and scheduling tasks.
1010

11-
Mbed OS uses default SysTick source for most targets, but you can override that using the <a href="http://arm-software.github.io/CMSIS_5/RTOS2/html/group__CMSIS__RTOS__TickAPI.html" target="_blank">Tick API</a> that CMSIS-RTOS2 provides. In which case you'll need to provide your own source of the interrupts.
11+
Mbed OS uses default SysTick source for most targets, but you can override that using the [Tick API](http://arm-software.github.io/CMSIS_5/RTOS2/html/group__CMSIS__RTOS__TickAPI.html) that CMSIS-RTOS2 provides. In which case you'll need to provide your own source of the interrupts.
1212

1313
#### RTOS APIs
1414

1515
The RTOS APIs handle creation and destruction of threads in Arm Mbed OS 5, as well as mechanisms for safe interthread communication. Threads are a core component of Mbed OS 5 (even your `main` function starts in a thread of its own), so understanding how to work with them is an important part of developing applications for Mbed OS 5.
1616

17-
- <a href="/docs/v5.7/reference/thread.html" target="_blank">Thread</a>: The class that allows defining, creating and controlling parallel tasks.
18-
- <a href="/docs/v5.7/reference/mutex.html" target="_blank">Mutex</a>: The class used to synchronize the execution of threads.
19-
- <a href="/docs/v5.7/reference/semaphore.html" target="_blank">Semaphore</a>: The class that manages thread access to a pool of shared resources of a certain type.
20-
- <a href="/docs/v5.7/reference/queue.html" target="_blank">Queue</a>: The class that allows you to queue pointers to data from producer threads to consumer threads.
21-
- <a href="/docs/v5.7/reference/memorypool.html" target="_blank">MemoryPool</a>: This class that you can use to define and manage fixed-size memory pools
22-
- <a href="/docs/v5.7/reference/mail.html" target="_blank">Mail</a>: The API that provides a queue combined with a memory pool for allocating messages.
23-
- <a href="/docs/v5.7/reference/rtostimer.html" target="_blank">RtosTimer</a>: A deprecated class used to control timer functions in the system.
24-
- <a href="/docs/v5.7/reference/eventflags.html" target="_blank">EventFlags</a>: An event channel that provides a generic way of notifying other threads about conditions or events.
25-
- <a href="/docs/v5.7/reference/event.html" target="_blank">Event</a>: The queue to store events, extract them and excute them later.
17+
- [Thread](/docs/v5.7/reference/thread.html): The class that allows defining, creating and controlling parallel tasks.
18+
- [Mutex](/docs/v5.7/reference/mutex.html): The class used to synchronize the execution of threads.
19+
- [Semaphore](/docs/v5.7/reference/semaphore.html): The class that manages thread access to a pool of shared resources of a certain type.
20+
- [Queue](/docs/v5.7/reference/queue.html): The class that allows you to queue pointers to data from producer threads to consumer threads.
21+
- [MemoryPool](/docs/v5.7/reference/memorypool.html): This class that you can use to define and manage fixed-size memory pools
22+
- [Mail](/docs/v5.7/reference/mail.html): The API that provides a queue combined with a memory pool for allocating messages.
23+
- [RtosTimer](/docs/v5.7/reference/rtostimer.html): A deprecated class used to control timer functions in the system.
24+
- [EventFlags](/docs/v5.7/reference/eventflags.html): An event channel that provides a generic way of notifying other threads about conditions or events.
25+
- [Event](/docs/v5.7/reference/event.html): The queue to store events, extract them and excute them later.
2626

2727
##### Default timeouts
2828

docs/reference/api/security/TLS.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,25 @@
22

33
Arm Mbed TLS provides a comprehensive SSL/TLS solution and makes it easy for developers to include cryptographic and SSL/TLS capabilities in their software and embedded products. As an SSL library, it provides an intuitive API, readable source code and a minimal and highly configurable code footprint.
44

5-
<span class="notes">**Note:** Mbed TLS needs a secure source of random numbers; make sure that your target board has one and that it is fully ported to Arm Mbed OS. You can read more about this in our <a href="/docs/v5.7/reference/contributing.html" target="_blank">porting guide</a>.</span>
5+
<span class="notes">**Note:** Mbed TLS needs a secure source of random numbers; make sure that your target board has one and that it is fully ported to Arm Mbed OS. You can read more about this in our [porting guide](/docs/v5.7/reference/contributing.html).</span>
66

77
### Mbed TLS examples
88

99
You can try the following examples:
1010

11-
1. <a href="https://github.com/ARMmbed/mbed-os-example-tls/tree/master/tls-client" target="_blank">TLS client</a>: Downloads a file from an HTTPS server (os.mbed.com) and looks for a specific string in that file.
11+
1. [TLS client](https://github.com/ARMmbed/mbed-os-example-tls/tree/master/tls-client): Downloads a file from an HTTPS server (os.mbed.com) and looks for a specific string in that file.
1212

13-
1. <a href="https://github.com/ARMmbed/mbed-os-example-tls/tree/master/benchmark" target="_blank">Benchmark</a>: Measures the time taken to perform basic cryptographic functions used in the library.
13+
1. [Benchmark](https://github.com/ARMmbed/mbed-os-example-tls/tree/master/benchmark): Measures the time taken to perform basic cryptographic functions used in the library.
1414

15-
1. <a href="https://github.com/ARMmbed/mbed-os-example-tls/tree/master/hashing" target="_blank">Hashing</a>: Demonstrates the various APIs for computing hashes of data (also known as message digests) with SHA-256.
15+
1. [Hashing](https://github.com/ARMmbed/mbed-os-example-tls/tree/master/hashing): Demonstrates the various APIs for computing hashes of data (also known as message digests) with SHA-256.
1616

17-
1. <a href="https://github.com/ARMmbed/mbed-os-example-tls/tree/master/authcrypt" target="_blank">Authenticated encryption</a>: Demonstrates using the Cipher API for encrypting and authenticating data with AES-CCM.
17+
1. [Authenticated encryption](https://github.com/ARMmbed/mbed-os-example-tls/tree/master/authcrypt): Demonstrates using the Cipher API for encrypting and authenticating data with AES-CCM.
1818

1919
Each of them comes with complete usage instructions as a readme file in the repository.
2020

2121
### Configuring Mbed TLS features
2222

23-
Mbed TLS simplifies enabling and disabling features to meet the needs of a particular project, through compilation options. The list of compilation flags is available in the fully documented configuration file, <a href="https://github.com/ARMmbed/mbedtls/blob/development/include/mbedtls/config.h" target="_blank">config.h</a>.
23+
Mbed TLS simplifies enabling and disabling features to meet the needs of a particular project, through compilation options. The list of compilation flags is available in the fully documented configuration file, [config.h](https://github.com/ARMmbed/mbedtls/blob/development/include/mbedtls/config.h).
2424

2525
For example, in an application called `myapp`, if you want to enable the EC J-PAKE key exchange and disable the CBC cipher mode, you can create a file named `mbedtls-config-changes.h` in the `myapp` directory containing the following lines:
2626

docs/reference/api/security/security.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@
22

33
Security on Arm Mbed OS is divided into two parts:
44

5-
- <a href="/docs/v5.7/reference/tls.html" target="_blank">Connection security through Arm Mbed TLS</a>.
6-
- <a href="/docs/v5.7/reference/uvisor.html" target="_blank">Device security through Arm Mbed uVisor</a>.
5+
- [Connection security through Arm Mbed TLS](/docs/v5.7/reference/tls.html).
6+
- [Device security through Arm Mbed uVisor](/docs/v5.7/reference/uvisor.html).
77

88
The sections cover working with these modules in the context of Mbed OS. For generic documentation for both modules, see:
99

10-
- <a href="https://tls.mbed.org/" target="_blank">Mbed TLS full documentation</a>.
11-
- <a href="https://docs.mbed.com/docs/uvisor-and-uvisor-lib-documentation/en/latest/" target="_blank">Mbed uVisor full documentation</a>.
10+
- [Mbed TLS full documentation](https://tls.mbed.org/).
11+
- [Mbed uVisor full documentation](https://docs.mbed.com/docs/uvisor-and-uvisor-lib-documentation/en/latest/).

0 commit comments

Comments
 (0)