]> rtime.felk.cvut.cz Git - boost-statechart-viewer.git/blobdiff - www/index.mdwn
Do not require C++11 capable compiler
[boost-statechart-viewer.git] / www / index.mdwn
index 97f6d3ac78368f752538402324ceffcd28395a2d..6c4bf13931b98ddaa486f6c6ea891bee3ca5d276 100644 (file)
@@ -1,27 +1,93 @@
 [[!meta title="Boost Statechart Viewer"]]
 
-Overview:
-Boost-staechart-viewer is a program for visualization state machines written using library boost/statechart. It is written in c++ using clang and LLVM. For compiling and correctly working program is necessary to have LLVM and clang version 2.9.
+Overview
+---------
 
-Authors:
-Michal Sojka  sojkam1@fel.cvut.cz
-Petr Silhavik silhape2@fel.cvut.cz
+Boost-statechart-viewer is a program for visualization of state
+machines written in C++ with [boost][boost]/[statechart][statechart]
+library. The program itself is written in C++ and uses [clang][clang]
+from [LLVM][llvm] project for analyzing the source code. This program
+is released under the GNU GPL license.
 
-Status:
-Program can found states and transitions. Now it doesn't support orthogonal states. The state machine can be inside many namespaces, but not inside templates. State machine can be defined in more than one file. Program accepts all options and flags of command line as compilers(gcc, clang, ...).
+[boost]: http://www.boost.org/
+[statechart]: http://www.boost.org/doc/libs/1_46_1/libs/statechart/doc/index.html
+[clang]: http://clang.llvm.org/
+[llvm]: http://llvm.org/
 
-Using:
-For using the program you need to specify locations for all header files except of the files stored in system folder(in linux: /usr/...) using -I option. Of course you can specify the output filename(-o). Program displays all diagnostic messages like compilers. If an error occurs the program stops.
+NEWS
+-----
+- 2012-07-11 We have got a new [mailing list][list].
+- 2011-08-11 Added support for orthogonal states.
 
-Example of using command line: 
-./visualizer main.cpp -o graph.dot -I /home/petr/install/
+Authors
+--------
 
-The output file can be transformed into the picture using classical dot commands. The start state is double outllined. Each transition has transition has label with the name of the event.
+[list]: https://rtime.felk.cvut.cz/mailman/listinfo/boost-statechart-viewer
+
+Petr Silhavik, Michal Sojka. You can contact us using a
+[mailing list][list] at <boost-statechart-viewer@rtime.felk.cvut.cz>.
+
+Status
+-------
+
+- The program can found states and transitions in the source code. Now it also supports orthogonal states.
+- The program understands all options and flags as the compilers (gcc, clang, ...).
+- State machines can be defined in more than one file.
+- The state machine can be inside many namespaces, but not inside templates.
+
+For compiling and correctly working program it is necessary to have
+LLVM and clang version 2.9. We are currently trying to update it for
+LLVM 3.1.
+
+
+Usage
+------
+
+The program can be used almost the same way as a C compiler. You will
+typically need to specify locations for all header files except of the
+files stored in system folder(in Linux: /usr/...) using `-I` option.
+Of course you can specify the output filename (`-o` option). Program
+displays all diagnostic messages like compilers. If an error occurs
+the program stops.
+
+####Example of command line invocation: 
+
+    ./visualizer main.cpp -o graph.dot -I /home/petr/install/
+
+The output file can be transformed into the picture using classical
+[dot][graphviz] commands (e.g. `dot -Tpng graph.dot -o graph.png`) . The initial
+state is double outlined. Each transition has a label with the name of
+the triggering event.
+
+[graphviz]: http://www.graphviz.org/
 
 Download:
+---------
+
 Boost statechart viewer can be downloaded from GIT repository.
 
-git clone git://rtime.felk.cvut.cz/boost-statechart-viewer.git
+    git clone git://rtime.felk.cvut.cz/boost-statechart-viewer.git
+
+You can also browse the [repository online][1].
+
+
+Gallery
+-------
+
+### Small
+[[small.png]]  
+[[Source code|test.cpp]]
+
+### StopWatch
+[[stopWatch.png]]  
+[[Source code|StopWatch.cpp]]
+
+### Camera
+[[camera.png]]  
+[[Source code|StopWatch.cpp]]
 
-You can also browse the repository online.
+### Big
+[[big.png]]  
+[[Source code|big_sm.tar.gz]]
 
+  [1]: http://rtime.felk.cvut.cz/gitweb/boost-statechart-viewer.git