aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org>2016-08-08 08:53:46 +0300
committerSergey Poznyakoff <gray@gnu.org>2016-08-08 08:53:46 +0300
commitbd5b7c29986b8106595f35cbe303fc44cf8c4d0d (patch)
tree84b39cc6d228b3642f7105c48162193a05982882 /doc
parent102d1b9c1a94548dfa0c498845c77933db6a7738 (diff)
downloadgrecs-bd5b7c29986b8106595f35cbe303fc44cf8c4d0d.tar.gz
grecs-bd5b7c29986b8106595f35cbe303fc44cf8c4d0d.tar.bz2
Rename the projectargot
Diffstat (limited to 'doc')
-rw-r--r--doc/ARGOT_SETUP.3 (renamed from doc/GRECS_SETUP.3)38
-rw-r--r--doc/Makefile.am32
-rw-r--r--doc/argot-syntax.texi (renamed from doc/grecs-syntax.texi)8
-rw-r--r--doc/argot_asprintf.3 (renamed from doc/grecs_asprintf.3)28
-rw-r--r--doc/argot_config.5 (renamed from doc/grecs_config.5)20
-rw-r--r--doc/argot_error.3 (renamed from doc/grecs_error.3)48
-rw-r--r--doc/argot_format_locus.3 (renamed from doc/grecs_format_locus.3)32
-rw-r--r--doc/argot_format_node.3 (renamed from doc/grecs_format_node.3)56
-rw-r--r--doc/argot_format_node_path.3 (renamed from doc/grecs_format_node_path.3)36
-rw-r--r--doc/argot_format_value.3 (renamed from doc/grecs_format_value.3)30
-rw-r--r--doc/argot_include_path_setup.3 (renamed from doc/grecs_include_path_setup.3)26
-rw-r--r--doc/argot_malloc.3 (renamed from doc/grecs_malloc.3)72
-rw-r--r--doc/argot_node_free.3 (renamed from doc/grecs_node_free.3)20
-rw-r--r--doc/argot_parse.3 (renamed from doc/grecs_parse.3)92
-rw-r--r--doc/argot_stmt_path.5 (renamed from doc/grecs_stmt_path.5)12
-rw-r--r--doc/argot_strdup.3 (renamed from doc/grecs_strdup.3)24
-rw-r--r--doc/argot_tree_free.3 (renamed from doc/grecs_tree_free.3)20
-rw-r--r--doc/tmpl.310
-rw-r--r--doc/wordsplit.36
19 files changed, 305 insertions, 305 deletions
diff --git a/doc/GRECS_SETUP.3 b/doc/ARGOT_SETUP.3
index 8aa086a..3c18d1e 100644
--- a/doc/GRECS_SETUP.3
+++ b/doc/ARGOT_SETUP.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,14 +14,14 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_SETUP 3 "August 13, 2012" "GRECS" "Grecs User Reference" 17.TH ARGOT_SETUP 3 "August 13, 2012" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19GRECS_SETUP \- Initialize \fBgrecs\fR submodule. 19ARGOT_SETUP \- Initialize \fBargot\fR submodule.
20.SH SYNOPSIS 20.SH SYNOPSIS
21.BI "GRECS_SETUP(" "dir" ", " "options" ", " "pp-setup-file" ) 21.BI "ARGOT_SETUP(" "dir" ", " "options" ", " "pp-setup-file" )
22.SH DESCRIPTION 22.SH DESCRIPTION
23The \fBGRECS_SETUP\fR macro is invoked from the host project's 23The \fBARGOT_SETUP\fR macro is invoked from the host project's
24\fBconfigure.ac\fR. It initializes the \fBgrecs\fR submodule 24\fBconfigure.ac\fR. It initializes the \fBargot\fR submodule
25variables for compilation within that project. 25variables for compilation within that project.
26.PP 26.PP
27All arguments are optional. 27All arguments are optional.
@@ -29,15 +29,15 @@ All arguments are optional.
29The 29The
30.I dir 30.I dir
31argument specifies the directory, relative to the source tree top, 31argument specifies the directory, relative to the source tree top,
32where \fBgrecs\fR has been cloned. If omitted, \fBgrecs\fR is assumed. 32where \fBargot\fR has been cloned. If omitted, \fBargot\fR is assumed.
33.sp 33.sp
34For example, if \fBgrecs\fR was cloned using the following command: 34For example, if \fBargot\fR was cloned using the following command:
35.sp 35.sp
36.nf 36.nf
37 git clone ssh://git.gnu.org.ua/gitroot/grecs.git lib/grecs 37 git clone ssh://git.gnu.org.ua/gitroot/argot.git lib/argot
38.fi 38.fi
39.sp 39.sp
40then the \fIdir\fR argument must be \fBlib/grecs\fR. 40then the \fIdir\fR argument must be \fBlib/argot\fR.
41.PP 41.PP
42The 42The
43.I options 43.I options
@@ -63,19 +63,19 @@ Build the parser for MeTA1 configuration files.
63Disable the use of preprocessor. 63Disable the use of preprocessor.
64.TP 64.TP
65.B install 65.B install
66Create and install shared library \fBlibgrecs.so\fR. Install the 66Create and install shared library \fBlibargot.so\fR. Install the
67documentation as well. 67documentation as well.
68.TP 68.TP
69.B shared 69.B shared
70Create a shared convenience library. By default, a static library is 70Create a shared convenience library. By default, a static library is
71created. Use this option if you want to incorporate grecs into another 71created. Use this option if you want to incorporate argot into another
72shared library. 72shared library.
73.TP 73.TP
74.B install-header 74.B install-header
75Install header files. This option is valid only when used together 75Install header files. This option is valid only when used together
76with \fBshared\fR. Header files will be installed in 76with \fBshared\fR. Header files will be installed in
77\fBpkgincludedir\fR. To select another installation directory, define 77\fBpkgincludedir\fR. To select another installation directory, define
78the variable \fBGRECS_INCLUDE_DIR\fR to the name of that directory. 78the variable \fBARGOT_INCLUDE_DIR\fR to the name of that directory.
79.TP 79.TP
80.B std-pp-setup 80.B std-pp-setup
81Install the standard \fBpp-setup\fR file. 81Install the standard \fBpp-setup\fR file.
@@ -98,7 +98,7 @@ Add \fBgit2chg.awk\fR to the distributed tarball. The file is located
98in \fIdir\fR/build-aux. 98in \fIdir\fR/build-aux.
99.TP 99.TP
100.B syntax-doc 100.B syntax-doc
101Add \fBdoc/grecs-syntax.texi\fR file to the distributed tarball. Use this 101Add \fBdoc/argot-syntax.texi\fR file to the distributed tarball. Use this
102if your texinfo documentation includes that file. 102if your texinfo documentation includes that file.
103.PP 103.PP
104The 104The
@@ -117,17 +117,17 @@ parameter are supplied, no preprocessor setup file is installed.
117.SS "Default setup" 117.SS "Default setup"
118.RS 4 118.RS 4
119.nf 119.nf
120GRECS_SETUP 120ARGOT_SETUP
121.fi 121.fi
122.RE 122.RE
123.SS "Complex setup" 123.SS "Complex setup"
124The library sources are in \fBlib/grecs\fR. Configure the testsuite 124The library sources are in \fBlib/argot\fR. Configure the testsuite
125and add the \fBgetopt.m4\fR file to the distribution. Install 125and add the \fBgetopt.m4\fR file to the distribution. Install
126preprocessor setup file from \fBsrc/pp-setup\fR: 126preprocessor setup file from \fBsrc/pp-setup\fR:
127.sp 127.sp
128.RS 4 128.RS 4
129.nf 129.nf
130GRECS_SETUP(lib/grecs, [tests getopt], [$(top_srcdir)/src/pp-setup]) 130ARGOT_SETUP(lib/argot, [tests getopt], [$(top_srcdir)/src/pp-setup])
131.RE 131.RE
132.SH "SEE ALSO" 132.SH "SEE ALSO"
133.BR getopt.m4 (5), 133.BR getopt.m4 (5),
@@ -135,11 +135,11 @@ GRECS_SETUP(lib/grecs, [tests getopt], [$(top_srcdir)/src/pp-setup])
135.SH AUTHORS 135.SH AUTHORS
136Sergey Poznyakoff 136Sergey Poznyakoff
137.SH "BUG REPORTS" 137.SH "BUG REPORTS"
138Report bugs to <gray+grecs@gnu.org.ua>. 138Report bugs to <gray+argot@gnu.org.ua>.
139.SH COLOPHON 139.SH COLOPHON
140The \fBGrecs\fR library is constantly changing, so this manual page 140The \fBGrecs\fR library is constantly changing, so this manual page
141may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 141may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
142documentation, visit <http://www.gnu.org.ua/software/grecs>. 142documentation, visit <http://www.gnu.org.ua/software/argot>.
143.SH COPYRIGHT 143.SH COPYRIGHT
144Copyright \(co 2011 Sergey Poznyakoff 144Copyright \(co 2011 Sergey Poznyakoff
145.br 145.br
diff --git a/doc/Makefile.am b/doc/Makefile.am
index a646367..ac32a36 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,4 +1,4 @@
1# This file is part of grecs - Gray's Extensible Configuration System 1# This file is part of argot - Gray's Extensible Configuration System
2# Copyright (C) 2007-2016 Sergey Poznyakoff 2# Copyright (C) 2007-2016 Sergey Poznyakoff
3# 3#
4# Grecs is free software; you can redistribute it and/or modify 4# Grecs is free software; you can redistribute it and/or modify
@@ -15,19 +15,19 @@
15# along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15# along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16 16
17dist_man_MANS = \ 17dist_man_MANS = \
18 GRECS_SETUP.3\ 18 ARGOT_SETUP.3\
19 grecs_asprintf.3\ 19 argot_asprintf.3\
20 grecs_config.5\ 20 argot_config.5\
21 grecs_error.3\ 21 argot_error.3\
22 grecs_format_locus.3\ 22 argot_format_locus.3\
23 grecs_format_node_path.3\ 23 argot_format_node_path.3\
24 grecs_format_node.3\ 24 argot_format_node.3\
25 grecs_format_value.3\ 25 argot_format_value.3\
26 grecs_include_path_setup.3\ 26 argot_include_path_setup.3\
27 grecs_malloc.3\ 27 argot_malloc.3\
28 grecs_node_free.3\ 28 argot_node_free.3\
29 grecs_parse.3\ 29 argot_parse.3\
30 grecs_stmt_path.5\ 30 argot_stmt_path.5\
31 grecs_strdup.3\ 31 argot_strdup.3\
32 grecs_tree_free.3 32 argot_tree_free.3
33 33
diff --git a/doc/grecs-syntax.texi b/doc/argot-syntax.texi
index 2ddedea..db81133 100644
--- a/doc/grecs-syntax.texi
+++ b/doc/argot-syntax.texi
@@ -1,4 +1,4 @@
1@c This file is part of grecs - Gray's Extensible Configuration System 1@c This file is part of argot - Gray's Extensible Configuration System
2@c Copyright (C) 2007-2016 Sergey Poznyakoff 2@c Copyright (C) 2007-2016 Sergey Poznyakoff
3@c 3@c
4@c Grecs is free software; you can redistribute it and/or modify 4@c Grecs is free software; you can redistribute it and/or modify
@@ -20,7 +20,7 @@
20@c @lowersections: 20@c @lowersections:
21@c 21@c
22@c @raisesections 22@c @raisesections
23@c @include grecs-syntax.texi 23@c @include argot-syntax.texi
24@c @lowersections 24@c @lowersections
25@c 25@c
26@c 2. This texinfo source refers to the following values: 26@c 2. This texinfo source refers to the following values:
@@ -219,8 +219,8 @@ physical lines, e.g.:
219 If the character following a backslash is not one of those specified 219 If the character following a backslash is not one of those specified
220above, the backslash is ignored and a warning is issued. 220above, the backslash is ignored and a warning is issued.
221 221
222@c FIXME: If grecs_parser_options variable has 222@c FIXME: If argot_parser_options variable has
223@c FIXME: GRECS_OPTION_QUOTED_STRING_CONCAT bit set, then the 223@c FIXME: ARGOT_OPTION_QUOTED_STRING_CONCAT bit set, then the
224@c FIXME: following holds: 224@c FIXME: following holds:
225 225
226@ignore 226@ignore
diff --git a/doc/grecs_asprintf.3 b/doc/argot_asprintf.3
index 25279be..fa86190 100644
--- a/doc/grecs_asprintf.3
+++ b/doc/argot_asprintf.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,25 +14,25 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_ASPRINTF 3 "May 4, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_ASPRINTF 3 "May 4, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_asprintf, grecs_vasprintf \- print to allocated string 19argot_asprintf, argot_vasprintf \- print to allocated string
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.BI "int grecs_vasprintf(char " "**pbuf" ", size_t " "*psize" \ 24.BI "int argot_vasprintf(char " "**pbuf" ", size_t " "*psize" \
25 ", const char " "*format" ", " 25 ", const char " "*format" ", "
26.ti +17 26.ti +17
27.BI "va_list " "ap" ); 27.BI "va_list " "ap" );
28.br 28.br
29.BI "int grecs_asprintf(char " "**pbuf" ", size_t " "*psize" \ 29.BI "int argot_asprintf(char " "**pbuf" ", size_t " "*psize" \
30 ", const char *" "format" ", ...);" 30 ", const char *" "format" ", ...);"
31.SH DESCRIPTION 31.SH DESCRIPTION
32The functions 32The functions
33.BI grecs_asprintf () 33.BI argot_asprintf ()
34and 34and
35.BI grecs_vasprintf () 35.BI argot_vasprintf ()
36are analogs of 36are analogs of
37.BR sprintf (3) 37.BR sprintf (3)
38and 38and
@@ -52,23 +52,23 @@ In both cases, if the buffer has been reallocated, on return
52\fBpbuf\fR will contain its new address and \fBpsize\fR its new size. 52\fBpbuf\fR will contain its new address and \fBpsize\fR its new size.
53.PP 53.PP
54For initial allocation, 54For initial allocation,
55.BR grecs_malloc (3) 55.BR argot_malloc (3)
56is used. To reallocate memory, both functions use 56is used. To reallocate memory, both functions use
57.BR grecs_realloc (3). 57.BR argot_realloc (3).
58.SH RETURN VALUE 58.SH RETURN VALUE
59None. If memory allocation fails, a diagnostics is output and the 59None. If memory allocation fails, a diagnostics is output and the
60program is terminated. 60program is terminated.
61.SH "SEE ALSO" 61.SH "SEE ALSO"
62.BR grecs_malloc (3), 62.BR argot_malloc (3),
63.BR grecs_realloc (3). 63.BR argot_realloc (3).
64.SH AUTHORS 64.SH AUTHORS
65Sergey Poznyakoff 65Sergey Poznyakoff
66.SH "BUG REPORTS" 66.SH "BUG REPORTS"
67Report bugs to <gray+grecs@gnu.org.ua>. 67Report bugs to <gray+argot@gnu.org.ua>.
68.SH COLOPHON 68.SH COLOPHON
69The \fBGrecs\fR library is constantly changing, so this manual page 69The \fBGrecs\fR library is constantly changing, so this manual page
70may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 70may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
71documentation, visit <http://www.gnu.org.ua/software/grecs>. 71documentation, visit <http://www.gnu.org.ua/software/argot>.
72.SH COPYRIGHT 72.SH COPYRIGHT
73Copyright \(co 2011 Sergey Poznyakoff 73Copyright \(co 2011 Sergey Poznyakoff
74.br 74.br
diff --git a/doc/grecs_config.5 b/doc/argot_config.5
index 5fdaed4..abd6420 100644
--- a/doc/grecs_config.5
+++ b/doc/argot_config.5
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,7 +14,7 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_CONFIG 3 "December 25, 2014" "GRECS" "Grecs User Reference" 17.TH ARGOT_CONFIG 3 "December 25, 2014" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19\fBGrecs\fR configuration file syntax 19\fBGrecs\fR configuration file syntax
20.SH DESCRIPTION 20.SH DESCRIPTION
@@ -94,11 +94,11 @@ the program which uses the configuration file, and \fIVERSION\fR for
94its version number. 94its version number.
95.sp 95.sp
96The include search path can be modified using the 96The include search path can be modified using the
97.BI grecs_include_path_setup () 97.BI argot_include_path_setup ()
98and 98and
99.BI grecs_include_path_setup_v () 99.BI argot_include_path_setup_v ()
100functions. Refer to 100functions. Refer to
101.BR grecs_include_path_setup (3), 101.BR argot_include_path_setup (3),
102for a detailed discussion. 102for a detailed discussion.
103.TP 103.TP
104.BR "#include_once <" "file" > 104.BR "#include_once <" "file" >
@@ -323,17 +323,17 @@ advantage that it works with non-GNU m4 implementations as
323well. 323well.
324.SH "SEE ALSO" 324.SH "SEE ALSO"
325.BR m4 (1), 325.BR m4 (1),
326.BR grecs_parse (3), 326.BR argot_parse (3),
327.BR grecs_include_path_setup (3), 327.BR argot_include_path_setup (3),
328.BR grecs_tree_process (3). 328.BR argot_tree_process (3).
329.SH AUTHORS 329.SH AUTHORS
330Sergey Poznyakoff 330Sergey Poznyakoff
331.SH "BUG REPORTS" 331.SH "BUG REPORTS"
332Report bugs to <gray+grecs@gnu.org.ua>. 332Report bugs to <gray+argot@gnu.org.ua>.
333.SH COLOPHON 333.SH COLOPHON
334The \fBGrecs\fR library is constantly changing, so this manual page 334The \fBGrecs\fR library is constantly changing, so this manual page
335may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 335may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
336documentation, visit <http://www.gnu.org.ua/software/grecs>. 336documentation, visit <http://www.gnu.org.ua/software/argot>.
337.SH COPYRIGHT 337.SH COPYRIGHT
338Copyright \(co 2011 Sergey Poznyakoff 338Copyright \(co 2011 Sergey Poznyakoff
339.br 339.br
diff --git a/doc/grecs_error.3 b/doc/argot_error.3
index a020d36..ab623dc 100644
--- a/doc/grecs_error.3
+++ b/doc/argot_error.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,29 +14,29 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_ERROR 3 "July 1, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_ERROR 3 "July 1, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_error, grecs_warning \- grecs error reporting functions 19argot_error, argot_warning \- argot error reporting functions
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.BI "void grecs_error(grecs_locus_t " "*locus" ", int " "errnum" ", " 24.BI "void argot_error(argot_locus_t " "*locus" ", int " "errnum" ", "
25.ti +17 25.ti +17
26.BI "const char " "*format" ", ...);" 26.BI "const char " "*format" ", ...);"
27.br 27.br
28.BI "void grecs_warning(grecs_locus_t " "*locus" ", int " "errnum" ", " 28.BI "void argot_warning(argot_locus_t " "*locus" ", int " "errnum" ", "
29.ti +17 29.ti +17
30.BI "const char " "*format" ", ...);" 30.BI "const char " "*format" ", ...);"
31.sp 31.sp
32.BI "void (*grecs_print_diag_fun)(grecs_locus_t " "*locus" ", " 32.BI "void (*argot_print_diag_fun)(argot_locus_t " "*locus" ", "
33.ti +17 33.ti +17
34.BI "int " "err" ", int " "errnum" ", const char " "*msg" ); 34.BI "int " "err" ", int " "errnum" ", const char " "*msg" );
35.sp 35.sp
36.B extern int grecs_error_count; 36.B extern int argot_error_count;
37.SH DESCRIPTION 37.SH DESCRIPTION
38.BI grecs_error () 38.BI argot_error ()
39is a error reporting function for \fBgrecs\fR library. It flushes 39is a error reporting function for \fBargot\fR library. It flushes
40stdout, and outputs to stderr the file name and line number, as 40stdout, and outputs to stderr the file name and line number, as
41supplied by the 41supplied by the
42.BI locus 42.BI locus
@@ -52,22 +52,22 @@ If \fIlocus\fR is \fBNULL\fR, it is ignored and no file location is
52printed. 52printed.
53.PP 53.PP
54Each call to 54Each call to
55.BI grecs_error () 55.BI argot_error ()
56increments the value of the 56increments the value of the
57.BI grecs_error_count 57.BI argot_error_count
58global variable. 58global variable.
59The 59The
60.BI grecs_warning () 60.BI argot_warning ()
61function works the same as 61function works the same as
62.BI grecs_error (), 62.BI argot_error (),
63except that it outputs, before the formatted message and after the 63except that it outputs, before the formatted message and after the
64file location, the word \fBwarning\fR, followed by a semicolon 64file location, the word \fBwarning\fR, followed by a semicolon
65and a space character. It does not modify the 65and a space character. It does not modify the
66.BI grecs_error_count 66.BI argot_error_count
67variable. 67variable.
68.PP 68.PP
69Calling program can modify the behavior of both functions by setting 69Calling program can modify the behavior of both functions by setting
70.BI grecs_print_diag_fun 70.BI argot_print_diag_fun
71to the address of a custom error-reporting function. This function is 71to the address of a custom error-reporting function. This function is
72called with the following arguments: 72called with the following arguments:
73.TP 73.TP
@@ -86,21 +86,21 @@ System error code, or \fB0\fR, if no system error occurred.
86.I msg 86.I msg
87Formatted message. 87Formatted message.
88.PP 88.PP
89The \fBgrecs_locus_t\fR structure consists of two \fBpoints\fR, each 89The \fBargot_locus_t\fR structure consists of two \fBpoints\fR, each
90point describing the beginning and the end of the input fragment in 90point describing the beginning and the end of the input fragment in
91question: 91question:
92.sp 92.sp
93.nf 93.nf
94.in +5 94.in +5
95struct grecs_locus_point { 95struct argot_locus_point {
96 char *file; 96 char *file;
97 unsigned line; 97 unsigned line;
98 unsigned col; 98 unsigned col;
99}; 99};
100typedef struct { 100typedef struct {
101 struct grecs_locus_point beg; 101 struct argot_locus_point beg;
102 struct grecs_locus_point end; 102 struct argot_locus_point end;
103} grecs_locus_t; 103} argot_locus_t;
104.in 104.in
105.fi 105.fi
106.PP 106.PP
@@ -109,7 +109,7 @@ member contains the input line number and the \fBcol\fR member
109contains the column number. Both lines and columns are numbered from 109contains the column number. Both lines and columns are numbered from
1101. 1101.
111.PP 111.PP
112On output, the \fBgrecs_locus_t\fR structure is formatted as follows: 112On output, the \fBargot_locus_t\fR structure is formatted as follows:
113.sp 113.sp
114.nf 114.nf
115.in +5 115.in +5
@@ -160,11 +160,11 @@ None.
160.SH AUTHORS 160.SH AUTHORS
161Sergey Poznyakoff 161Sergey Poznyakoff
162.SH "BUG REPORTS" 162.SH "BUG REPORTS"
163Report bugs to <gray+grecs@gnu.org.ua>. 163Report bugs to <gray+argot@gnu.org.ua>.
164.SH COLOPHON 164.SH COLOPHON
165The \fBGrecs\fR library is constantly changing, so this manual page 165The \fBGrecs\fR library is constantly changing, so this manual page
166may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 166may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
167documentation, visit <http://www.gnu.org.ua/software/grecs>. 167documentation, visit <http://www.gnu.org.ua/software/argot>.
168.SH COPYRIGHT 168.SH COPYRIGHT
169Copyright \(co 2011 Sergey Poznyakoff 169Copyright \(co 2011 Sergey Poznyakoff
170.br 170.br
diff --git a/doc/grecs_format_locus.3 b/doc/argot_format_locus.3
index 5ab3542..52bfc3d 100644
--- a/doc/grecs_format_locus.3
+++ b/doc/argot_format_locus.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,27 +14,27 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_FORMAT_LOCUS 3 "May 19, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_FORMAT_LOCUS 3 "May 19, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_format_locus \- format and output source file location 19argot_format_locus \- format and output source file location
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.BI "void grecs_format_locus(grecs_locus_t " "*locus" "," 24.BI "void argot_format_locus(argot_locus_t " "*locus" ","
25.ti +17 25.ti +17
26.BI "struct grecs_format_closure " "*clos" ); 26.BI "struct argot_format_closure " "*clos" );
27.sp 27.sp
28.BI "void grecs_print_locus(grecs_locus_t " "*locus" ", FILE " "*fp" ); 28.BI "void argot_print_locus(argot_locus_t " "*locus" ", FILE " "*fp" );
29 29
30.SH DESCRIPTION 30.SH DESCRIPTION
31\fBgrecs_print_locus\fR formats the location from \fIlocus\fR in the 31\fBargot_print_locus\fR formats the location from \fIlocus\fR in the
32human-readable form and outputs it using the format closure 32human-readable form and outputs it using the format closure
33\fIclos\fR. The closure is defined as: 33\fIclos\fR. The closure is defined as:
34.sp 34.sp
35.nf 35.nf
36.in +5 36.in +5
37struct grecs_format_closure 37struct argot_format_closure
38{ 38{
39 int (*fmtfun)(const char *str, void *data); 39 int (*fmtfun)(const char *str, void *data);
40 void *data; 40 void *data;
@@ -47,7 +47,7 @@ be called one or more times. On each invocation, it is supplied with
47the string to be output as its first argument, and pointer to 47the string to be output as its first argument, and pointer to
48\fBdata\fR as the second one. 48\fBdata\fR as the second one.
49.PP 49.PP
50\fBgrecs_print_locus\fR is an alternative interface, which formats the 50\fBargot_print_locus\fR is an alternative interface, which formats the
51location from \fIlocus\fR in the human-readable form and outputs it to 51location from \fIlocus\fR in the human-readable form and outputs it to
52file \fBfp\fR. 52file \fBfp\fR.
53.PP 53.PP
@@ -60,21 +60,21 @@ doing anything.
60None. 60None.
61.SH NOTES 61.SH NOTES
62This are auxiliary functions used by 62This are auxiliary functions used by
63.BR grecs_format_node (3) 63.BR argot_format_node (3)
64and 64and
65.BR grecs_print_node (3), 65.BR argot_print_node (3),
66correspondingly. They are is seldom needed in user programs. 66correspondingly. They are is seldom needed in user programs.
67.SH "SEE ALSO" 67.SH "SEE ALSO"
68.BR grecs_format_node (3), 68.BR argot_format_node (3),
69.BR grecs_print_node (3). 69.BR argot_print_node (3).
70.SH AUTHORS 70.SH AUTHORS
71Sergey Poznyakoff 71Sergey Poznyakoff
72.SH "BUG REPORTS" 72.SH "BUG REPORTS"
73Report bugs to <gray+grecs@gnu.org.ua>. 73Report bugs to <gray+argot@gnu.org.ua>.
74.SH COLOPHON 74.SH COLOPHON
75The \fBGrecs\fR library is constantly changing, so this manual page 75The \fBGrecs\fR library is constantly changing, so this manual page
76may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 76may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
77documentation, visit <http://www.gnu.org.ua/software/grecs>. 77documentation, visit <http://www.gnu.org.ua/software/argot>.
78.SH COPYRIGHT 78.SH COPYRIGHT
79Copyright \(co 2011 Sergey Poznyakoff 79Copyright \(co 2011 Sergey Poznyakoff
80.br 80.br
diff --git a/doc/grecs_format_node.3 b/doc/argot_format_node.3
index bf2b8db..3e0a9fb 100644
--- a/doc/grecs_format_node.3
+++ b/doc/argot_format_node.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,26 +14,26 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_FORMAT_NODE 3 "May 19, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_FORMAT_NODE 3 "May 19, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_format_node \- format and print a single node from a syntax tree 19argot_format_node \- format and print a single node from a syntax tree
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.BI "void grecs_format_node(struct grecs_node *" "node" ", int " \ 24.BI "void argot_format_node(struct argot_node *" "node" ", int " \
25 "flags" "," 25 "flags" ","
26.ti +17 26.ti +17
27.BI "struct grecs_format_closure " "*clos" ); 27.BI "struct argot_format_closure " "*clos" );
28.sp 28.sp
29.BI "void grecs_print_node(struct grecs_node *" "node" ", int " \ 29.BI "void argot_print_node(struct argot_node *" "node" ", int " \
30 "flags" ", FILE " "*fp" ); 30 "flags" ", FILE " "*fp" );
31.SH DESCRIPTION 31.SH DESCRIPTION
32\fBgrecs_format_node\fR formats the contents of a parse tree node 32\fBargot_format_node\fR formats the contents of a parse tree node
33\fInode\fR, according to formatting options, given by \fIflags\fR. The 33\fInode\fR, according to formatting options, given by \fIflags\fR. The
34formatter closure \fIclos\fR is used for actual output. 34formatter closure \fIclos\fR is used for actual output.
35.PP 35.PP
36\fBgrecs_print_node\fR is an alternative entry point, which formats 36\fBargot_print_node\fR is an alternative entry point, which formats
37the node to the given file. 37the node to the given file.
38.PP 38.PP
39The \fBflags\fR argument is a bitwise \fBOR\fR of one or more of the 39The \fBflags\fR argument is a bitwise \fBOR\fR of one or more of the
@@ -43,49 +43,49 @@ following options:
43This character will be used as pathname component separator, instead 43This character will be used as pathname component separator, instead
44of the default dot. 44of the default dot.
45.TP 45.TP
46.B GRECS_NODE_FLAG_LOCUS 46.B ARGOT_NODE_FLAG_LOCUS
47Print the source location. The location is printed as the file name, 47Print the source location. The location is printed as the file name,
48followed by a semicolon, followed by the line number and another 48followed by a semicolon, followed by the line number and another
49semicolon. Locations are separated from the rest of output by a single 49semicolon. Locations are separated from the rest of output by a single
50space character. 50space character.
51.TP 51.TP
52.B GRECS_NODE_FLAG_PATH 52.B ARGOT_NODE_FLAG_PATH
53Print the \fInode path\fR. See 53Print the \fInode path\fR. See
54.BR grecs_stmt_path (5), 54.BR argot_stmt_path (5),
55for a description. If printed, the path is separated from the 55for a description. If printed, the path is separated from the
56remaining output on its right by a semicolon and a space. 56remaining output on its right by a semicolon and a space.
57.TP 57.TP
58.B GRECS_NODE_FLAG_VALUE 58.B ARGOT_NODE_FLAG_VALUE
59Print the node value. 59Print the node value.
60.TP 60.TP
61.B GRECS_NODE_FLAG_QUOTE 61.B ARGOT_NODE_FLAG_QUOTE
62Always quote the value. By default, the value will be quoted only 62Always quote the value. By default, the value will be quoted only
63when necessary, i.e. if it contains white space, quotes or special 63when necessary, i.e. if it contains white space, quotes or special
64characters. This option is useful only together with 64characters. This option is useful only together with
65\fBGRECS_NODE_FLAG_VALUE\fR. 65\fBARGOT_NODE_FLAG_VALUE\fR.
66.TP 66.TP
67.B GRECS_NODE_FLAG_NOQUOTE 67.B ARGOT_NODE_FLAG_NOQUOTE
68Never quote values. If both \fBGRECS_NODE_FLAG_QUOTE\fR and 68Never quote values. If both \fBARGOT_NODE_FLAG_QUOTE\fR and
69\fBGRECS_NODE_FLAG_NOQUOTE\fR are given, the former takes precedence 69\fBARGOT_NODE_FLAG_NOQUOTE\fR are given, the former takes precedence
70over the latter. 70over the latter.
71.TP 71.TP
72.B GRECS_NODE_FLAG_QUOTE_HEX 72.B ARGOT_NODE_FLAG_QUOTE_HEX
73Print non-printable characters as C hex escapets. This option is 73Print non-printable characters as C hex escapets. This option is
74ignored if \fBGRECS_NODE_FLAG_NOQUOTE\fR is set. 74ignored if \fBARGOT_NODE_FLAG_NOQUOTE\fR is set.
75.TP 75.TP
76.B GRECS_NODE_FLAG_DEFAULT 76.B ARGOT_NODE_FLAG_DEFAULT
77Same as 77Same as
78.sp 78.sp
79.nf 79.nf
80GRECS_NODE_FLAG_PATH|GRECS_NODE_FLAG_VALUE|GRECS_NODE_FLAG_QUOTE 80ARGOT_NODE_FLAG_PATH|ARGOT_NODE_FLAG_VALUE|ARGOT_NODE_FLAG_QUOTE
81.PP 81.PP
82If \fBflag\fR is 0, \fBGRECS_NODE_FLAG_DEFAULT\fR is assumed. 82If \fBflag\fR is 0, \fBARGOT_NODE_FLAG_DEFAULT\fR is assumed.
83.SH CLOSURE 83.SH CLOSURE
84The format closure is defined as: 84The format closure is defined as:
85.sp 85.sp
86.nf 86.nf
87.in +5 87.in +5
88struct grecs_format_closure 88struct argot_format_closure
89{ 89{
90 int (*fmtfun)(const char *str, void *data); 90 int (*fmtfun)(const char *str, void *data);
91 void *data; 91 void *data;
@@ -100,16 +100,16 @@ the string to be output as its first argument, and pointer to
100.SH "RETURN VALUE" 100.SH "RETURN VALUE"
101None. 101None.
102.SH "SEE ALSO" 102.SH "SEE ALSO"
103.BR grecs_config (5), 103.BR argot_config (5),
104.BR grecs_stmt_path (5). 104.BR argot_stmt_path (5).
105.SH AUTHORS 105.SH AUTHORS
106Sergey Poznyakoff 106Sergey Poznyakoff
107.SH "BUG REPORTS" 107.SH "BUG REPORTS"
108Report bugs to <gray+grecs@gnu.org.ua>. 108Report bugs to <gray+argot@gnu.org.ua>.
109.SH COLOPHON 109.SH COLOPHON
110The \fBGrecs\fR library is constantly changing, so this manual page 110The \fBGrecs\fR library is constantly changing, so this manual page
111may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 111may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
112documentation, visit <http://www.gnu.org.ua/software/grecs>. 112documentation, visit <http://www.gnu.org.ua/software/argot>.
113.SH COPYRIGHT 113.SH COPYRIGHT
114Copyright \(co 2011 Sergey Poznyakoff 114Copyright \(co 2011 Sergey Poznyakoff
115.br 115.br
diff --git a/doc/grecs_format_node_path.3 b/doc/argot_format_node_path.3
index 0d4fa85..e85e2bb 100644
--- a/doc/grecs_format_node_path.3
+++ b/doc/argot_format_node_path.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,55 +14,55 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_FORMAT_NODE_PATH 3 "May 19, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_FORMAT_NODE_PATH 3 "May 19, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_format_node_path \- format and output statement pathname for the 19argot_format_node_path \- format and output statement pathname for the
20node 20node
21.SH SYNOPSIS 21.SH SYNOPSIS
22.nf 22.nf
23.B #include <grecs.h> 23.B #include <argot.h>
24.sp 24.sp
25.BI "void grecs_format_node_path(struct grecs_node " "*node" ", int " \ 25.BI "void argot_format_node_path(struct argot_node " "*node" ", int " \
26 "flag" ", " 26 "flag" ", "
27.ti +17 27.ti +17
28.BI "struct grecs_format_closure " "*clos" ); 28.BI "struct argot_format_closure " "*clos" );
29.sp 29.sp
30.BI "void grecs_print_node_path(struct grecs_node " "*node" ", int " \ 30.BI "void argot_print_node_path(struct argot_node " "*node" ", int " \
31 "flag" ", FILE " "*fp" ); 31 "flag" ", FILE " "*fp" );
32.SH DESCRIPTION 32.SH DESCRIPTION
33\fBgrecs_format_node_path\fR computes the \fIstatement pathname\fR for 33\fBargot_format_node_path\fR computes the \fIstatement pathname\fR for
34the \fInode\fR, and outputs it using the closure \fIclos\fR. See 34the \fInode\fR, and outputs it using the closure \fIclos\fR. See
35section \fBCLOSURE\fR in 35section \fBCLOSURE\fR in
36.BR grecs_format_node (3), 36.BR argot_format_node (3),
37for a description of struct grecs_format_closure. 37for a description of struct argot_format_closure.
38.PP 38.PP
39\fBgrecs_print_node_path\fR is an alternative interface that outputs 39\fBargot_print_node_path\fR is an alternative interface that outputs
40the formatted data to the file. 40the formatted data to the file.
41.PP 41.PP
42The \fIflags\fR argument describes what character to use as a pathname 42The \fIflags\fR argument describes what character to use as a pathname
43component separator and how to format the statement tag, if \fInode\fR 43component separator and how to format the statement tag, if \fInode\fR
44refers to a block statement. See 44refers to a block statement. See
45.BR grecs_format_node (3), 45.BR argot_format_node (3),
46for a discussion of available flags. 46for a discussion of available flags.
47.SH "RETURN VALUE" 47.SH "RETURN VALUE"
48None. 48None.
49.SH NOTES 49.SH NOTES
50This are auxiliary functions used by 50This are auxiliary functions used by
51.BR grecs_format_node (3) 51.BR argot_format_node (3)
52and 52and
53.BR grecs_print_node (3), 53.BR argot_print_node (3),
54correspondingly. They are is seldom needed in user programs. 54correspondingly. They are is seldom needed in user programs.
55.SH "SEE ALSO" 55.SH "SEE ALSO"
56.BR grecs_format_node (3), 56.BR argot_format_node (3),
57.BR grecs_stmt_path (5). 57.BR argot_stmt_path (5).
58.SH AUTHORS 58.SH AUTHORS
59Sergey Poznyakoff 59Sergey Poznyakoff
60.SH "BUG REPORTS" 60.SH "BUG REPORTS"
61Report bugs to <gray+grecs@gnu.org.ua>. 61Report bugs to <gray+argot@gnu.org.ua>.
62.SH COLOPHON 62.SH COLOPHON
63The \fBGrecs\fR library is constantly changing, so this manual page 63The \fBGrecs\fR library is constantly changing, so this manual page
64may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 64may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
65documentation, visit <http://www.gnu.org.ua/software/grecs>. 65documentation, visit <http://www.gnu.org.ua/software/argot>.
66.SH COPYRIGHT 66.SH COPYRIGHT
67Copyright \(co 2011 Sergey Poznyakoff 67Copyright \(co 2011 Sergey Poznyakoff
68.br 68.br
diff --git a/doc/grecs_format_value.3 b/doc/argot_format_value.3
index bfd90a2..73a667c 100644
--- a/doc/grecs_format_value.3
+++ b/doc/argot_format_value.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,47 +14,47 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_FORMAT_VALUE 3 "May 19, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_FORMAT_VALUE 3 "May 19, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_format_value \- format and output a configuration value 19argot_format_value \- format and output a configuration value
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.BI "void grecs_format_value(struct grecs_value *" "val" ", int " \ 24.BI "void argot_format_value(struct argot_value *" "val" ", int " \
25 "flags" ", " 25 "flags" ", "
26.ti +17 26.ti +17
27.BI "struct grecs_format_closure " "*clos" ); 27.BI "struct argot_format_closure " "*clos" );
28.sp 28.sp
29.BI "void grecs_print_value(struct grecs_value *" "val" ", int " \ 29.BI "void argot_print_value(struct argot_value *" "val" ", int " \
30 "flags" ", FILE " "*fp" ); 30 "flags" ", FILE " "*fp" );
31.SH DESCRIPTION 31.SH DESCRIPTION
32\fBgrecs_format_value\fR formats the value \fIval\fR and outputs it 32\fBargot_format_value\fR formats the value \fIval\fR and outputs it
33using the formatting closure \fIclos\fR. The \fIflags\fR argument 33using the formatting closure \fIclos\fR. The \fIflags\fR argument
34describes how to format the value. See 34describes how to format the value. See
35.BR grecs_format_node (3), 35.BR argot_format_node (3),
36for a discussion of available flags. 36for a discussion of available flags.
37.PP 37.PP
38\fBgrecs_print_value\fR is an alternative interface that outputs the 38\fBargot_print_value\fR is an alternative interface that outputs the
39formatted data to a file. 39formatted data to a file.
40.SH "RETURN VALUE" 40.SH "RETURN VALUE"
41None. 41None.
42.SH NOTES 42.SH NOTES
43This are auxiliary functions used by 43This are auxiliary functions used by
44.BR grecs_format_node (3) 44.BR argot_format_node (3)
45and 45and
46.BR grecs_print_node (3), 46.BR argot_print_node (3),
47correspondingly. They are is seldom needed in user programs. 47correspondingly. They are is seldom needed in user programs.
48.SH "SEE ALSO" 48.SH "SEE ALSO"
49.BR grecs_format_node (3). 49.BR argot_format_node (3).
50.SH AUTHORS 50.SH AUTHORS
51Sergey Poznyakoff 51Sergey Poznyakoff
52.SH "BUG REPORTS" 52.SH "BUG REPORTS"
53Report bugs to <gray+grecs@gnu.org.ua>. 53Report bugs to <gray+argot@gnu.org.ua>.
54.SH COLOPHON 54.SH COLOPHON
55The \fBGrecs\fR library is constantly changing, so this manual page 55The \fBGrecs\fR library is constantly changing, so this manual page
56may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 56may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
57documentation, visit <http://www.gnu.org.ua/software/grecs>. 57documentation, visit <http://www.gnu.org.ua/software/argot>.
58.SH COPYRIGHT 58.SH COPYRIGHT
59Copyright \(co 2011 Sergey Poznyakoff 59Copyright \(co 2011 Sergey Poznyakoff
60.br 60.br
diff --git a/doc/grecs_include_path_setup.3 b/doc/argot_include_path_setup.3
index 6e61ec9..49ce06f 100644
--- a/doc/grecs_include_path_setup.3
+++ b/doc/argot_include_path_setup.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,39 +14,39 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_INCLUDE_PATH_SETUP 3 "May 4, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_INCLUDE_PATH_SETUP 3 "May 4, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_include_path_setup, grecs_include_path_setup_v \- add 19argot_include_path_setup, argot_include_path_setup_v \- add
20directories to the \fBgrecs\fR preprocessor include path 20directories to the \fBargot\fR preprocessor include path
21.SH SYNOPSIS 21.SH SYNOPSIS
22.nf 22.nf
23.B #include <grecs.h> 23.B #include <argot.h>
24.sp 24.sp
25.BI "void grecs_include_path_setup(const char *" "dir" ", ...);" 25.BI "void argot_include_path_setup(const char *" "dir" ", ...);"
26.br 26.br
27.BI "void grecs_include_path_setup_v(char **" "dirs" ); 27.BI "void argot_include_path_setup_v(char **" "dirs" );
28.SH DESCRIPTION 28.SH DESCRIPTION
29These functions add directories to the end of the include search path 29These functions add directories to the end of the include search path
30used by the \fBgrecs\fR preprocessor. 30used by the \fBargot\fR preprocessor.
31.PP 31.PP
32\fBgrecs_include_path_setup\fR takes arbitrary number of 32\fBargot_include_path_setup\fR takes arbitrary number of
33arguments. Each argument must be pointer to a directory name. The 33arguments. Each argument must be pointer to a directory name. The
34argument list must terminate with a \fBNULL\fR argument. 34argument list must terminate with a \fBNULL\fR argument.
35.PP 35.PP
36\fBgrecs_include_path_setup_v\fR takes directory names from a 36\fBargot_include_path_setup_v\fR takes directory names from a
37\fBNULL\fR-terminated array of character pointers. 37\fBNULL\fR-terminated array of character pointers.
38.SH "RETURN VALUE" 38.SH "RETURN VALUE"
39None. 39None.
40.SH "SEE ALSO" 40.SH "SEE ALSO"
41.BR grecs_config (5). 41.BR argot_config (5).
42.SH AUTHORS 42.SH AUTHORS
43Sergey Poznyakoff 43Sergey Poznyakoff
44.SH "BUG REPORTS" 44.SH "BUG REPORTS"
45Report bugs to <gray+grecs@gnu.org.ua>. 45Report bugs to <gray+argot@gnu.org.ua>.
46.SH COLOPHON 46.SH COLOPHON
47The \fBGrecs\fR library is constantly changing, so this manual page 47The \fBGrecs\fR library is constantly changing, so this manual page
48may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 48may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
49documentation, visit <http://www.gnu.org.ua/software/grecs>. 49documentation, visit <http://www.gnu.org.ua/software/argot>.
50.SH COPYRIGHT 50.SH COPYRIGHT
51Copyright \(co 2011 Sergey Poznyakoff 51Copyright \(co 2011 Sergey Poznyakoff
52.br 52.br
diff --git a/doc/grecs_malloc.3 b/doc/argot_malloc.3
index 97d4273..0059bbb 100644
--- a/doc/grecs_malloc.3
+++ b/doc/argot_malloc.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,41 +14,41 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_MALLOC 3 "May 7, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_MALLOC 3 "May 7, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_malloc, grecs_zalloc, grecs_calloc, grecs_realloc \- Allocate 19argot_malloc, argot_zalloc, argot_calloc, argot_realloc \- Allocate
20dynamic memory for \fBGrecs\fR. 20dynamic memory for \fBGrecs\fR.
21.SH SYNOPSIS 21.SH SYNOPSIS
22.nf 22.nf
23.B #include <grecs.h> 23.B #include <argot.h>
24.sp 24.sp
25.BI "void *grecs_malloc(size_t " "size" ); 25.BI "void *argot_malloc(size_t " "size" );
26.br 26.br
27.BI "void *grecs_zalloc(size_t " "size" ); 27.BI "void *argot_zalloc(size_t " "size" );
28.br 28.br
29.BI "void *grecs_calloc(size_t " "nmemb" ", size_t " "size" ); 29.BI "void *argot_calloc(size_t " "nmemb" ", size_t " "size" );
30.br 30.br
31.BI "void *grecs_realloc(void " "*ptr" ", size_t " "size" ); 31.BI "void *argot_realloc(void " "*ptr" ", size_t " "size" );
32.br 32.br
33.BI "void grecs_free(void " "*ptr" ); 33.BI "void argot_free(void " "*ptr" );
34.br 34.br
35.BI "void grecs_alloc_die(void);" 35.BI "void argot_alloc_die(void);"
36.sp 36.sp
37.BI "void *(*grecs_malloc_fun)(size_t " "size" ); 37.BI "void *(*argot_malloc_fun)(size_t " "size" );
38.br 38.br
39.BI "void *(*grecs_realloc_fun)(void " "*ptr" ", size_t " "size" ); 39.BI "void *(*argot_realloc_fun)(void " "*ptr" ", size_t " "size" );
40.br 40.br
41.BI "void (*grecs_free_fun)(void " "*ptr" ); 41.BI "void (*argot_free_fun)(void " "*ptr" );
42.br 42.br
43.BI "void (*grecs_alloc_die_fun)(void);" 43.BI "void (*argot_alloc_die_fun)(void);"
44.SH DESCRIPTION 44.SH DESCRIPTION
45.PP 45.PP
46The \fBgrecs_malloc\fR, \fBgrecs_calloc\fR and \fBgrecs_realloc\fR 46The \fBargot_malloc\fR, \fBargot_calloc\fR and \fBargot_realloc\fR
47functions work exactly as they \fIlibc\fR counterparts do, except that 47functions work exactly as they \fIlibc\fR counterparts do, except that
48if unable to allocate memory they terminate the program, by calling 48if unable to allocate memory they terminate the program, by calling
49\fBgrecs_alloc_die\fR function. 49\fBargot_alloc_die\fR function.
50.PP 50.PP
51.BR grecs_calloc () 51.BR argot_calloc ()
52allocates memory for an array of 52allocates memory for an array of
53.I nmemb 53.I nmemb
54elements of 54elements of
@@ -56,13 +56,13 @@ elements of
56bytes each and returns a pointer to the allocated memory. 56bytes each and returns a pointer to the allocated memory.
57The memory is set to zero. 57The memory is set to zero.
58.PP 58.PP
59.BR grecs_malloc () 59.BR argot_malloc ()
60allocates 60allocates
61.I size 61.I size
62bytes and returns a pointer to the allocated memory. 62bytes and returns a pointer to the allocated memory.
63The memory is not cleared. 63The memory is not cleared.
64.PP 64.PP
65.BR grecs_realloc () 65.BR argot_realloc ()
66changes the size of the memory block pointed to by 66changes the size of the memory block pointed to by
67.I ptr 67.I ptr
68to 68to
@@ -72,56 +72,56 @@ The contents will be unchanged to the minimum of the old and new
72sizes; 72sizes;
73newly allocated memory will be uninitialized. 73newly allocated memory will be uninitialized.
74.PP 74.PP
75.BR grecs_zalloc () 75.BR argot_zalloc ()
76allocates 76allocates
77.I size 77.I size
78bytes and returns a pointer to the allocated memory. The memory is 78bytes and returns a pointer to the allocated memory. The memory is
79set to zero. 79set to zero.
80.PP 80.PP
81.BR grecs_free () 81.BR argot_free ()
82frees the memory space pointed to by \fBptr\fR, which must have been 82frees the memory space pointed to by \fBptr\fR, which must have been
83returned by a previous call to one of the memory allocation functions 83returned by a previous call to one of the memory allocation functions
84discussed above. 84discussed above.
85.PP 85.PP
86The \fBgrecs_malloc_fun\fR hook is used \fBgrecs_malloc\fR, 86The \fBargot_malloc_fun\fR hook is used \fBargot_malloc\fR,
87\fBgrecs_calloc\fR and \fBgrecs_zalloc\fR to allocate new memory 87\fBargot_calloc\fR and \fBargot_zalloc\fR to allocate new memory
88chunk. By default it points to 88chunk. By default it points to
89.BR malloc (3). 89.BR malloc (3).
90.PP 90.PP
91Similarly, the \fBgrecs_realloc_fun\fR, is used by 91Similarly, the \fBargot_realloc_fun\fR, is used by
92\fBgrecs_realloc\fR function. By default it points to 92\fBargot_realloc\fR function. By default it points to
93.BR realloc (3). 93.BR realloc (3).
94.PP 94.PP
95The \fBgrecs_free_fun\fR is used by 95The \fBargot_free_fun\fR is used by
96.BR grecs_free (). 96.BR argot_free ().
97By default it points to 97By default it points to
98.BR free (3). 98.BR free (3).
99.PP 99.PP
100These hooks provide a way for the calling program to use its custom 100These hooks provide a way for the calling program to use its custom
101memory allocation routines. 101memory allocation routines.
102.PP 102.PP
103.BR grecs_alloc_die () 103.BR argot_alloc_die ()
104This function is called when memory allocation fails. It prints 104This function is called when memory allocation fails. It prints
105appropriate diagnostics using \fBgrecs_error(3)\fR and aborts the 105appropriate diagnostics using \fBargot_error(3)\fR and aborts the
106program. If \fBgrecs_alloc_die_fun\fR, it is called prior to 106program. If \fBargot_alloc_die_fun\fR, it is called prior to
107outputting the diagnostics. 107outputting the diagnostics.
108 108
109.SH "RETURN VALUE" 109.SH "RETURN VALUE"
110For \fBgrecs_malloc\fR, \fBgrecs_calloc\fR, \fBgrecs_zalloc\fR and 110For \fBargot_malloc\fR, \fBargot_calloc\fR, \fBargot_zalloc\fR and
111\fBgrecs_realloc\fR return a pointer to the allocated memory, which is 111\fBargot_realloc\fR return a pointer to the allocated memory, which is
112suitably aligned for any kind of variable. 112suitably aligned for any kind of variable.
113.PP 113.PP
114On error, \fBgrecs_alloc_die\fR is called and the program is terminated. 114On error, \fBargot_alloc_die\fR is called and the program is terminated.
115.SH "SEE ALSO" 115.SH "SEE ALSO"
116.BR grecs_strdup (3) 116.BR argot_strdup (3)
117.SH AUTHORS 117.SH AUTHORS
118Sergey Poznyakoff. 118Sergey Poznyakoff.
119.SH "BUG REPORTS" 119.SH "BUG REPORTS"
120Report bugs to <gray+grecs@gnu.org.ua>. 120Report bugs to <gray+argot@gnu.org.ua>.
121.SH COLOPHON 121.SH COLOPHON
122The \fBGrecs\fR library is constantly changing, so this manual page 122The \fBGrecs\fR library is constantly changing, so this manual page
123may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 123may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
124documentation, visit <http://www.gnu.org.ua/software/grecs>. 124documentation, visit <http://www.gnu.org.ua/software/argot>.
125.SH COPYRIGHT 125.SH COPYRIGHT
126Copyright \(co 2011 Sergey Poznyakoff 126Copyright \(co 2011 Sergey Poznyakoff
127.br 127.br
diff --git a/doc/grecs_node_free.3 b/doc/argot_node_free.3
index 8637811..6fd6f61 100644
--- a/doc/grecs_node_free.3
+++ b/doc/argot_node_free.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,34 +14,34 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_NODE_FREE 3 "May 4, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_NODE_FREE 3 "May 4, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_node_free \- reclaim the memory used by a node 19argot_node_free \- reclaim the memory used by a node
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.BI "void grecs_node_free(struct grecs_node " "*node" ); 24.BI "void argot_node_free(struct argot_node " "*node" );
25.SH DESCRIPTION 25.SH DESCRIPTION
26\fBgrecs_node_free\fR reclaims the memory used by the parse tree node 26\fBargot_node_free\fR reclaims the memory used by the parse tree node
27\fInode\fR. 27\fInode\fR.
28.PP 28.PP
29The function does not unlink the node from the lists it is part of, 29The function does not unlink the node from the lists it is part of,
30see 30see
31.BR grecs_tree_free (3), 31.BR argot_tree_free (3),
32if this is what you need. 32if this is what you need.
33.SH "RETURN VALUE" 33.SH "RETURN VALUE"
34None. 34None.
35.SH "SEE ALSO" 35.SH "SEE ALSO"
36.BR grecs_tree_free (3). 36.BR argot_tree_free (3).
37.SH AUTHORS 37.SH AUTHORS
38Sergey Poznyakoff 38Sergey Poznyakoff
39.SH "BUG REPORTS" 39.SH "BUG REPORTS"
40Report bugs to <gray+grecs@gnu.org.ua>. 40Report bugs to <gray+argot@gnu.org.ua>.
41.SH COLOPHON 41.SH COLOPHON
42The \fBGrecs\fR library is constantly changing, so this manual page 42The \fBGrecs\fR library is constantly changing, so this manual page
43may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 43may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
44documentation, visit <http://www.gnu.org.ua/software/grecs>. 44documentation, visit <http://www.gnu.org.ua/software/argot>.
45.SH COPYRIGHT 45.SH COPYRIGHT
46Copyright \(co 2011 Sergey Poznyakoff 46Copyright \(co 2011 Sergey Poznyakoff
47.br 47.br
diff --git a/doc/grecs_parse.3 b/doc/argot_parse.3
index 27e451b..4db155c 100644
--- a/doc/grecs_parse.3
+++ b/doc/argot_parse.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,23 +14,23 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_PARSE 3 "July 1, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_PARSE 3 "July 1, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_parse \- parse a configuration file. 19argot_parse \- parse a configuration file.
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.BI "struct grecs_node *grecs_parse(const char *" "name" ); 24.BI "struct argot_node *argot_parse(const char *" "name" );
25.SH DESCRIPTION 25.SH DESCRIPTION
26The 26The
27.BR grecs_parse () 27.BR argot_parse ()
28function reads the file \fBname\fR, which must be formatted 28function reads the file \fBname\fR, which must be formatted
29according to 29according to
30.BR grecs_config (5) 30.BR argot_config (5)
31and returns the parsed-out syntax tree. On errors, \fBNULL\fR is 31and returns the parsed-out syntax tree. On errors, \fBNULL\fR is
32returned and appropriate diagnostic messages are printed using 32returned and appropriate diagnostic messages are printed using
33.BR grecs_error (3). 33.BR argot_error (3).
34.PP 34.PP
35The syntax tree consists of \fInodes\fR, linked together so as to 35The syntax tree consists of \fInodes\fR, linked together so as to
36represent the file structure. A node is described by the following 36represent the file structure. A node is described by the following
@@ -38,32 +38,32 @@ object:
38.sp 38.sp
39.nf 39.nf
40.in +5 40.in +5
41typedef struct grecs_node { 41typedef struct argot_node {
42 enum grecs_node_type type; 42 enum argot_node_type type;
43 grecs_locus_t locus; 43 argot_locus_t locus;
44 struct grecs_node *up; 44 struct argot_node *up;
45 struct grecs_node *down; 45 struct argot_node *down;
46 struct grecs_node *next; 46 struct argot_node *next;
47 struct grecs_node *prev; 47 struct argot_node *prev;
48 char *ident; 48 char *ident;
49 grecs_locus_t idloc; 49 argot_locus_t idloc;
50 union { 50 union {
51 struct grecs_value *value; 51 struct argot_value *value;
52 struct grecs_symtab *texttab; 52 struct argot_symtab *texttab;
53 } v; 53 } v;
54} grecs_node_t; 54} argot_node_t;
55.in 55.in
56.fi 56.fi
57.PP 57.PP
58The \fItype\fR member describes the type of this node. Its value is 58The \fItype\fR member describes the type of this node. Its value is
59\fBgrecs_node_stmt\fR for simple statements and 59\fBargot_node_stmt\fR for simple statements and
60\fBgrecs_node_block\fR, for block statements. The topmost node (the 60\fBargot_node_block\fR, for block statements. The topmost node (the
61one returned by \fBgrecs_tree_parse\fR) has type \fBgrecs_node_root\fR. 61one returned by \fBargot_tree_parse\fR) has type \fBargot_node_root\fR.
62.PP 62.PP
63The \fIlocus\fR describes the location in the input file, which this 63The \fIlocus\fR describes the location in the input file, which this
64node described. See 64node described. See
65.BR grecs_error (3), 65.BR argot_error (3),
66for a description of \fBgrecs_locus_t\fR. 66for a description of \fBargot_locus_t\fR.
67.PP 67.PP
68Adjacent nodes form a doubly-linked list using the \fBnext\fR and 68Adjacent nodes form a doubly-linked list using the \fBnext\fR and
69\fBprev\fR pointers. Thus, the node pointed to by \fBnext\fR 69\fBprev\fR pointers. Thus, the node pointed to by \fBnext\fR
@@ -71,7 +71,7 @@ describes the statement that appears immediately after the one
71described by the current node, whereas \fBprev\fR points to the node 71described by the current node, whereas \fBprev\fR points to the node
72describing a preceding statement. 72describing a preceding statement.
73.PP 73.PP
74If \fItype\fR is \fBgrecs_node_block\fR, the \fBdown\fR member points 74If \fItype\fR is \fBargot_node_block\fR, the \fBdown\fR member points
75to the first \fBsub-statement\fR in this block. \fBdown->next\fR 75to the first \fBsub-statement\fR in this block. \fBdown->next\fR
76will point to the second statement (if any), and so on. 76will point to the second statement (if any), and so on.
77.PP 77.PP
@@ -105,7 +105,7 @@ input file. Notice, that it differs from \fBlocus\fR described above.
105.PP 105.PP
106The \fBv\fR union keeps data which depend on the type of this node. 106The \fBv\fR union keeps data which depend on the type of this node.
107The \fBv.texttab\fR member is defined only for the root node (type 107The \fBv.texttab\fR member is defined only for the root node (type
108\fBgrecs_node_root\fR). It points to a symbol table which holds shared 108\fBargot_node_root\fR). It points to a symbol table which holds shared
109strings for this tree. In particular, this table holds file names 109strings for this tree. In particular, this table holds file names
110referenced by \fBlocus\fR members of all underlying nodes. 110referenced by \fBlocus\fR members of all underlying nodes.
111.PP 111.PP
@@ -114,33 +114,33 @@ the value associated with this statement. A value is defined as:
114.sp 114.sp
115.nf 115.nf
116.in +5 116.in +5
117typedef struct grecs_value { 117typedef struct argot_value {
118 int type; 118 int type;
119 grecs_locus_t locus; 119 argot_locus_t locus;
120 union { 120 union {
121 struct grecs_list *list; 121 struct argot_list *list;
122 char *string; 122 char *string;
123 struct { 123 struct {
124 size_t c; 124 size_t c;
125 struct grecs_value **v; 125 struct argot_value **v;
126 } arg; 126 } arg;
127 } v; 127 } v;
128} grecs_value_t; 128} argot_value_t;
129.in 129.in
130.fi 130.fi
131.PP 131.PP
132The \fBtype\fR will be \fBGRECS_TYPE_STRING\fR, for string values, 132The \fBtype\fR will be \fBARGOT_TYPE_STRING\fR, for string values,
133\fBGRECS_TYPE_LIST\fR, for list values, and \fBGRECS_TYPE_ARRAY\fR, 133\fBARGOT_TYPE_LIST\fR, for list values, and \fBARGOT_TYPE_ARRAY\fR,
134for arrays of values. Depending on its value, the following members 134for arrays of values. Depending on its value, the following members
135of the union are used: 135of the union are used:
136.TP 136.TP
137.B GRECS_TYPE_STRING 137.B ARGOT_TYPE_STRING
138Actual string value is pointed to by \fBv.string\fR. 138Actual string value is pointed to by \fBv.string\fR.
139.TP 139.TP
140.B GRECS_TYPE_LIST 140.B ARGOT_TYPE_LIST
141The list value is pointed to by \fBv.list\fR. 141The list value is pointed to by \fBv.list\fR.
142.TP 142.TP
143.B GRECS_TYPE_ARRAY 143.B ARGOT_TYPE_ARRAY
144The array itself is stored in \fBv.arg.v\fR. The \fBv.arg.c\fR member 144The array itself is stored in \fBv.arg.v\fR. The \fBv.arg.c\fR member
145contains the number of elements in the array. 145contains the number of elements in the array.
146.PP 146.PP
@@ -157,29 +157,29 @@ screen:
157int 157int
158main(int argc, char **argv) 158main(int argc, char **argv)
159{ 159{
160 struct grecs_node *tree; 160 struct argot_node *tree;
161 161
162 tree = grecs_parse(argv[1]); 162 tree = argot_parse(argv[1]);
163 grecs_format_node(tree, GRECS_NODE_FLAG_DEFAULT, stdout); 163 argot_format_node(tree, ARGOT_NODE_FLAG_DEFAULT, stdout);
164 fputc('\\n', stdout); 164 fputc('\\n', stdout);
165 grecs_tree_free(tree); 165 argot_tree_free(tree);
166 exit(0); 166 exit(0);
167} 167}
168.in 168.in
169.fi 169.fi
170.SH "SEE ALSO" 170.SH "SEE ALSO"
171.BR grecs_config (5), 171.BR argot_config (5),
172.BR grecs_error (3), 172.BR argot_error (3),
173.BR grecs_format_node (3), 173.BR argot_format_node (3),
174.BR grecs_tree_free (3). 174.BR argot_tree_free (3).
175.SH AUTHORS 175.SH AUTHORS
176Sergey Poznyakoff 176Sergey Poznyakoff
177.SH "BUG REPORTS" 177.SH "BUG REPORTS"
178Report bugs to <gray+grecs@gnu.org.ua>. 178Report bugs to <gray+argot@gnu.org.ua>.
179.SH COLOPHON 179.SH COLOPHON
180The \fBGrecs\fR library is constantly changing, so this manual page 180The \fBGrecs\fR library is constantly changing, so this manual page
181may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 181may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
182documentation, visit <http://www.gnu.org.ua/software/grecs>. 182documentation, visit <http://www.gnu.org.ua/software/argot>.
183.SH COPYRIGHT 183.SH COPYRIGHT
184Copyright \(co 2011 Sergey Poznyakoff 184Copyright \(co 2011 Sergey Poznyakoff
185.br 185.br
diff --git a/doc/grecs_stmt_path.5 b/doc/argot_stmt_path.5
index 2436630..bc2cc0a 100644
--- a/doc/grecs_stmt_path.5
+++ b/doc/argot_stmt_path.5
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,10 +14,10 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_STMT_PATH 5 "May 4, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_STMT_PATH 5 "May 4, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19Statement pathname \- a unique identifier of a statement in 19Statement pathname \- a unique identifier of a statement in
20\fBgrecs\fR configuration file. 20\fBargot\fR configuration file.
21.SH DESCRIPTION 21.SH DESCRIPTION
22\fBGrecs\fR configuration files have a distinct hierarchical 22\fBGrecs\fR configuration files have a distinct hierarchical
23structure. Each statement in such a file can therefore be identified 23structure. Each statement in such a file can therefore be identified
@@ -93,15 +93,15 @@ component separator, e.g.:
93 .program=\(dqa.out\(dq.bar.baz 93 .program=\(dqa.out\(dq.bar.baz
94.fi 94.fi
95.SH "SEE ALSO" 95.SH "SEE ALSO"
96.BR grecs_config (5). 96.BR argot_config (5).
97.SH AUTHORS 97.SH AUTHORS
98Sergey Poznyakoff 98Sergey Poznyakoff
99.SH "BUG REPORTS" 99.SH "BUG REPORTS"
100Report bugs to <gray+grecs@gnu.org.ua>. 100Report bugs to <gray+argot@gnu.org.ua>.
101.SH COLOPHON 101.SH COLOPHON
102The \fBGrecs\fR library is constantly changing, so this manual page 102The \fBGrecs\fR library is constantly changing, so this manual page
103may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 103may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
104documentation, visit <http://www.gnu.org.ua/software/grecs>. 104documentation, visit <http://www.gnu.org.ua/software/argot>.
105.SH COPYRIGHT 105.SH COPYRIGHT
106Copyright \(co 2011 Sergey Poznyakoff 106Copyright \(co 2011 Sergey Poznyakoff
107.br 107.br
diff --git a/doc/grecs_strdup.3 b/doc/argot_strdup.3
index e180264..ce53b07 100644
--- a/doc/grecs_strdup.3
+++ b/doc/argot_strdup.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,41 +14,41 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_STRDUP 3 "May 7, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_STRDUP 3 "May 7, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_strdup \- duplicate a string 19argot_strdup \- duplicate a string
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.BI "char *grecs_strdup(const char *" "str" ); 24.BI "char *argot_strdup(const char *" "str" );
25 25
26.SH DESCRIPTION 26.SH DESCRIPTION
27The 27The
28.BR strdup () 28.BR strdup ()
29function returns a pointer to a new string which is a duplicate of the 29function returns a pointer to a new string which is a duplicate of the
30string \fIstr\fR. Memory for the new string is obtained with 30string \fIstr\fR. Memory for the new string is obtained with
31.BR grecs_malloc (3), 31.BR argot_malloc (3),
32and must be freed with 32and must be freed with
33.BR grecs_free (3). 33.BR argot_free (3).
34.SH "RETURN VALUE" 34.SH "RETURN VALUE"
35The 35The
36.BR grecs_strdup () 36.BR argot_strdup ()
37function returns a pointer to the duplicated string. 37function returns a pointer to the duplicated string.
38.PP 38.PP
39On error, 39On error,
40.BR grecs_alloc_die (3) 40.BR argot_alloc_die (3)
41is called, which terminates the program. 41is called, which terminates the program.
42.SH "SEE ALSO" 42.SH "SEE ALSO"
43.BR grecs_alloc_die (3) 43.BR argot_alloc_die (3)
44.SH AUTHORS 44.SH AUTHORS
45Sergey Poznyakoff 45Sergey Poznyakoff
46.SH "BUG REPORTS" 46.SH "BUG REPORTS"
47Report bugs to <gray+grecs@gnu.org.ua>. 47Report bugs to <gray+argot@gnu.org.ua>.
48.SH COLOPHON 48.SH COLOPHON
49The \fBGrecs\fR library is constantly changing, so this manual page 49The \fBGrecs\fR library is constantly changing, so this manual page
50may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 50may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
51documentation, visit <http://www.gnu.org.ua/software/grecs>. 51documentation, visit <http://www.gnu.org.ua/software/argot>.
52.SH COPYRIGHT 52.SH COPYRIGHT
53Copyright \(co 2011 Sergey Poznyakoff 53Copyright \(co 2011 Sergey Poznyakoff
54.br 54.br
diff --git a/doc/grecs_tree_free.3 b/doc/argot_tree_free.3
index 7b0faf6..b064a23 100644
--- a/doc/grecs_tree_free.3
+++ b/doc/argot_tree_free.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,32 +14,32 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_XXX 3 "May 4, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_XXX 3 "May 4, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19grecs_tree_free \- reclaim the memory used by entire parse tree 19argot_tree_free \- reclaim the memory used by entire parse tree
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.BI "void grecs_tree_free(struct grecs_node " "*node" ); 24.BI "void argot_tree_free(struct argot_node " "*node" );
25.SH DESCRIPTION 25.SH DESCRIPTION
26\fBgrecs_tree_free\fR reclaims the memory used by \fInode\fR and all 26\fBargot_tree_free\fR reclaims the memory used by \fInode\fR and all
27nodes it points to, recursively. 27nodes it points to, recursively.
28.PP 28.PP
29The argument \fInode\fR must be the root of a parse tree. 29The argument \fInode\fR must be the root of a parse tree.
30.SH "RETURN VALUE" 30.SH "RETURN VALUE"
31None. 31None.
32.SH "SEE ALSO" 32.SH "SEE ALSO"
33.BR grecs_parse (3), 33.BR argot_parse (3),
34.BR grecs_node_free (3). 34.BR argot_node_free (3).
35.SH AUTHORS 35.SH AUTHORS
36Sergey Poznyakoff 36Sergey Poznyakoff
37.SH "BUG REPORTS" 37.SH "BUG REPORTS"
38Report bugs to <gray+grecs@gnu.org.ua>. 38Report bugs to <gray+argot@gnu.org.ua>.
39.SH COLOPHON 39.SH COLOPHON
40The \fBGrecs\fR library is constantly changing, so this manual page 40The \fBGrecs\fR library is constantly changing, so this manual page
41may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 41may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
42documentation, visit <http://www.gnu.org.ua/software/grecs>. 42documentation, visit <http://www.gnu.org.ua/software/argot>.
43.SH COPYRIGHT 43.SH COPYRIGHT
44Copyright \(co 2011 Sergey Poznyakoff 44Copyright \(co 2011 Sergey Poznyakoff
45.br 45.br
diff --git a/doc/tmpl.3 b/doc/tmpl.3
index b4eeb96..6827d77 100644
--- a/doc/tmpl.3
+++ b/doc/tmpl.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,12 +14,12 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH GRECS_XXX 3 "May 4, 2011" "GRECS" "Grecs User Reference" 17.TH ARGOT_XXX 3 "May 4, 2011" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19 19
20.SH SYNOPSIS 20.SH SYNOPSIS
21.nf 21.nf
22.B #include <grecs.h> 22.B #include <argot.h>
23.sp 23.sp
24.SH DESCRIPTION 24.SH DESCRIPTION
25.SH "RETURN VALUE" 25.SH "RETURN VALUE"
@@ -28,11 +28,11 @@
28.SH AUTHORS 28.SH AUTHORS
29Sergey Poznyakoff 29Sergey Poznyakoff
30.SH "BUG REPORTS" 30.SH "BUG REPORTS"
31Report bugs to <gray+grecs@gnu.org.ua>. 31Report bugs to <gray+argot@gnu.org.ua>.
32.SH COLOPHON 32.SH COLOPHON
33The \fBGrecs\fR library is constantly changing, so this manual page 33The \fBGrecs\fR library is constantly changing, so this manual page
34may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR 34may be incorrect or out-of-date. For the latest copy of \fBGrecs\fR
35documentation, visit <http://www.gnu.org.ua/software/grecs>. 35documentation, visit <http://www.gnu.org.ua/software/argot>.
36.SH COPYRIGHT 36.SH COPYRIGHT
37Copyright \(co 2011 Sergey Poznyakoff 37Copyright \(co 2011 Sergey Poznyakoff
38.br 38.br
diff --git a/doc/wordsplit.3 b/doc/wordsplit.3
index 067ea5e..13b634b 100644
--- a/doc/wordsplit.3
+++ b/doc/wordsplit.3
@@ -1,4 +1,4 @@
1.\" This file is part of grecs -*- nroff -*- 1.\" This file is part of argot -*- nroff -*-
2.\" Copyright (C) 2007-2016 Sergey Poznyakoff 2.\" Copyright (C) 2007-2016 Sergey Poznyakoff
3.\" 3.\"
4.\" Grecs is free software; you can redistribute it and/or modify 4.\" Grecs is free software; you can redistribute it and/or modify
@@ -14,7 +14,7 @@
14.\" You should have received a copy of the GNU General Public License 14.\" You should have received a copy of the GNU General Public License
15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>. 15.\" along with Grecs. If not, see <http://www.gnu.org/licenses/>.
16.\" 16.\"
17.TH WORDSPLIT 3 "December 3, 2014" "GRECS" "Grecs User Reference" 17.TH WORDSPLIT 3 "December 3, 2014" "ARGOT" "Grecs User Reference"
18.SH NAME 18.SH NAME
19wordsplit \- split string into words 19wordsplit \- split string into words
20.SH SYNOPSIS 20.SH SYNOPSIS
@@ -971,7 +971,7 @@ char **shell_parse(char *s)
971.SH AUTHORS 971.SH AUTHORS
972Sergey Poznyakoff 972Sergey Poznyakoff
973.SH "BUG REPORTS" 973.SH "BUG REPORTS"
974Report bugs to <gray+grecs@gnu.org.ua>. 974Report bugs to <gray+argot@gnu.org.ua>.
975.SH COPYRIGHT 975.SH COPYRIGHT
976Copyright \(co 2009-2014 Sergey Poznyakoff 976Copyright \(co 2009-2014 Sergey Poznyakoff
977.br 977.br

Return to:

Send suggestions and report system problems to the System administrator.