@extends('layouts.TreeContainerLibrary')

@section('styles')
    <link media="all" type="text/css" rel="stylesheet" href="/assets/css/pages/tree-container-library/tcl-common.css"/>
    <link media="all" type="text/css" rel="stylesheet" href="/assets/css/pages/tree-container-library/examples/tcl-test-suite.css"/>
@stop

@section('panel-heading')
    <strong>Examples: Polymorphic</strong>
@stop

@section('content')
    <div class="row">
        <div class="col-md-10">
            <p>
                The TCL Test Suite is a group of classes and operations which were created to vigorously test all operations of all four
                tree containers in the TCL.  This suite is a never ending project, so check back often for the latest Test Suite.
                The updated date will be provided on the download button below, to keep you informed of any changes made to this test suite.
                This test suite is compatible with VC7, VC8, and gcc.  At this time, the test suite is not compatible with VC6.
            </p>
            <p>
                The suite is used to check for insure proper operations for every tree interface.  These tests are especially
                important during development and after any TCL implementation change, to insure that no operations were
                broken during modification of TCL's source code.
            </p>
            <p>
                There are three good reasons you may want to download and use this test suite:
            </p>
            <ul>
                <li>
                    <b class='blue'>To study the source code in the test suite, to gain insight on using the library.</b><br/>
                    Although the examples on this site give you a good idea on how to use the TCL, the source
                    code in the test suite are a little more advanced.  Studying the code may give you insight
                    on different ways to use the TCL which you have not previously considered.
                </li>
                <li>
                    <b class='blue'>To insure yourself that the TCL is operating properly and as expected.</b><br/>
                    If you are unsure about specific operations in the TCL, and how they should perform,
                    studying the tests for those operations in the test suite may give you more insight
                    on the use of those operations.
                </li>
                <li>
                    <b class='blue'>When making your own changes to the TCL.</b><br/>
                    If you make any changes to the TCL yourself, this test suite is essential to insure all operations
                    are still working properly.
                </li>
            </ul>

            <p>
                To use the test suite, place create a test suite project, and add the source code files to the project.
                The main source file which includes main() is tcl_test_suite.cpp.
                You may need to edit the include paths for the TCL tree classes, depending on where you're TCL library
                files reside in respect to the test suite files.  For Visual C++ users, you may need to un-comment
                the top line of the cpp files, <code>#include "stdafx.h"</code>, if your project uses pre-compiled headers.
            </p>
            <p>
                The test suite currently populates the four trees with the hierarchies shown to the right, for testing purposes.
                The operation <code>populate_tree()</code> populates the trees according to figure 1.  The operation
                <code>insert_double_vowels()</code> in the associative tree tester adds (or attempts to add) duplicate
                nodes for the vowels, which would result in figure 2.  The operation <code>populate_wide_tree()</code> results
                in the tree hierarchy displayed in figure 3.
            </p>
            <p>
                When using descendant iterators in the test operations, note carefully which type of descendant iterators
                are being used, as the order of the node traversal will depend on the type of iterator.  The list below
                displays the traversal order of the tree hierarchy in figure 1, for the three types of descendant iterators.
            </p>
            <ul>
                <li>
                    <b class='green'>pre_order_iterator</b>: A D J K R S E L B F M T U N V C G H O W P I Q X Y Z
                </li>
                <li>
                    <b class='green'>post_order_iterator</b>: J R S K D L E A T U M V N F B G W O P H Y Z X Q I C
                </li>
                <li>
                    <b class='green'>level_order_iterator</b>: A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
                </li>
            </ul>
            <p>
                A tree hierarchy is used for the sequential_tree tests which is similar to that in figure 3, except
                the nodes are not in alphabetical order within their parent.  This allows the proper testing
                of the sort operations.
            </p>

            <p>
                Please email me if you have any questions, problems, or suggestions for this test suite.
            </p>

            <p id='download_para'>
                <span class="download_btn" onclick="check_acceptance()">Download TCL Test Suite for TCL version 5.0.6, Updated 1/01/08</span>

            </p>
            <form action='/tcl-test-suite' method='post'>
                <table id='id_download' class="ui-widget-content ui-corner-all">
                    <tr class="ui-widget-header ui-corner-top">
                        <th class="ui-corner-tl">Description</th>
                        <th>Date Updated</th>
                        <th class='col3'>Download Links</th>
                    </tr>