diff --git a/documentation/current/eiffelstudio/eiffelstudio-guided-tour/using-autotest/index.wiki b/documentation/current/eiffelstudio/eiffelstudio-guided-tour/using-autotest/index.wiki index 77c8411b..4d101cca 100644 --- a/documentation/current/eiffelstudio/eiffelstudio-guided-tour/using-autotest/index.wiki +++ b/documentation/current/eiffelstudio/eiffelstudio-guided-tour/using-autotest/index.wiki @@ -8,7 +8,7 @@ AutoTest is a tool that helps you to create, manage, and run tests against your This tutorial will guide you through the use of AutoTest. A [[AutoTest|reference section]] for AutoTest is also available. -{{note|It is recommended, at least on your first viewing of this tutorial, that you take the sections in the order in which they are presented. There are three different types of tests supported by AutoTest. Each type of test is discussed on its own page. But to avoid repetition, the pages for the second and third types of tests omit some of the detail in the first and assume a familiarity with the example. }} +{{Recommended|At least on your first viewing of this tutorial, take the sections in the order in which they are presented. There are three different types of tests supported by AutoTest. Each type of test is discussed on its own page. But to avoid repetition, the pages for the second and third types of tests omit some of the detail in the first and assume a familiarity with the example. }} {{SeeAlso|
[[AutoTest]] reference }} diff --git a/documentation/current/method/eiffel-tutorial-et/et-instructions.wiki b/documentation/current/method/eiffel-tutorial-et/et-instructions.wiki index 53163f22..ffbabac5 100644 --- a/documentation/current/method/eiffel-tutorial-et/et-instructions.wiki +++ b/documentation/current/method/eiffel-tutorial-et/et-instructions.wiki @@ -87,7 +87,7 @@ So, this usage of the loop construct has been the traditional mechanism for trav across my_list as c loop print (c.item) end -Here the across indicates an iteration process across the structure my_list. The as c indicates that a cursor object referenced by the name c will be created to effect the iteration. The element of my_list which is currently referenced by the cursor c is c.item as you see in the call to print (c.item) loop body. The loop body does not contain the call to the structure's forth feature, as our more traditional example did. Neither do you see the call to start nor the check of off in the exit condition. The semantics of the iteration abstract these for you and relieve you of their burden ... while eliminating opportunities for error. +Here the across indicates an iteration process across the structure my_list. The as c indicates that a cursor object referenced by the name c, and available only for the scope of the iteration, will be created to effect the iteration. The element of my_list which is currently referenced by the cursor c is c.item as you see in the call to print (c.item) loop body. The loop body does not contain the call to the structure's forth feature, as our more traditional example did. Neither do you see the call to start nor the check of off in the exit condition. The semantics of the iteration abstract these for you and relieve you of their burden ... and some opportunities for error. Concerning cursors, both ways of using the loop construct to traverse a structure employ a cursor. In the traditional usage, the cursor is internal to the structure object, the instance of LINKED_LIST [STRING] called my_list, in the case of the example. Applying the feature item to my_list retrieves the list element currently referenced by the cursor. In the iteration version of traversal, the variable c holds the iteration cursor, external to the list object. So, you apply c.item to get the current list element. The obvious use is for instructions that should be part of the system but executed only in some circumstances, for example to provide extra debugging information. The advantage to the external cursor is that multiple traversals of the structure can occur simultaneously without interfering with one another. This is possible in the traditional usage, but only by saving and restoring the structure's cursor.