Differences

This shows you the differences between two versions of the page.

--- haas:fall2014:data:projects:dls0 [2014/11/06 12:45] – [Expected Results] wedge
+++ haas:fall2014:data:projects:dls0 [2014/11/19 14:42] (current) – [Errata] wedge
@@ Line 17: / Line 17: @@
     * missing double newline after certain "should be" outputs in **unit-pop** (FIXED)
     * Some additional aesthetic enhancements to the base Makefile were made.
+  * __revision 2__: Makefile enhancements to facilitate project usage (20141107)
+    * test reference implementation feature enhancements
+      * a slight change to the option to enable (**make use-test-reference**)
+      * a new option to restore your own code (**make use-your-own-code**)
+    * **src/stack/Makefile** now cleans up vim .swp and nano .save files
+    * **testing/stack/unit/Makefile** fixes an off-by-one pretty display spacing issue
+  * __revision 3__: verify-stack.sh enhancements (20141119)
+    * now includes absolute totals
 =====Objective=====
@@ Line 226: / Line 234: @@
 ===Using the test reference implementation===
-You'll notice that, upon running **make help** in the base-level Makefile, the following new option appears (about halfway in the middle):
+You'll notice that, upon running **make help** in the base-level Makefile, the following new options appear (about halfway in the middle):
 <cli>
 **                                                                    **
-** make test-reference      - use working implementation object files **
+** make use-test-reference  - use working implementation object files **
+** make use-your-own-code   - use your node/list implementation code  **
 **                                                                    **
 </cli>
-In order to make use of it, you'll need to run **make test-reference** from the base of your **dls0** project directory, as follows:
+In order to make use of it, you'll need to run **make use-test-reference** from the base of your **dls0** project directory, as follows:
 <cli>
-lab46:~/src/data/dls0$ make test-reference
+lab46:~/src/data/dls0$ make use-test-reference
 make[1]: Entering directory '/home/wedge/src/data/dls0/src'
 make[2]: Entering directory '/home/wedge/src/data/dls0/src/list'
@@ Line 279: / Line 288: @@
 ...
 </cli>
-===Caveats===
-**__NOTE__:** The test reference node and list implementations are considered temporary-- any potential project-wide change (such as a **make update** or a **make clean**, or anything that could update the timestamps on source files) will cause it to be discarded on a subsequent build (running **make** or **make debug**).
-You can tell from the compile output if it is in place (none of the individual node or list library source files get built, only the libraries themselves are assembled).
-And again, clearing out the test reference implementation is as easy as running **make clean**; if you have a working node and list implementation (from successfully completing the prerequisite project(s)), you can still try out the test reference implementation- it will not touch your code in any way. It merely copies in pre-compiled object files and convinces the make system that they are more up-to-date than your source code, and so it opts not to recompile those files.
-This could also be a good way to verify that your node and list implementations are up to par, as you can now run the unit tests and verification scripts against your implementation, and my test reference implementation.
 **__Debugging__:** When using the test reference implementation, you will not be able to debug the contents of the node and list functions (the files provided do not have debugging symbols added), so you'll need to take care not to step into these functions (it would be just like stepping into **printf()**. You can still compile the project with debugging support and debug (as usual) those compiled functions (ie the stack functions).
-===Keeping Reference Implementation Longer Term===
+===Reverting back to using your code===
-Let's say, for whatever reason, you'd like to keep some or all of the reference implementation object files around, leaving them impervious to project-wide changes.
+If you were trying out the reference implementation to verify stack functionality, and wanted to revert back to your own code, it is as simple as:
-This is possible, and all it involves is an edit of 2 Makefiles.
+<cli>
+lab46:~/src/data/dls0$ make use-your-own-code
-If you'd like to do this:
+Local node/list implementation restored, run 'make clean; make' to build everything.
+lab46:~/src/data/dls0$
-Edit **src/node/Makefile** and **src/list/Makefile**, at the bottom of both files you'll see:
+</cli>
-<code>
-clean:
-        rm -f *.swp *.o $(OBJ) core
-</code>
-Let's say you want to keep all of the reference implementation around for both node and list. To do that, change the **clean** rule in both files as follows:
-<code>
-clean:
-        rm -f *.swp core
-</code>
-We basically removed any and all references to the compiled object files "**<nowiki>*.o $(OBJ)</nowiki>**" from the **clean** rule (which is responsible for removing them). This will keep them in place permanently, and unless you make changes to the particular source files, they will remain untouched and continue to be utilized.
-This isn't something I would consider a recommended action- it really would only be useful for those who have not successfully completed prior projects, and are looking to not fall further behind. If you've got a working node and list implementation (and it passes all the unit test and verification scripts), use yours.
 ====List Library unit tests====
 As a result of the required changes to **display()** and the incorporation of **qty**, pertinent list unit tests will be enhanced, so you can make use of them to ensure implementation compliance.

Lab46 Wiki

User Tools

Site Tools

Differences

Page Tools