updated markdownlint problems plus error in while

.vscode/settings.json

@@ -1,13 +1,16 @@
 {
 	"cSpell.words": [
         "AARCH",
+        "ackward",
         "argc",
         "argv",
         "asciz",
         "cbnz",
+        "CDLL",
         "cout",
         "csel",
         "dptr",
+        "DTMP",
         "FCVTAS",
         "fcvtz",
         "fildes",
@@ -23,6 +26,7 @@
         "lname",
         "lseek",
         "memcpy",
+        "orward",
         "pimm",
         "pseudocode",
         "regs",
@@ -35,6 +39,7 @@
         "strncpy",
         "struct",
         "structs",
+        "Woverflow",
         "wreg",
         "xreg"
     ],

.vscode/sftp.json

@@ -5,7 +5,7 @@
     "port": 2222,
     "username": "user",
     "remotePath": "./asm_book",
-    "uploadOnSave": true,
+    "uploadOnSave": false,
     "useTempFile": false,
     "openSsh": true,
     "password": "a"

LICENSE.md

@@ -20,7 +20,7 @@ ShareAlike — If you remix, transform, or build upon the material, you must dis
 
 No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
 
-## Notices:
+## Notices
 
 You do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation.
 

projects/first_project/README.md

@@ -44,7 +44,7 @@ back "Foo" and a new line. Then I hit ^d so the program exited.
 
 ### From redirection
 
-An awsome feature of the command line is the ability to redirect input
+An awesome feature of the command line is the ability to redirect input
 and output. Since the program simply reads from `stdin`, and `stdin` can
 be redirected, you get this feature for free:
 

projects/snow/README.md

@@ -89,7 +89,7 @@ If the particle's `line` exceeds 24, the particle is `Reset()`.
 To draw a particle, `Move()` to its location then print a "\*" all
 without emitting a new line. Before printing the "\*", check to ensure
 both the `line` and `column` are within the boundaries of the default
-terminal window (i.e. line betweeb 1  and 24 and also column
+terminal window (i.e. line between 1  and 24 and also column
 between 1 and 80).
 If the particle's position is outside this range, don't print anything.
 
@@ -138,4 +138,3 @@ output to be flushed to the terminal.
 ## Solution
 
 The solution is [here](./main.s).
-

section_1/const/README.md

@@ -23,11 +23,10 @@ void Const1() {                                                         // 3
 it is the C++ compiler that enforces the immutable nature of `foo`.
 Looking at the assembly language that is produced from this C++ code,
 you will [see](./const_test.s) that `foo` is implemented like any other
-variable. Once
+variable. Once in assembly language you are behind the defenses of the
-in assembly language you are behind the defenses of the compiler so
+compiler so to speak. You can modify a `const` local variable or
-to speak. You can modify a `const` local variable or parameter to your
+parameter to your heart's content. Should you? That's another question.
-heart's content. Should you? That's another question. Will it cause harm?
+Will it cause harm? It depends.
-It depends.
 
 ## What **IS** Enforced
 

section_1/fizzbuzz/README.md

@@ -2,7 +2,8 @@
 
 In this chapter we build the classic tech interview question: FizzBuzz.
 
-The idea is simple. Write a program that enumerates the integers from 0 to some stopping value, perhaps 100.
+The idea is simple. Write a program that enumerates the integers from 0
+to some stopping value, perhaps 100.
 
 For each integer:
 
@@ -45,7 +46,6 @@ language.
 
 [Here is the source code](./fizzbuzz.s).
 
-The video is long but there is much benefit to be had by watching
+The video is long but there is much benefit to be had by watching and
-and listening to another person's process as they write the code.
+listening to another person's process as they write the code. **AND
-**AND especially** listening and watching to them debug when 
+especially** listening and watching to them debug when things go wrong!
-things go wrong!

section_1/hello_world/.markdownlint.json

@@ -0,0 +1,3 @@
+{
+    "MD024":false
+}

section_1/hello_world/README.md

@@ -59,7 +59,8 @@ for `c`onsole `out`put. The angle brackets (`<` and `>`) indicate the
 include file `iostream` comes from a language or system supplied
 directory as opposed to an include file written by you.
 
-For an explanation of what an `include` file is and how it fits into the compilation workflow see [here](https://youtu.be/Iv3psS4n9j8).
+For an explanation of what an `include` file is and how it fits into the
+compilation workflow see [here](https://youtu.be/Iv3psS4n9j8).
 
 ### Line 3
 
@@ -222,6 +223,20 @@ fetch what is found at the address specified by `argv`".
 That, dear reader, is the address of the string of characters to be
 printed. Or, it is a NULL, telling us to stop.
 
+#### Style warning
+
+Many would argue that the post increment found within the sending of
+output to `cout` is bad style. We would count ourselves among those who
+would consider this ill-considered.
+
+Why? Because a print out isn't a likely place to expect to find
+something that changes the state of the program. The increment found
+here can be considered a *side effect*. Side effects are, in general,
+bad. Try to avoid them. Yes, they can make your code a few lines shorter
+but this comes at the expense of maintainability.
+
+So, do as we say, not as we did.
+
 ### Line 8
 
 `Line 8` contains a matching brace for the opening brace found line
@@ -464,7 +479,8 @@ the assembly language this looks like:
 
 1. Load the memory address of x into a register.
 
-2. Go out to that memory address and fetch what it contains into a register (a dereference).
+2. Go out to that memory address and fetch what it contains into a
+   register (a dereference).
 
 3. Add one to that value (in the register).
 

section_1/while/.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "markdownlint.config": {
+        "MD024": false
+    },
+}

section_1/while/README.md

@@ -2,13 +2,20 @@
 
 ## Overview
 
-We have already [covered](../if/README.md) the `if` statement. A `while` loop is exactly the same with the addition of at least one branch and a label. It really is that simple.
+We have already [covered](../if/README.md) the `if` statement. A `while`
+loop is exactly the same with the addition of at least one branch and a
+label. It really is that simple.
 
-To illustrate this, here is a flow chart of an `if` statement (on the left) compared to a `while` loop (on the right).
+To illustrate this, here is a flow chart of an `if` statement (on the
+left) compared to a `while` loop (on the right).
 
 ![while loop](./while.jpeg)
 
-The closing brace in an `if` statement is indicated by the red arrow head. This isn't a branch, the code flow simply falls through to the statement beyond the closing brace. In the `while` loop, the behavior of the closing brace changes to be that of a branch back to just before the evaluation of the boolean condition (the "Decision").
+The closing brace in an `if` statement is indicated by the red arrow
+head. This isn't a branch, the code flow simply falls through to the
+statement beyond the closing brace. In the `while` loop, the behavior of
+the closing brace changes to be that of a branch back to just before the
+evaluation of the boolean condition (the "Decision").
 
 A new label is placed before evaluating the "Decision".
 
@@ -41,30 +48,37 @@ while (a >= b) {
 }
 ```
 
-Here is the code for the `while` showing the addition of one new label and one new unconditional branch:
+Here is the code for the `while` showing the addition of one new label
+and one new unconditional branch:
 
 ```asm
     // Assume value of a is in x0                                       // 1 
     // Assume value of b is in x1                                       // 2 
                                                                         // 3 
  1: cmp     x0, x1                                                      // 4 
-    ble     2f                                                          // 5 
+    bgt     2f                                                          // 5 
     // CODE BLOCK                                                       // 6 
     b       1b                                                          // 7 
                                                                         // 8 
 2:                                                                      // 9 
 ```
 
-Temporary label `2` on `line 9` takes the place of the line after the closing brace in a `while` loop.
+Temporary label `2` on `line 9` takes the place of the line after the
+closing brace in a `while` loop.
 
-Temporary label `1` on `line 4` is the end point of the red arrow in the right hand
+Temporary label `1` on `line 4` is the end point of the red arrow in the
-flow chart above.
+right hand flow chart above.
 
 ## Summary
 
-A `while` loop is an extension of the `if` statement. A simple `if` contains one conditional branch and one label.
+A `while` loop is an extension of the `if` statement. A simple `if`
+contains one conditional branch and one label.
 
-A `while` loop contains at least two labels, one conditional branch and one unconditional branch. We acknowledge the possibility that the unconditional branch could be made a conditional one, but this is rarely done in assembly language and impossible in higher level languages like C and C++ since the branch is simply the closing `}`.
+A `while` loop contains at least two labels, one conditional branch and
+one unconditional branch. We acknowledge the possibility that the
+unconditional branch could be made a conditional one, but this is rarely
+done in assembly language and impossible in higher level languages like
+C and C++ since the branch is simply the closing `}`.
 
 ## Questions
 

section_3/bitfields/with.md

@@ -54,4 +54,3 @@ store the byte containing our fields.
 Note that the C version of the bit field setters could be declared
 to be `inline` so that would be closer in performance to equivalent
 code written to use C / C++ bit fields.
-