bug-bison
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Is there a bug with --skeleton parameter?


From: Akim Demaille
Subject: Re: Is there a bug with --skeleton parameter?
Date: Thu, 5 Mar 2020 17:58:24 +0100


> Le 4 mars 2020 à 08:42, Morales Cayuela, Victor (NSB - CN/Hangzhou) 
> <address@hidden> a écrit :
> 
> Looks perfect to me.

I actually installed this longer version.

commit ecd922024ed22d6bc0383cdadee7a3298761759d
Author: Akim Demaille <address@hidden>
Date:   Wed Mar 4 08:19:37 2020 +0100

    README: point to tests/bison, and document --trace
    
    Reported by Victor Morales Cayuela.
    
    * README, README-hacking.md: here.

diff --git a/README b/README
index f18958a1..f8d79755 100644
--- a/README
+++ b/README
@@ -17,6 +17,11 @@ See the file INSTALL for generic compilation and 
installation instructions.
 Bison requires GNU m4 1.4.6 or later.  See
 https://ftp.gnu.org/gnu/m4/m4-1.4.6.tar.gz.
 
+## Running a non installed bison
+Once you ran `make`, you might want to toy with this fresh bison before
+installing it.  In that case, do not use `src/bison`: it would use the
+*installed* files (skeletons, etc.), not the local ones.  Use `tests/bison`.
+
 ## Colored diagnostics
 As an experimental feature, diagnostics are now colored, controlled by the
 `--color` and `--style` options.
diff --git a/README-hacking.md b/README-hacking.md
index f6b3ee6c..2fbca3bc 100644
--- a/README-hacking.md
+++ b/README-hacking.md
@@ -34,13 +34,28 @@ Only user visible strings are to be translated: error 
messages, bits of the
 assert/abort), and all the --trace output which is meant for the maintainers
 only.
 
-## Horizontal tabs
+## Coding style
+Follow the GNU Coding Standards.
+
+Don't reinvent the wheel: we use gnulib, which features many components.
+Actually, Bison has legacy code that we should replace with gnulib modules
+(e.g., many adhoc implementations of lists).
+
 Do not add horizontal tab characters to any file in Bison's repository
 except where required.  For example, do not use tabs to format C code.
 However, make files, ChangeLog, and some regular expressions require tabs.
 Also, test cases might need to contain tabs to check that Bison properly
 processes tabs in its input.
 
+## Commit messages
+Please, imitate the style we use.  Use `git log` to get sources of
+inspiration.
+
+## Debugging
+Bison supports tracing of its various steps, via the `--trace` option.
+Since it is not meant for the end user, it is not displayed by `bison
+--help`, nor is it documented in the manual.  Instead, run `bison
+--trace=help`.
 
 # Working from the repository
 




reply via email to

[Prev in Thread] Current Thread [Next in Thread]