# langref: Explain Zig Test · gitcafe/zig

[View on GitCafe](https://git.cafe/gitcafe/zig/commit/65e4926c5b6ca936b460afd1d1e43474b2bc320d)

Repository: [gitcafe/zig](https://git.cafe/gitcafe/zig)

Visibility: public

Requested revision: 65e4926c5b6ca936b460afd1d1e43474b2bc320d

Requested commit: 65e4926c5b6ca936b460afd1d1e43474b2bc320d

Commit: 65e4926c5b6ca936b460afd1d1e43474b2bc320d

Tree: 176e9cb783ca0ffa5343419a8cc3087deae07d49

Author: Mr\. Paul

Committer: Andrew Kelley

## Message

```
langref: Explain Zig Test

Updates the Language Reference sections: Comments, Values, and Zig Test.

Zig Test section moved down with the goal "make sure it can be read top to
bottom sensibly" in mind (issue #1524).

Comments and Values section examples changed test declarations to a main
function and expect statement to print statements.

A print statement was added to the "String Literals and Unicode Code Point"
section's example to demonstrate the "u" format specifier.

Zig Test Section:
* Addresses the question: "How does the syntax work?".
* Partially answers the question: "What can I do with the zig test tool?" but
should be sufficient to understand the examples in all of this document.
* Addresses the question: "How does a top-level test block differ from a function definition?"
* Provides a example to run multiple test.

Lacks clear definitions of containers, top-level, order independence, lazy
analysis, resolve, reference.

GitHub Issues: #8221, #8234

```

## Parents

- [d4ebfa87633aa632a290dfffa38712468e5512db](https://git.cafe/gitcafe/zig/commit/d4ebfa87633aa632a290dfffa38712468e5512db?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zig/tree/65e4926c5b6ca936b460afd1d1e43474b2bc320d?format=markdown)