Testing and Development Tools and Tips - Revision history

Mbland: /* test/testutil.h */ Add ADD_TEST() and run_tests()

2014-07-19T23:49:50Z

test/testutil.h: Add ADD_TEST() and run_tests()

2014-07-02T18:46:07Z

git-new-workdir: Notice about git-new-workdir location on Ubuntu

2014-06-25T13:56:47Z

test/new-test.sh: Fix new-test.sh link

2014-06-25T13:56:14Z

Testing Environment and Tools: Add links to test scripts in mbland's test-util fork on GitHub

2014-06-10T19:19:35Z

Typo fix in "Cscope > Vim Integration"

2014-06-10T19:18:44Z

Explain that $TAGS_FILE is defined in test/test_env.bash

2014-06-10T19:15:59Z

Add link to PragProg tmux book

2014-06-10T18:46:34Z

Add note that test utils will be linked to mainline as they are integrated

2014-06-10T18:38:36Z

Update test/testutil.h now that's it's merged into openssl/master as commit 3ead9f3798cb6de93b9824d6f833da9f00d8f5d7

2014-06-10T17:00:42Z

Add tmux section

@@ Line 5: / Line 5: @@
 === test/testutil.h ===
-[http://git.openssl.org/gitweb/?p=openssl.git;a=blob;f=test/testutil.h test/testutil.h] defines the generic <code>SETUP_TEST_FIXTURE</code> and <code>EXECUTE_TEST</code> macros. The header comments describe how to define test-specific macros based on these.
+[http://git.openssl.org/gitweb/?p=openssl.git;a=blob;f=test/testutil.h test/testutil.h] defines:
 === test/new-test.sh ===

@@ Line 79: / Line 79: @@
+}
 </pre>
 == tmux Terminal Multiplexer ==

@@ Line 8: / Line 8: @@
 === test/new-test.sh ===
-[https://github.com/mbland/openssl/blob/test-util/test/test_env.bash test/new-test.sh (mbland's fork)] generates a new automated test stub, following [http://mike-bland.com/2014/06/05/pseudo-xunit-pattern.html the Pseudo-xUnit Pattern] and using the macros from <code>test/testutil.h</code>. The generated stub will compile standalone.
+[https://github.com/mbland/openssl/blob/test-util/test/new-test.sh test/new-test.sh (mbland's fork)] generates a new automated test stub, following [http://mike-bland.com/2014/06/05/pseudo-xunit-pattern.html the Pseudo-xUnit Pattern] and using the macros from <code>test/testutil.h</code>. The generated stub will compile standalone.
 === test/test_env.bash ===

@@ Line 8: / Line 8: @@
 === test/new-test.sh ===
-Generates a new automated test stub, following [http://mike-bland.com/2014/06/05/pseudo-xunit-pattern.html the Pseudo-xUnit Pattern] and using the macros from <code>test/testutil.h</code>. The generated stub will compile standalone.
+[https://github.com/mbland/openssl/blob/test-util/test/test_env.bash test/new-test.sh (mbland's fork)] generates a new automated test stub, following [http://mike-bland.com/2014/06/05/pseudo-xunit-pattern.html the Pseudo-xUnit Pattern] and using the macros from <code>test/testutil.h</code>. The generated stub will compile standalone.
 === test/test_env.bash ===
-Environment variables, functions, and aliases to help with OpenSSL unit testing. The header comments contain documentation on each of the functions and aliases in the file.
+[https://github.com/mbland/openssl/blob/test-util/test/test_env.bash test/test_env.bash (mbland's fork)]: contains environment variables, functions, and aliases to help with OpenSSL unit testing. The header comments contain documentation on each of the functions and aliases in the file.
 == Cscope ==

@@ Line 17: / Line 17: @@
 === Vim Integration ===
-Once <code>$CSCOPE_DB</code> (defined in <code>test/test_env.bash</code> is built using <code>make-cscope</code>, you can take advantage of the Cscope integration in Vim by adding something like the following to your <code>.vimrc</code>:
+Once <code>$CSCOPE_DB</code> (defined in <code>test/test_env.bash</code>) is built using <code>make-cscope</code>, you can take advantage of the Cscope integration in Vim by adding something like the following to your <code>.vimrc</code>:
 <pre>

@@ Line 42: / Line 42: @@
 === Vim Integration ===
-Add this to your <code>.vimrc</code> to take advantage of Ctags integration in vim:
+Add this to your <code>.vimrc</code> to take advantage of Ctags integration in vim (where <code>$TAGS_FILE</code> is defined in <code>test/test_env.bash</code>):
 <pre>

@@ Line 81: / Line 81: @@
 == tmux Terminal Multiplexer ==
-[http://tmux.sourceforge.net/ The tmux terminal multiplexer] is helpful for using a single terminal window to efficiently manage different editing and build sessions, amongst many other useful functions. These are some helpful config options to add to <code>~/.tmux.conf</code>, including getting GNU screen-like CTRL-a behavior:
+[http://tmux.sourceforge.net/ The tmux terminal multiplexer] is helpful for using a single terminal window to efficiently manage different editing and build sessions, amongst many other useful functions. [http://pragprog.com/book/bhtmux/tmux tmux: Productive Mouse-Free Development] from The Pragmatic Bookshelf is a great primer.
 <pre>

@@ Line 2: / Line 2: @@
 == Testing Environment and Tools ==
-In [https://github.com/mbland/openssl/compare/test-util the test-util branch of Mike Bland's fork] are a few helper files that you may wish to copy or pull into your branch.
+In [https://github.com/mbland/openssl/compare/test-util the test-util branch of Mike Bland's fork] are a few helper files that you may wish to copy or pull into your branch. As they are incorporated into the main OpenSSL repository, links to the mainline versions will be incorporated into the descriptions below. However, there may be newer versions in Mike's fork.
 === test/testutil.h ===

@@ Line 78: / Line 78: @@
    fi
+}
 </pre>