X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/7fdd9d11419684606beb08a8a7bc673955eb08af..809ce498a496be4898e4ed739c54b129b55be4c0:/doc/gtut-tour.doc

diff --git a/doc/gtut-tour.doc b/doc/gtut-tour.doc
index 9d6db8f782..402a7f0a24 100644
--- a/doc/gtut-tour.doc
+++ b/doc/gtut-tour.doc
@@ -16,78 +16,145 @@ all features available in GRAS.
       DOXYGEN_NAVBAR_CHILD "6: Logs"=GRAS_tut_tour_logs.html
       DOXYGEN_NAVBAR_CHILD "7: Timers"=GRAS_tut_tour_timers.html
       DOXYGEN_NAVBAR_CHILD "8: Exceptions"=GRAS_tut_tour_exceptions.html
-      DOXYGEN_NAVBAR_CHILD "9: RPC"=GRAS_tut_tour_rpc.html
+      DOXYGEN_NAVBAR_CHILD "9: Data exchange"=GRAS_tut_tour_simpledata.html
+      DOXYGEN_NAVBAR_CHILD "10: RPC"=GRAS_tut_tour_rpc.html
+      DOXYGEN_NAVBAR_CHILD "11: Explicit wait"=GRAS_tut_tour_explicitwait.html
+      DOXYGEN_NAVBAR_CHILD "Recapping part 1"=GRAS_tut_tour_message_recaping.html
+      DOXYGEN_NAVBAR_CHILD "12: Static data definition"=GRAS_tut_tour_staticstruct.html
+      DOXYGEN_NAVBAR_CHILD "13: Pointers definition"=GRAS_tut_tour_pointers.html
+      DOXYGEN_NAVBAR_CHILD "14: Dynars definition"=GRAS_tut_tour_dynars.html
+      DOXYGEN_NAVBAR_CHILD "15: Manual data definition"=GRAS_tut_tour_manualdatadef.html
+      DOXYGEN_NAVBAR_CHILD "16: Advanced data definition"=GRAS_tut_tour_exchangecb.html
     --> \endhtmlonly
 
- - \ref GRAS_tut_tour_setup
-    - \ref GRAS_tut_tour_setup_C
-    - \ref GRAS_tut_tour_setup_plat
-    - \ref GRAS_tut_tour_setup_deploy
-    - \ref GRAS_tut_tour_setup_glue
-    - \ref GRAS_tut_tour_setup_make
-    - \ref GRAS_tut_tour_setup_start
+<b>Part 1: Bases</b>
+
+   - \ref GRAS_tut_tour_install
+
+   - \ref GRAS_tut_tour_setup
+      - \ref GRAS_tut_tour_setup_C
+      - \ref GRAS_tut_tour_setup_plat
+      - \ref GRAS_tut_tour_setup_deploy
+      - \ref GRAS_tut_tour_setup_glue
+      - \ref GRAS_tut_tour_setup_make
+      - \ref GRAS_tut_tour_setup_start
+  
+<b>Part 2: Message passing</b>
+  
+   - \ref GRAS_tut_tour_simpleexchange
+      - \ref GRAS_tut_tour_simpleexchange_msgtype
+      - \ref GRAS_tut_tour_simpleexchange_socks
+      - \ref GRAS_tut_tour_simpleexchange_exchange
+      - \ref GRAS_tut_tour_simpleexchange_recaping
     
- - \ref GRAS_tut_tour_simpleexchange
-    - \ref GRAS_tut_tour_simpleexchange_msgtype
-    - \ref GRAS_tut_tour_simpleexchange_socks
-    - \ref GRAS_tut_tour_simpleexchange_exchange
-    - \ref GRAS_tut_tour_simpleexchange_recaping
+   - \ref GRAS_tut_tour_args
+      - \ref GRAS_tut_tour_args_use
+      - \ref GRAS_tut_tour_args_sg
+      - \ref GRAS_tut_tour_args_recap
     
- - \ref GRAS_tut_tour_args
-    - \ref GRAS_tut_tour_args_use
-    - \ref GRAS_tut_tour_args_sg
-    - \ref GRAS_tut_tour_args_recap
+   - \ref GRAS_tut_tour_callbacks
+      - \ref GRAS_tut_tour_callbacks_declare
+      - \ref GRAS_tut_tour_callbacks_attach
+      - \ref GRAS_tut_tour_callbacks_handle
+      - \ref GRAS_tut_tour_callback_recap
+     
+   - \ref GRAS_tut_tour_globals
+      - \ref GRAS_tut_tour_globals_intro
+      - \ref GRAS_tut_tour_globals_use
+      - \ref GRAS_tut_tour_callback_pitfall
+      - \ref GRAS_tut_tour_callback_recap
+      
+   - \ref GRAS_tut_tour_logs
+      - \ref GRAS_tut_tour_logs_intro
+      - \ref GRAS_tut_tour_logs_practice
+      - \ref GRAS_tut_tour_logs_recap
+      - \ref GRAS_tut_tour_logs_config
     
- - \ref GRAS_tut_tour_callbacks
-    - \ref GRAS_tut_tour_callbacks_declare
-    - \ref GRAS_tut_tour_callbacks_attach
-    - \ref GRAS_tut_tour_callbacks_handle
-    - \ref GRAS_tut_tour_callback_recap
+   - \ref GRAS_tut_tour_timers
+      - \ref GRAS_tut_tour_timers_intro
+      - \ref GRAS_tut_tour_timers_use
+      - \ref GRAS_tut_tour_timers_recap
     
