aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2011-05-05 14:09:48 +0300
committerSergey Poznyakoff <gray@gnu.org.ua>2011-05-05 14:39:29 +0300
commit6c3f6c1b02dd5f9ac343c713bdae4aa83bafc328 (patch)
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')
-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 @@
16.\" This file is part of SLB. 16.\" This file is part of SLB.
17.\" Copyright (C) 2011 Sergey Poznyakoff 17.\" Copyright (C) 2011 Sergey Poznyakoff
18.\" 18.\"
19.TH GRECS_SETUP 3 "May 4, 2011" "GRECS" "Grecs User Reference" 19.TH GRECS_SETUP 3 "May 5, 2011" "GRECS" "Grecs User Reference"
20.SH NAME 20.SH NAME
21GRECS_SETUP \- Initialize \fBgrecs\fR submodule. 21GRECS_SETUP \- Initialize \fBgrecs\fR submodule.
22.SH SYNOPSIS 22.SH SYNOPSIS
@@ -53,6 +53,11 @@ Disable the use of preprocessor.
53Create and install shared library \fBlibgrecs.so\fR. Install the 53Create and install shared library \fBlibgrecs.so\fR. Install the
54documentation as well. 54documentation as well.
55.TP 55.TP
56.B shared
57Create a shared convenience library. By default, a static library is
58created. Use this option if you want to incorporate grecs into another
59shared library.
60.TP
56.B std-pp-setup 61.B std-pp-setup
57Install the standard \fBpp-setup\fR file. 62Install the standard \fBpp-setup\fR file.
58.TP 63.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
29human-readable form and outputs it to file \fBfp\fR. 29human-readable form and outputs it to file \fBfp\fR.
30.PP 30.PP
31The location is output as follows: the file name, followed by a 31The location is output as follows: the file name, followed by a
32semicolon, followed by line number and another semicolon. 32semicolon, followed by the line number.
33.PP 33.PP
34If \fIlocus\fR is \fBNULL\fR, \fBgrecs_format_locus\fR returns without 34If \fIlocus\fR is \fBNULL\fR, \fBgrecs_format_locus\fR returns without
35doing anything. 35doing 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
58characters. This option is useful only together with 58characters. This option is useful only together with
59\fBGRECS_NODE_FLAG_VALUE\fR. 59\fBGRECS_NODE_FLAG_VALUE\fR.
60.TP 60.TP
61.B GRECS_NODE_FLAG_NOQUOTE
62Never quote values. If both \fBGRECS_NODE_FLAG_QUOTE\fR and
63\fBGRECS_NODE_FLAG_NOQUOTE\fR are given, the former takes precedence
64over the latter.
65.TP
61.B GRECS_NODE_FLAG_QUOTE_HEX 66.B GRECS_NODE_FLAG_QUOTE_HEX
62Print non-printable characters as C hex escapets. This option is 67Print non-printable characters as C hex escapets. This option is
63useful only together with \fBGRECS_NODE_FLAG_QUOTE\fR and 68ignored if \fBGRECS_NODE_FLAG_NOQUOTE\fR is set.
64\fBGRECS_NODE_FLAG_VALUE\fR.
65.TP 69.TP
66.B GRECS_NODE_FLAG_DEFAULT 70.B GRECS_NODE_FLAG_DEFAULT
67Same as 71Same as

Return to:

Send suggestions and report system problems to the System administrator.