aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/style.txt
diff options
context:
space:
mode:
authorAntonio Borneo <borneo.antonio@gmail.com>2018-02-10 23:56:30 +0100
committerMatthias Welwarsky <matthias@welwarsky.de>2018-05-09 11:43:23 +0100
commitf0767a316a11c03924322b96b8d3feae1fe99a34 (patch)
tree350d79e8b7fad98e1bd1894edaddbf8da731f779 /doc/manual/style.txt
parent7b94ae9e520877e7f2341b48b3bd0c0d1ca8a14b (diff)
downloadriscv-openocd-f0767a316a11c03924322b96b8d3feae1fe99a34.zip
riscv-openocd-f0767a316a11c03924322b96b8d3feae1fe99a34.tar.gz
riscv-openocd-f0767a316a11c03924322b96b8d3feae1fe99a34.tar.bz2
doc: fix several typos within manual documents
Mostly trivial fixes spotted by spell checker Change-Id: I3af693faf5506c866e2abe253a0e37aea3c4d284 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: http://openocd.zylin.com/4510 Tested-by: jenkins Reviewed-by: Christopher Head <chead@zaber.com> Reviewed-by: Matthias Welwarsky <matthias@welwarsky.de>
Diffstat (limited to 'doc/manual/style.txt')
-rw-r--r--doc/manual/style.txt8
1 files changed, 4 insertions, 4 deletions
diff --git a/doc/manual/style.txt b/doc/manual/style.txt
index 0bfae35..e654be9 100644
--- a/doc/manual/style.txt
+++ b/doc/manual/style.txt
@@ -112,7 +112,7 @@ pthreads require modest and predictable stack usage.
@section stylefunc Functions
-- static inline functions should be prefered over macros:
+- static inline functions should be preferred over macros:
@code
/** do NOT define macro-like functions like this... */
#define CUBE(x) ((x) * (x) * (x))
@@ -201,7 +201,7 @@ The following guidelines apply to all Doxygen comment blocks:
-# @c struct_name::member_name should be used to reference structure
fields in the documentation (e.g. @c flash_driver::name).
-# URLS get converted to markup automatically, without any extra effort.
- -# new pages can be linked into the heirarchy by using the @c \@subpage
+ -# new pages can be linked into the hierarchy by using the @c \@subpage
command somewhere the page(s) under which they should be linked:
-# use @c \@ref in other contexts to create links to pages and sections.
-# Use good Doxygen mark-up:
@@ -233,7 +233,7 @@ documentation as part of standalone text files:
- Doxygen creates such pages for files automatically, but no content
will appear on them for those that only contain manual pages.
- The \@file block should provide useful meta-documentation to assist
- techincal writers; typically, a list of the pages that it contains.
+ technical writers; typically, a list of the pages that it contains.
- For example, the @ref styleguide exists in @c doc/manual/style.txt,
which contains a reference back to itself.
-# The \@file and \@page commands should begin on the same line as
@@ -261,7 +261,7 @@ The User's Guide is there to provide two basic kinds of information. It
is a guide for how and why to use each feature or mechanism of OpenOCD.
It is also the reference manual for all commands and options involved
in using them, including interface, flash, target, and other drivers.
-At this time, it is the only user-targetted documentation; everything
+At this time, it is the only documentation for end users; everything
else is addressing OpenOCD developers.
There are two key audiences for the User's Guide, both developer based.