[docs] Typo and formatting fixes.
TEST: No behavior change
Change-Id: Ie309389de1e707bb476c33a1dacee396225a89c4
diff --git a/docs/getting_started.md b/docs/getting_started.md
index 973665d..17aac44 100644
--- a/docs/getting_started.md
+++ b/docs/getting_started.md
@@ -52,7 +52,7 @@
## Install Toolchains
-If you're developing on Linux or macOS, there are prebuilt toolchain binaries avaiable.
+If you're developing on Linux or macOS, there are prebuilt toolchain binaries available.
Just run this script from your Zircon working directory:
```
@@ -255,7 +255,7 @@
$BUILDDIR/tools/bootserver $BUILDDIR/zircon.bin /path/to/extra.bootfs
```
-By default bootserver will continue to run and every time it obsveres a netboot
+By default bootserver will continue to run and every time it observes a netboot
beacon it will send the kernel (and bootfs if provided) to that device. If you
pass the -1 option, bootserver will exit after a successful boot instead.
diff --git a/docs/kernel_scheduling.md b/docs/kernel_scheduling.md
index f1e7656..77421f5 100644
--- a/docs/kernel_scheduling.md
+++ b/docs/kernel_scheduling.md
@@ -129,7 +129,7 @@
6. Any active CPU in the affinity mask.
If the thread is running on a CPU not in its affinity mask (due to case
-5 above) the scheduler will try to rectify this everytime the thread is
+5 above) the scheduler will try to rectify this every time the thread is
preempted, yields, or voluntarily reschedules. Also if the thread
changes its affinity mask the scheduler may migrate it.
@@ -164,5 +164,5 @@
a priority queue of -1. It is used to track idle time and can be used by
platform implementations for a low power wait mode.
-Realtime threads (marked with THREAD_FLAG_REAL_TIME) are allowed to run without
+Realtime threads (marked with `THREAD_FLAG_REAL_TIME`) are allowed to run without
preemption and will run until they block, yield, or manually reschedule.
diff --git a/docs/objects/channel.md b/docs/objects/channel.md
index adfdcfc..ae993d3 100644
--- a/docs/objects/channel.md
+++ b/docs/objects/channel.md
@@ -43,7 +43,7 @@
another, even if a write was in progress, the ordering of messages is guaranteed
to be parsimonious; packets before the transfer event originate from the
previous owner and packets after the transfer belong to the new owner. The same
-applies if a read was in progress when the endpoint was transfered.
+applies if a read was in progress when the endpoint was transferred.
The above sequential guarantee is not provided for other kernel objects, even if
the last remaining handle is stripped of the **ZX_RIGHT_DUPLICATE** right.
diff --git a/docs/syscalls/handle_replace.md b/docs/syscalls/handle_replace.md
index df2f370..49730ae 100644
--- a/docs/syscalls/handle_replace.md
+++ b/docs/syscalls/handle_replace.md
@@ -31,7 +31,7 @@
## RETURN VALUE
-**handle_replace**() returns ZX_OK and the replacement handle (via *out)
+**handle_replace**() returns **ZX_OK** and the replacement handle (via *out*)
on success.
## ERRORS
diff --git a/docs/syscalls/port_wait.md b/docs/syscalls/port_wait.md
index 70524be..d44892d 100644
--- a/docs/syscalls/port_wait.md
+++ b/docs/syscalls/port_wait.md
@@ -97,7 +97,7 @@
**ZX_ERR_INVALID_ARGS** *packet* isn't a valid pointer
-**ZX_ERR_ACCESS_DENIED** *handle* does not have **ZX_RIGHT_READ* and may
+**ZX_ERR_ACCESS_DENIED** *handle* does not have **ZX_RIGHT_READ** and may
not be waited upon.
**ZX_ERR_TIMED_OUT** *deadline* passed and no packet was available.
diff --git a/docs/syscalls/socket_read.md b/docs/syscalls/socket_read.md
index cab8e0c..09d105a 100644
--- a/docs/syscalls/socket_read.md
+++ b/docs/syscalls/socket_read.md
@@ -57,7 +57,7 @@
**ZX_ERR_INVALID_ARGS** If any of *buffer* or *actual* are non-NULL
but invalid pointers, or if *buffer* is NULL, or if *options* is not either zero
-or **ZX_SOCKET_CONTROL*.
+or **ZX_SOCKET_CONTROL**.
**ZX_ERR_ACCESS_DENIED** *handle* does not have **ZX_RIGHT_READ**.
diff --git a/docs/syscalls/task_kill.md b/docs/syscalls/task_kill.md
index 8ac1792..2440a3d 100644
--- a/docs/syscalls/task_kill.md
+++ b/docs/syscalls/task_kill.md
@@ -23,7 +23,7 @@
all its children are considered to be in the dead state and most operations
will no longer succeed.
-If *handle* is a job and the syscall is sucessful, the job cannot longer be
+If *handle* is a job and the syscall is successful, the job cannot longer be
used to create new processes.
## RIGHTS
diff --git a/docs/syscalls/thread_create.md b/docs/syscalls/thread_create.md
index 2297177..e2ffec2 100644
--- a/docs/syscalls/thread_create.md
+++ b/docs/syscalls/thread_create.md
@@ -25,7 +25,7 @@
Thread handles may be waited on and will assert the signal
*ZX_THREAD_TERMINATED* when the thread stops executing (due to
-*thread_exit**() being called).
+**thread_exit**() being called).
*process* is the controlling [process object](../objects/process.md) for the
new thread, which will become a child of that process.
diff --git a/docs/syscalls/thread_start.md b/docs/syscalls/thread_start.md
index 27861b1..bf82b1a 100644
--- a/docs/syscalls/thread_start.md
+++ b/docs/syscalls/thread_start.md
@@ -25,7 +25,7 @@
Thread handles may be waited on and will assert the signal
*ZX_THREAD_TERMINATED* when the thread stops executing (due to
-*thread_exit**() being called.
+**thread_exit**() being called.
*entry* shall point to a function that must call **thread_exit**() or
**futex_wake_handle_close_thread_exit**() or
diff --git a/docs/syscalls/timer_create.md b/docs/syscalls/timer_create.md
index 7d9e3d0..9dad3dc 100644
--- a/docs/syscalls/timer_create.md
+++ b/docs/syscalls/timer_create.md
@@ -17,7 +17,7 @@
**timer_create**() creates a timer, an object that can signal
when a specified point in time has been reached. The only valid
-*clock_id* is ZX_CLOCK_MONOTONIC.
+*clock_id* is **ZX_CLOCK_MONOTONIC**.
The *options* value specifies the coalescing behavior which
controls whether the system can fire the time earlier or later
@@ -32,10 +32,10 @@
+ **ZX_TIMER_SLACK_LATE** coalescing is allowed only with later
timers.
-Passing 0 in options is equivalent to ZX_TIMER_SLACK_CENTER.
+Passing 0 in options is equivalent to **ZX_TIMER_SLACK_CENTER**.
-The returned handle has the ZX_RIGHT_DUPLICATE, ZX_RIGHT_TRANSFER,
-ZX_RIGHT_READ and ZX_RIGHT_WRITE right.
+The returned handle has the **ZX_RIGHT_DUPLICATE**, **ZX_RIGHT_TRANSFER**,
+**ZX_RIGHT_READ** and **ZX_RIGHT_WRITE** right.
## RIGHTS
@@ -51,8 +51,8 @@
## ERRORS
**ZX_ERR_INVALID_ARGS** *out* is an invalid pointer or NULL or
-*options* is not one of the ZX_TIMER_SLACK values or *clock_id* is
-any value other than ZX_CLOCK_MONOTONIC.
+*options* is not one of the **ZX_TIMER_SLACK** values or *clock_id* is
+any value other than **ZX_CLOCK_MONOTONIC**.
**ZX_ERR_NO_MEMORY** Failure due to lack of memory.
There is no good way for userspace to handle this (unlikely) error.
diff --git a/docs/syscalls/vmar_map.md b/docs/syscalls/vmar_map.md
index 0ce5228..1323651 100644
--- a/docs/syscalls/vmar_map.md
+++ b/docs/syscalls/vmar_map.md
@@ -97,7 +97,7 @@
## NOTES
The VMO that backs a memory mapping can be resized to a smaller size. This can cause the
-thread is reading or writting to the VMAR region to fault. To avoid this hazard, services
+thread is reading or writing to the VMAR region to fault. To avoid this hazard, services
that receive VMOs from clients should use **ZX_VM_REQUIRE_NON_RESIZABLE** when mapping
the VMO.