     Description of atli

0. LICENSE
1. What is atli
2. How atli works
3. Files and subdirectories	
4. Compile and install
5. Execute
6. Author

0. LICENSE

Copyright (C) 2005 linxs<linxsy@gmail.com>
atli is controlled and maintained by the original author. atli 
is a program originally targeting at providing a quick way to 
develop application script language, which is extensible and 
flexible.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

1. What is atli
atli is a scripting interpreter program originally targeting at a 
quick way to develop particular applications scripting language, 
which can be used from Windows to Linux. Also atli can be used to 
write shell-script-like script to do some task.

2. How atli works
atli provides the basic elements of computer scripting, including 
variable, function, arithmatic expression, boolean expression, 
if-clause, loops and so on. Based on these elements, developer can 
write script to execute instructions in a controllable way for 
application purposes, such as automatic robustness test, variable 
operation flow controll, and so on.

atli provides interfaces to co-operate with application. So application
can inter-operate with atli to exchange data instructions through one
CALLBACK function.

The callback function defined by application is to called every time 
atil throws message to application. The return value of the callback 
function should be 0 or larger than 0, otherwise the executation of 
scripting stops.

3. Files and subdirectories
  - app  :the application based on atli dll library
  - bin  :the binary code
  - dll  :dll source code
  - src  :atli source code
  - script:atli script files

4. Compile and install
>>> win32
    atli uses vs.net to compile the source code. The project solution 
    file is in the fold of $atli\dll\Dll.sln. To use other c++ compiler 
    tool, it is required to make sure the tool supports STL fully. 
    The release tar file contains the binary executable files in the 
    fold $atli/bin/win32.

>>> linux
    atli can be compiled by gcc 3.3 and its later version. The typically 
    steps are:
      $cd $atli
      $./configure
      $make
      $su -c 'make install'
   NOTE: When run the program "atli", you may get message complain that 
         libatlidll.so.0 can not be found. The following steps is 
         required as root:
         #cd /etc
         #vi ld.so.conf
            // add one line: /usr/local/lib to /etc/ld.so.conf
         #ldconf
    The release tar file contains the binary executable files in the 
    fold $atli/bin/linux. I uses Fedora-2 to compile it. 

5. Execute
>>> win32
   The command line is as follow:
     $atli <ats filename> <option> <parameter passed to atli script>
   The fold of $atli/script/*.ats are atli script. 
>>> linux
   It is the same as in win32 to use atli in linux. 
   Another way is more convenient to execute atli script. Add the 
   following line: 
      #!/usr/local/bin/atli
   as the first head in atli script file. Then change the mode of file as 
   executable. Now you can run the script file as ./filename.ats.
 

6. Author
Author:  linxs
Email:   linxsy@gmail.com

