[liblouis-liblouisxml] Re: liblouisutdml documentation

  • From: "Michael Whapples" <dmarc-noreply@xxxxxxxxxxxxx> (Redacted sender "mwhapples@xxxxxxx" for DMARC)
  • To: liblouis-liblouisxml@xxxxxxxxxxxxx
  • Date: Wed, 18 Jun 2014 17:55:22 +0100

I agree, why generate it unless needed.

Also I sometimes feel over automation leads to over complication.

However I don't think running make_sem_names is documented anywhere, it should be noted.

Michael Whapples
On 18/06/2014 17:05, John J. Boyer wrote:
sem_names.h needs to be generated only when sem_enum.h is changed, which
is not often. Why bother doing it for each build?

John

On Wed, Jun 18, 2014 at 05:10:24PM +0200, Christian Egli wrote:
On 06/18/2014 03:33 PM, John J. Boyer wrote:
A note on semantic actions. sem_names.h is a generated file. The basic
file is sem_enum.h . If you add a semantic action you must do it in
sem_enum.h and then run Makesemnames to generate sem_names.f .
Descriptive comments should be in sem_enum.h . It already contains
comments on various classes of semantic actions.Of course this is just
source code documentation.
This is something that has been bugging me forever and tree days.
Why do we need both these files? Presumably we need both of them. If
so then could we not generate the other one based on a simple Perl
script that is integrated with the build system? I looked at
make_sem_names.c. Am I right in my conclusion that it simply takes
all the names from the enum and produces the semNames array? Maybe
this could even be done with a preprocessor macro (hmm, on second
thought probably not)?

I'll spend a few minutes to cook up a script to do this.

Thanks
Christian

--
Christian Egli
Swiss Library for the Blind, Visually Impaired and Print Disabled
Grubenstrasse 12, CH-8045 Zürich, Switzerland


-----
Tag der offenen Tuer: Die SBS laedt Sie herzlich ein: 28. Juni 2014
von 9 bis 16 Uhr. Mehr Informationen erhalten Sie unter
http://www.sbs.ch/offenetuer
For a description of the software, to download it and links to
project pages go to http://www.abilitiessoft.com

For a description of the software, to download it and links to
project pages go to http://www.abilitiessoft.com

Other related posts: