=========
aster-mode
==========

Author: Stefan Reiterer
Date: 
06/13/2015

Vers: 0.4

===========


This is the aster-mode for emacs. Currently it only
supports syntax highlighting, and automatic recognition
of .comm and .mess files.
It is derived from Python-mode and thus supports
Python syntax.
It also comes with a broad collection of snippets for ya snippet.

===========

Installing:

===========

Prerequisites:

python-mode has to be installed

Mode: 

Extract aster-mode.el in to a folder and add the lines

(setq asterDir "/opt/aster") ;; Dir to aster. Change if necessary!
(load "/dir/to/folder/aster-mode")

to your ~/.emacs

For Salome Meca users: The dir for the bins should be located in
/dir/to/Salome_Meca/salome_meca2015_1/V2015_1/tools/Code_aster_frontend_20151/

==========

snippets:

Install YA snippet https://github.com/capitaomorte/yasnippet 
and add contents of snippets in the folder 

/dir/to/yasnippet/snippets/aster-mode

by copying the files or making a link with

ln -s /dir/to/aster-mode/snippets /dir/to/yasnippet/snippets/aster-mode

setup example (in bash using git)
==========

cd ~/.emacs.d/
mkdir plugins
cd plugins
git clone https://github.com/maldun/aster-mode.git aster-mode
git clone --recursive https://github.com/capitaomorte/yasnippet yasnippet
ln -s aster-mode/snippets yasnippet/snippets/aster-mode

Now open or create ~/.emacs and add the following lines:
(setq asterDir "/opt/aster/")
(load "~/.emacs.d/plugins/aster-mode/aster-mode.el")

UnitCalculator
==============

aster-mode includes a snippet to support usage of UnitCalculator, which
is useful to bring units into .comm for better readability and to avoid
errors with manual unit conversion.

Unit calculator can be installed with git by:

(cd to some dir you want e.g. ~/ ) 
git clone https://github.com/maldun/UnitCalculator.git UnitCalculator

Maintainance
============

Currently I will only support the current stable and testing versions
of Code_Aster. If a new development cycle of Code_Aster starts, I will
create a branch with the old version, but don't add any new features,
except the are explicitely requested. Since Code_Aster develops really
fast, and often breaks backward compability with it's prior versions,
it would be too much effort to keep everything up to date. I will keep
as much as possible for backwards compability, but if something would create
incompabilities I won't integrate it!
Nevertheless this is an open project so people are welcome to contribute
features for older versions.

License
=======

Maintainer: Stefan Reiterer <stefan.harald.reiterer@gmail.com>

Copyright (C) 2014 Stefan Reiterer

Author: 2014 Stefan Reiterer

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 3 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, see <http://www.gnu.org/licenses/>.