Final cleanup before the release.release-1_4

* NEWS: Update.
* README: Update.
* doc/cflow.texi: Update.
* src/main.c (symbol_override): pass allocated argument to install.
* src/parser.c (yyparse): Return 0.

5 files changed, 115 insertions, 93 deletions

diff --git a/NEWS b/NEWS
index 3e334c2..4bfa96b 100644
--- a/NEWS
+++ b/NEWS
@@ -5,7 +5,7 @@ See the end of file for copying conditions.
 Please send cflow bug reports to <bug-cflow@gnu.org>.
 
 
-Version 1.4 (Git)
+Version 1.4, 2011-10-11
 
 * Symbol aliases
 
diff --git a/README b/README
index 12adbe7..e4b89ca 100644
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
 GNU cflow README
-Copyright (C) 2005, 2010 Sergey Poznyakoff
+Copyright (C) 2005, 2010, 2011 Sergey Poznyakoff
 See the end of file for copying conditions.
 
 * Introduction
@@ -10,10 +10,8 @@ documentation, instead it is provided as a brief reference only.
 Please be sure to read the accompanuing documentation before using the
 utility. See section `Documentation' below.
 
-Please read *all* sections of this `README' file before starting
-configuration.  Also make sure you read `INSTALL' if you are not
-familiar with them already. Refer to file `ABOUT-NLS' for information
-regarding internationalization.
+For the generic configuration options, see the file `INSTALL'.
+Refer to file `ABOUT-NLS' for information regarding internationalization.
 
 * History
 
@@ -54,6 +52,12 @@ cflow.
 
 After running `./configure' and `make', run `make install'.
 
+* Configuration File
+
+The file src/cflow.rc provides a working configuration file for use
+with gcc.  See the documentation, sections 6.1 "Syntactic classes" and
+6.3 "GCC Initialization", for more information.
+
 * Documentation
 
 Complete user manual in texinfo format is provided. After the
@@ -70,7 +74,7 @@ Send bug reports and suggestions to <bug-cflow@gnu.org>.
 
 * Copyright Information:
 
-Copyright (C) 2005, Sergey Poznyakoff 
+Copyright (C) 2005, 2010, 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
diff --git a/doc/cflow.texi b/doc/cflow.texi
index 82bd028..dfb1fdf 100644
--- a/doc/cflow.texi
+++ b/doc/cflow.texi
@@ -1,5 +1,4 @@
 \input texinfo @c -*-texinfo-*-
-@smallbook
 @c %**start of header
 @setfilename cflow.info
 @settitle GNU cflow
@@ -144,14 +143,14 @@ with an example.  Suppose you have a simple implementation of
 @command{whoami} command and you wish to obtain a graph of function
 dependencies.  Here is the program:
 
-@smallexample
+@example
 @verbatiminclude whoami.c
-@end smallexample
+@end example
 
      Running @command{cflow} produces the following output:
 
 @cindex GNU Output Format, an example
-@smallexample
+@example
 @group
 $ @kbd{cflow whoami.c}
 main() <int main (int argc,char **argv) at whoami.c:26>:
@@ -163,7 +162,7 @@ main() <int main (int argc,char **argv) at whoami.c:26>:
         fprintf()
         printf()
 @end group
-@end smallexample
+@end example
 
 @cindex GNU Output Format described
 @anchor{GNU Output Format}
@@ -176,9 +175,9 @@ displaying, within a pair of angle brackets, a function
 calls another functions, the line ends with a colon.  For example, the
 line
 
-@smallexample
+@example
 main() <int main (int argc,char **argv) at whoami.c:25>:
-@end smallexample
+@end example
 
 @noindent
 shows that function @code{main} is defined in file @file{whoami.c}
@@ -186,8 +185,8 @@ at line 25, as @code{int main (int argc, char **argv)}.  Terminating
 colon indicates that @code{main} invokes other functions.
 
      The lines following this one show which functions are called by
-@code{main}.  Each such line is indented by fixed amount of white space
-(by default four spaces) for each nesting level.
+@code{main}.  Each such line is indented by a fixed amount of white space
+(by default, four spaces) for each nesting level.
 
 @cindex @option{--omit-symbol-names} option introduced
 @cindex @option{--omit-arguments} option introduced
@@ -201,9 +200,9 @@ of reasons, one of them being to make the resulting graph more
 compact.  To illustrate their effect, here is how would the first line of the
 above graph look if you had used both @option{--omit-} options:
 
-@smallexample
+@example
 main() <int () at whoami.c:25>:
-@end smallexample
+@end example
 
 @cindex start symbol
 @cindex @option{--main} command line option introduced
@@ -217,14 +216,14 @@ the graph starting on particular function.  @command{Cflow}
 allows to select such function using @option{--main} (@option{-m})
 command line option.  Thus, running
 
-@smallexample
+@example
 cflow --main who_am_i whoami.c
-@end smallexample
+@end example
 
 @noindent
 on the above file will produce following graph:
 
-@smallexample
+@example
 @group
 who_am_i() <int who_am_i (void) at whoami.c:8>:
     getpwuid()
@@ -233,7 +232,7 @@ who_am_i() <int who_am_i (void) at whoami.c:8>:
     fprintf()
     printf()
 @end group
-@end smallexample
+@end example
 
 @node Direct and Reverse
 @chapter Two Types of Flow Graphs.
@@ -248,7 +247,7 @@ option.  For example, using a sample @file{whoami.c}:
 
 @cindex reverse graph, example
 @cindex reverse tree, example
-@smallexample
+@example
 @group
 $ @kbd{cflow --reverse whoami.c}
 fprintf():
@@ -271,7 +270,7 @@ printf():
 who_am_i() <int who_am_i (void) at whoami.c:8>:
     main() <int main (int argc,char **argv) at whoami.c:26>
 @end group    
-@end smallexample
+@end example
 
      This output consists of several subgraphs, each describing callers
 for a particular function.  Thus, the first subgraph tells that the
@@ -284,11 +283,11 @@ and @code{main}.  First of them is, in turn, also called directly by
 @anchor{--brief}
      The first thing that draws attention in the above output is that
 the subgraph starting with @code{who_am_i} function is repeated several
-times.  This is @dfn{verbose} output.  To make it brief, use
+times.  This is a @dfn{verbose} output.  To make it brief, use
 @option{--brief} (@option{-b}) command line option.  For example:
 
 @cindex brief output, an example of
-@smallexample
+@example
 @group
 $ @kbd{cflow --brief --reverse whoami.c}
 fprintf():
@@ -306,7 +305,7 @@ printf():
     who_am_i() <int who_am_i (void) at whoami.c:8>: [see 2]
 who_am_i() <int who_am_i (void) at whoami.c:8>: [see 2]
 @end group
-@end smallexample
+@end example
 
 @cindex brief output described
      In brief output, once a subgraph for a given function is written,
@@ -317,7 +316,7 @@ expanded subgraph can be found.
 @cindex @option{--number} command line option introduced
 @cindex @option{-n} command line option introduced
 @anchor{--number}
-     If the output graph is large it can be tedious to find out the
+     If the output graph is large, it can be tedious to find out the