Skip to content

Commit

Permalink
Documentation Updates
Browse files Browse the repository at this point in the history
  • Loading branch information
mvandervoord committed Apr 7, 2017
1 parent b8bfb01 commit 2c7629a
Show file tree
Hide file tree
Showing 5 changed files with 27 additions and 11 deletions.
8 changes: 6 additions & 2 deletions docs/ThrowTheSwitchCodingStandard.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,9 @@
Hi. Welcome to the coding standard for ThrowTheSwitch.org. For the most part,
we try to follow these standards to unify our contributors' code into a cohesive
unit (puns intended). You might find places where these standards aren't
followed. We're not perfect. Please be polite where
you notice these discrepancies and we'll try to be polite when we notice yours.
followed. We're not perfect. Please be polite where you notice these discrepancies
and we'll try to be polite when we notice yours.

;)


Expand Down Expand Up @@ -201,3 +202,6 @@ that happens, we like to indent further to line things up in nice tidy columns.

Egad. Really? We use markdown and we like pdf files because they can be made to
look nice while still being portable. Good enough?


*Find The Latest of This And More at [ThrowTheSwitch.org](https://throwtheswitch.org)*
19 changes: 11 additions & 8 deletions docs/UnityAssertionsReference.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,22 +129,22 @@ and double assertions (see immediately following section).

### TEST_ASSERT_EACH_EQUAL_X Variants

Unity provides a collection of assertions for arrays containing a variety of
types which can be compared to a single value as well. These are documented in
the Each Equal section below. these are almost on par with the `_MESSAGE`
Unity provides a collection of assertions for arrays containing a variety of
types which can be compared to a single value as well. These are documented in
the Each Equal section below. these are almost on par with the `_MESSAGE`
variants of Unity's Asserts in that for pretty much any Unity type assertion you
can inject _EACH_EQUAL and run assertions on an entire block of memory.

TEST_ASSERT_EACH_EQUAL_TYPEX( expected, actual, {size/count} )

"Expected" is a single value to compare to.
"Actual" is an array where each element will be compared to the expected value.
"Size/count" is one of two parameters necessary to establish the number of array
"Size/count" is one of two parameters necessary to establish the number of array
elements and perhaps the length of elements within the array.

Notes:
- The `_MESSAGE` variant convention still applies here to Each Equal assertions.
- Assertions for handling Each Equal of floating point values are grouped with
- Assertions for handling Each Equal of floating point values are grouped with
float and double assertions (see immediately following section).


Expand Down Expand Up @@ -409,10 +409,10 @@ match. Failure messages specify the array index of the failed comparison.
`expected` are single values and `actual` are arrays. `num_elements` specifies
the number of elements in the arrays to compare.

`_HEX` assertions produce failure messages with expected and actual array
`_HEX` assertions produce failure messages with expected and actual array
contents formatted in hexadecimal.

Assertions fail upon the first element in the compared arrays found not to
Assertions fail upon the first element in the compared arrays found not to
match. Failure messages specify the array index of the failed comparison.

#### `TEST_ASSERT_EACH_EQUAL_INT (expected, actual, num_elements)`
Expand Down Expand Up @@ -710,4 +710,7 @@ with zeros.
2. You're going to have to be careful of assertions that perform signed
operations, particularly `TEST_ASSERT_INT_WITHIN`.Such assertions might wrap
your `int` in the wrong place, and you could experience false failures. You can
always back down to a simple `TEST_ASSERT` and do the operations yourself.
always back down to a simple `TEST_ASSERT` and do the operations yourself.


*Find The Latest of This And More at [ThrowTheSwitch.org](https://throwtheswitch.org)*
5 changes: 4 additions & 1 deletion docs/UnityConfigurationGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -392,4 +392,7 @@ every single test case throughout your entire suite of tests.

The defines and macros in this guide should help you port Unity to just about
any C target we can imagine. If you run into a snag or two, don't be afraid of
asking for help on the forums. We love a good challenge!
asking for help on the forums. We love a good challenge!


*Find The Latest of This And More at [ThrowTheSwitch.org](https://throwtheswitch.org)*
3 changes: 3 additions & 0 deletions docs/UnityGettingStartedGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -186,3 +186,6 @@ test set for that module. Then, this process is repeated for the next test file.
This flexibility of separating tests into individual executables allows us to
much more thoroughly unit test our system and it keeps all the test code out of
our final release!
*Find The Latest of This And More at [ThrowTheSwitch.org](https://throwtheswitch.org)*
3 changes: 3 additions & 0 deletions docs/UnityHelperScriptsGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -237,3 +237,6 @@ OVERALL UNITY TEST SUMMARY
```

How convenient is that?


*Find The Latest of This And More at [ThrowTheSwitch.org](https://throwtheswitch.org)*

0 comments on commit 2c7629a

Please sign in to comment.