[Freeciv-Dev] Re: (PR#8239) Speclist generator

["Jason Short" <jdorje@xxxxxxxxxxxxxxxxxxxxx>]

<URL: http://rt.freeciv.org/Ticket/Display.html?id=8239 >

Raimar Falke wrote:

>>(Except perhaps that a generator'ed speclist header file is much easier to
>>read than speclist.h)
> 
> You don't need to read speclist.h as a normal programmer.

That's not true.  Functions (like unit_list_init) are *only* documented 
in speclist.h.  For most people reading the source code may not be very 
helpful, however.  There are comments explaining the usage.


I'm not generally in favor of generators, but Per's right about the 
problems with the current speclist system.  It is very clever, but still 
a hack.  And using it requires some understanding of its cleverness, 
which is time that could be spent elsewhere (of course all time is time 
that could be spent elsewhere).

jason