README


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

#############################################
#Please use git log for copyright holder and year information
#
#This file is part of libbash.
#
#libbash 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.
#
#libbash 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 libbash.  If not, see <http://www.gnu.org/licenses/>.
###############################################

This is the README file for libbash

Directory information:
bashast/: Grammar file
bashast/gunit: Grammar gunit tests
src/: source directory for libbash library
src/builtins: source directory for built in bash functionality classes
src/builtins/tests: Unit tests for builtins
src/core: core runtime for libbash
src/core/tests: Unit tests for the core runtime
include/: public headers
utils/: some utilities that built on libbash
test/: some general tests for libbash
scripts/: some bash scripts or ebuilds for testing
doc/: documentation for libbash
doc/coding_standard/: LaTeX coding standard for the project
doxygen-doc/: output folder for Doxygen generated documentation

Build Instructions:

./autogen.sh

This will run ./configure for you so you are ready to build the thing.
Now you can run make check to build the library and run tests. Other
available targets:

To build ANTLR C runtime libraries from grammar:
	make grammar.run
To generate the coding standard from the latex file (with pdflatex):
	make coding_standard.pdf
To generate the doxygen documentation:
	make doxygen-doc
To get memory usage statstics of libbash (with Valgrind):
	make massif
To get benchmark data for metadata generation (with Valgrind):
	make benchmark_parser
To get unit tests coverage:
	make test_coverage