summaryrefslogtreecommitdiffabout
path: root/doc
authorSergey Poznyakoff <gray@gnu.org.ua>2011-05-05 11:09:48 (GMT)
committer Sergey Poznyakoff <gray@gnu.org.ua>2011-05-05 11:39:29 (GMT)
commit6c3f6c1b02dd5f9ac343c713bdae4aa83bafc328 (patch) (side-by-side diff)
tree49bc8df1cff7157c711c63447c3e272ebc67cd4c /doc
parenta60eb4b18345626a84e23784d77ca231812e1dff (diff)
downloadgrecs-6c3f6c1b02dd5f9ac343c713bdae4aa83bafc328.tar.gz
grecs-6c3f6c1b02dd5f9ac343c713bdae4aa83bafc328.tar.bz2
Improve node formatting. Add version comparasion functions.
* am/grecs.m4 (GRECS_SETUP): New option: shared. * doc/GRECS_SETUP.3: Document new options. * doc/grecs_format_locus.3: Update. * doc/grecs_format_node.3: Document new flags. * src/.gitignore: Update. * src/version.c: New file. * src/Make.am (GRECS_SRC): Add version.c (EXTRA_DIST): Update. * src/diag.c (default_print_diag): Flush stdout as per the docs. * src/format.c (grecs_format_locus): Don't print trailing semicolon. (grecs_format_value): Handle GRECS_NODE_FLAG_NOQUOTE flag. (grecs_format_node): Print delimiters when needed. * src/grecs.h (grecs_version_info): New struct. (grecs_version, grecs_version_cmp): New protos. (GRECS_NODE_FLAG_NOQUOTE): New flag. * tests/gcfver.c: New file. * tests/vercmp.at: New file. * tests/.gitignore: Update. * tests/Makefile.am: Define GRECS_VERCMP_AT in package.m4 (TESTSUITE_AT): Add vercmp.at (conditionally). (noinst_PROGRAMS): Add gcfver. * tests/testsuite.at: Conditionally include vercmp.at.
Diffstat (limited to 'doc') (more/less context) (ignore whitespace changes)
-rw-r--r--doc/GRECS_SETUP.37
-rw-r--r--doc/grecs_format_locus.32
-rw-r--r--doc/grecs_format_node.38
3 files changed, 13 insertions, 4 deletions
diff --git a/doc/GRECS_SETUP.3 b/doc/GRECS_SETUP.3
index 23c0ad5..af0f8e0 100644
--- a/doc/GRECS_SETUP.3
+++ b/doc/GRECS_SETUP.3
@@ -16,7 +16,7 @@
.\" This file is part of SLB.
.\" Copyright (C) 2011 Sergey Poznyakoff
.\"
-.TH GRECS_SETUP 3 "May 4, 2011" "GRECS" "Grecs User Reference"
+.TH GRECS_SETUP 3 "May 5, 2011" "GRECS" "Grecs User Reference"
.SH NAME
GRECS_SETUP \- Initialize \fBgrecs\fR submodule.
.SH SYNOPSIS
@@ -53,6 +53,11 @@ Disable the use of preprocessor.
Create and install shared library \fBlibgrecs.so\fR. Install the
documentation as well.
.TP
+.B shared
+Create a shared convenience library. By default, a static library is
+created. Use this option if you want to incorporate grecs into another
+shared library.
+.TP
.B std-pp-setup
Install the standard \fBpp-setup\fR file.
.TP
diff --git a/doc/grecs_format_locus.3 b/doc/grecs_format_locus.3
index 3803c2b..90ffa03 100644
--- a/doc/grecs_format_locus.3
+++ b/doc/grecs_format_locus.3
@@ -29,7 +29,7 @@ grecs_format_locus \- format and output source file location
human-readable form and outputs it to file \fBfp\fR.
.PP
The location is output as follows: the file name, followed by a
-semicolon, followed by line number and another semicolon.
+semicolon, followed by the line number.
.PP
If \fIlocus\fR is \fBNULL\fR, \fBgrecs_format_locus\fR returns without
doing anything.
diff --git a/doc/grecs_format_node.3 b/doc/grecs_format_node.3
index d1d8b02..76cebec 100644
--- a/doc/grecs_format_node.3
+++ b/doc/grecs_format_node.3
@@ -58,10 +58,14 @@ when necessary, i.e. if it contains white space, quotes or special
characters. This option is useful only together with
\fBGRECS_NODE_FLAG_VALUE\fR.
.TP
+.B GRECS_NODE_FLAG_NOQUOTE
+Never quote values. If both \fBGRECS_NODE_FLAG_QUOTE\fR and
+\fBGRECS_NODE_FLAG_NOQUOTE\fR are given, the former takes precedence
+over the latter.
+.TP
.B GRECS_NODE_FLAG_QUOTE_HEX
Print non-printable characters as C hex escapets. This option is
-useful only together with \fBGRECS_NODE_FLAG_QUOTE\fR and
-\fBGRECS_NODE_FLAG_VALUE\fR.
+ignored if \fBGRECS_NODE_FLAG_NOQUOTE\fR is set.
.TP
.B GRECS_NODE_FLAG_DEFAULT
Same as

Return to:

Send suggestions and report system problems to the System administrator.