- - \ref GRAS_tut_tour_globals
-    - \ref GRAS_tut_tour_globals_intro
-    - \ref GRAS_tut_tour_globals_use
-    - \ref GRAS_tut_tour_callback_pitfall
-    - \ref GRAS_tut_tour_callback_recap
-    
- - \ref GRAS_tut_tour_logs
-    - \ref GRAS_tut_tour_logs_intro
-    - \ref GRAS_tut_tour_logs_practice
-    - \ref GRAS_tut_tour_logs_recap
-    - \ref GRAS_tut_tour_logs_config
-    
- - \ref GRAS_tut_tour_timers
-    - \ref GRAS_tut_tour_timers_intro
-    - \ref GRAS_tut_tour_timers_use
-    - \ref GRAS_tut_tour_timers_recap
-    
- - \ref GRAS_tut_tour_exceptions
-    - \ref GRAS_tut_tour_exceptions_intro
-    - \ref GRAS_tut_tour_exceptions_use
-    - \ref GRAS_tut_tour_exceptions_recap
-    
- - \ref GRAS_tut_tour_rpc
-    - \ref GRAS_tut_tour_rpc_intro
-    - \ref GRAS_tut_tour_rpc_use
-    - \ref GRAS_tut_tour_rpc_recap
+   - \ref GRAS_tut_tour_exceptions
+      - \ref GRAS_tut_tour_exceptions_intro
+      - \ref GRAS_tut_tour_exceptions_use
+      - \ref GRAS_tut_tour_exceptions_recap
+     
+   - \ref GRAS_tut_tour_simpledata
+      - \ref GRAS_tut_tour_simpledata_intro
+         - \ref GRAS_tut_tour_simpledata_intro_conv
+         - \ref GRAS_tut_tour_simpledata_intro_gras
+         - \ref GRAS_tut_tour_simpledata_use
+      - \ref GRAS_tut_tour_simpledata_example
+      - \ref GRAS_tut_tour_simpledata_recap
+      
+   - \ref GRAS_tut_tour_rpc
+      - \ref GRAS_tut_tour_rpc_intro
+      - \ref GRAS_tut_tour_rpc_use
+         - \ref GRAS_tut_tour_rpc_use_declare
+         - \ref GRAS_tut_tour_rpc_use_i2a_cb
+         - \ref GRAS_tut_tour_rpc_use_a2i_cb
+         - \ref GRAS_tut_tour_rpc_use_rest
+      - \ref GRAS_tut_tour_rpc_recap
  
+   - \ref GRAS_tut_tour_explicitwait
+     - GRAS_tut_tour_explicitwait_intro
+     - GRAS_tut_tour_explicitwait_use
+     - GRAS_tut_tour_explicitwait_recap
+     
+   - \ref GRAS_tut_tour_message_recaping
+      - \ref GRAS_tut_tour_message_recaping_intro
+      - \ref GRAS_tut_tour_message_recaping_rpc
+         - \ref GRAS_tut_tour_message_recaping_rpc1
+	 - \ref GRAS_tut_tour_message_recaping_rpc2
+         - \ref GRAS_tut_tour_message_recaping_rpc3
+	 - \ref GRAS_tut_tour_message_recaping_rpc4
+         - \ref GRAS_tut_tour_message_recaping_rpc5
+         - \ref GRAS_tut_tour_message_recaping_rpc_aside1
+	 - \ref GRAS_tut_tour_message_recaping_rpc_aside2
+	 - \ref GRAS_tut_tour_message_recaping_rpc_aside3
+      - \ref GRAS_tut_tour_message_recaping_sync
+		       
+<b>Part 3: Data description</b>
+
+   - \ref GRAS_tut_tour_staticstruct Automatic parsing of static data types
+      - \ref GRAS_tut_tour_staticstruct_intro
+      - \ref GRAS_tut_tour_staticstruct_use
+      - \ref GRAS_tut_tour_staticstruct_recap
+      
+   - \ref GRAS_tut_tour_pointers Automatic parsing of datatypes containing pointers
+      - \ref GRAS_tut_tour_pointers_intro
+      - \ref GRAS_tut_tour_pointers_use
+      - \ref GRAS_tut_tour_pointers_recap
+      
+   - \ref GRAS_tut_tour_dynar Exchanging dynars (and matrices)
+      - \ref GRAS_tut_tour_dynar_intro
+      - \ref GRAS_tut_tour_dynar_use
+      - \ref GRAS_tut_tour_dynar_recap
+      
+   - \ref GRAS_tut_tour_manualdatadef Manual data description: the full power
+      - \ref GRAS_tut_tour_manualdatadef_intro
+      - \ref GRAS_tut_tour_manualdatadef_use
+      - \ref GRAS_tut_tour_manualdatadef_recap
+      
+   - \ref GRAS_tut_tour_exchangecb Exchange callbacks: yes you can
+      - \ref GRAS_tut_tour_exchangecb_intro
+      - \ref GRAS_tut_tour_exchangecb_use
+      - \ref GRAS_tut_tour_exchangecb_recap
+
+<b>Part 4: Advanced topics</b>
+
+Unfortunately, the tour is not terminated yet, but I already know the kind
+of missi^W lessons I want to add:
+
+   - Computation virtualization
+   - Splitting in several files (logs, datadesc)
+   - Debugging GRAS programs
+   - Doing proper GRAS modules
+  
 <hr>
 
 
-\section GRAS_tut_tour_todo TODO
-
-Unfortunately, the tour is not terminated yet, and here are some ideas of
-missing missi^W lessons:
-
-- Lesson 10: Exchanging simple data through ping-pong
-- Lesson 11: More complex data description (automatic parsing, manual
-   description) and example. May need more than one lesson.
-
-- Lesson 12: Splitting in several files
-
-- Lesson 13: Debuging GRAS programs
-
-- Lesson 14: Doing proper modules
 
 */