path: root/README.submodule
authorSergey Poznyakoff <>2011-05-08 21:18:34 (GMT)
committer Sergey Poznyakoff <>2011-05-08 21:18:34 (GMT)
commitc9bb1bdfd12dce4d20375e6bd3bf6d41417191d8 (patch) (side-by-side diff)
tree5039c88670bfa2596151ca467f75df7cec030503 /README.submodule
parente523423777dd75acc59cf7b9e7466527d774a9f9 (diff)
Write README files.
Diffstat (limited to 'README.submodule') (more/less context) (ignore whitespace changes)
1 files changed, 85 insertions, 0 deletions
diff --git a/README.submodule b/README.submodule
new file mode 100644
index 0000000..03428d4
--- a/dev/null
+++ b/README.submodule
@@ -0,0 +1,85 @@
+Copyright (C) 2011 Sergey Poznyakoff
+See the end of file for copying conditions.
+* Introduction
+This file contains brief information about using Grecs as a submodule.
+You will find a complete documentation for Grecs, in form of man
+pages, in the doc/ subdirectory.
+An online copy of the documentation in various formats is available
+If you are interested in libgrecs, a standalone library implementation
+of Grecs, see the file README.standalone in this directory, or visit
+* Overview
+Grecs is a library for parsing structured configuration files from
+C programs. A structured configuration file has hierarchical
+structure, with block statements enclosing lower-level
+statements. Such configurations files are used by many programs, such
+as, e.g. Bind or Dico.
+Grecs provides primitives for parsing such files into an internal
+tree-like structure and for basic operations on such structures. These
+operations include value lookups by keyword paths, traversing trees
+recursively, joining several trees together, reductions, etc.
+* Usage
+1. Install grecs as a submodule:
+ git submodule grecs
+2. Add a call to GRECS_SETUP to your It can be as
+simple as:
+If the subproject directory is not 'grecs', supply the actual
+directory name as the first argument to this macro, e.g.:
+ GRECS_SETUP(lib/grecs)
+For a detailed description of the GRECS_SETUP macro, run
+`man doc/GRECS_SETUP.3'.
+3. In your, add @GRECS_INCLUDES@ to the INCLUDES value,
+and @GRECS_LDADD@ to LDADD, e.g.:
+4. Include "grecs.h"
+5. Use the library to handle your configuration files. See the
+documentation for a detailed discussion.
+* Bug reporting.
+Send bug reports to <>.
+* Copyright information:
+Copyright (C) 2011 Sergey Poznyakoff
+ Permission is granted to anyone to make or distribute verbatim copies
+ of this document as received, in any medium, provided that the
+ copyright notice and this permission notice are preserved,
+ thus giving the recipient permission to redistribute in turn.
+ Permission is granted to distribute modified versions
+ of this document, or of portions of it,
+ under the above conditions, provided also that they
+ carry prominent notices stating who last changed them.
+Local Variables:
+mode: outline
+paragraph-separate: "[ ]*$"
+version-control: never

Return to:

Send suggestions and report system problems to the System administrator.