ncurses 5.4
[ncurses.git] / ncurses / base / MKlib_gen.sh
1 #!/bin/sh
2 #
3 # MKlib_gen.sh -- generate sources from curses.h macro definitions
4 #
5 # ($Id: MKlib_gen.sh,v 1.23 2004/02/07 13:31:35 tom Exp $)
6 #
7 ##############################################################################
8 # Copyright (c) 1998-2003,2004 Free Software Foundation, Inc.                #
9 #                                                                            #
10 # Permission is hereby granted, free of charge, to any person obtaining a    #
11 # copy of this software and associated documentation files (the "Software"), #
12 # to deal in the Software without restriction, including without limitation  #
13 # the rights to use, copy, modify, merge, publish, distribute, distribute    #
14 # with modifications, sublicense, and/or sell copies of the Software, and to #
15 # permit persons to whom the Software is furnished to do so, subject to the  #
16 # following conditions:                                                      #
17 #                                                                            #
18 # The above copyright notice and this permission notice shall be included in #
19 # all copies or substantial portions of the Software.                        #
20 #                                                                            #
21 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR #
22 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,   #
23 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL    #
24 # THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER      #
25 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING    #
26 # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER        #
27 # DEALINGS IN THE SOFTWARE.                                                  #
28 #                                                                            #
29 # Except as contained in this notice, the name(s) of the above copyright     #
30 # holders shall not be used in advertising or otherwise to promote the sale, #
31 # use or other dealings in this Software without prior written               #
32 # authorization.                                                             #
33 ##############################################################################
34 #
35 # The XSI Curses standard requires all curses entry points to exist as
36 # functions, even though many definitions would normally be shadowed
37 # by macros.  Rather than hand-hack all that code, we actually
38 # generate functions from the macros.
39 #
40 # This script accepts a file of prototypes on standard input.  It discards
41 # any that don't have a `generated' comment attached. It then parses each
42 # prototype (relying on the fact that none of the macros take function 
43 # pointer or array arguments) and generates C source from it.
44 #
45 # Here is what the pipeline stages are doing:
46 #
47 # 1. sed: extract prototypes of generated functions
48 # 2. sed: decorate prototypes with generated arguments a1. a2,...z
49 # 3. awk: generate the calls with args matching the formals 
50 # 4. sed: prefix function names in prototypes so the preprocessor won't expand
51 #         them.
52 # 5. cpp: macro-expand the file so the macro calls turn into C calls
53 # 6. awk: strip the expansion junk off the front and add the new header
54 # 7. sed: squeeze spaces, strip off gen_ prefix, create needed #undef
55 #
56
57 # keep the editing independent of locale:
58 if test "${LANGUAGE+set}"    = set; then LANGUAGE=C;    export LANGUAGE;    fi
59 if test "${LANG+set}"        = set; then LANG=C;        export LANG;        fi
60 if test "${LC_ALL+set}"      = set; then LC_ALL=C;      export LC_ALL;      fi
61 if test "${LC_MESSAGES+set}" = set; then LC_MESSAGES=C; export LC_MESSAGES; fi
62 if test "${LC_CTYPE+set}"    = set; then LC_CTYPE=C;    export LC_CTYPE;    fi
63 if test "${LC_COLLATE+set}"  = set; then LC_COLLATE=C;  export LC_COLLATE;  fi
64
65 preprocessor="$1 -I../include"
66 AWK="$2"
67 USE="$3"
68
69 PID=$$
70 ED1=sed1_${PID}.sed
71 ED2=sed2_${PID}.sed
72 ED3=sed3_${PID}.sed
73 ED4=sed4_${PID}.sed
74 AW1=awk1_${PID}.awk
75 AW2=awk2_${PID}.awk
76 TMP=gen__${PID}.c
77 trap "rm -f $ED1 $ED2 $ED3 $ED4 $AW1 $AW2 $TMP" 0 1 2 5 15
78
79 ALL=$USE
80 if test "$USE" = implemented ; then
81         CALL="call_"
82         cat >$ED1 <<EOF1
83 /^extern.*implemented/{
84         h
85         s/^.*implemented:\([^   *]*\).*/P_POUNDCif_USE_\1_SUPPORT/p
86         g
87         s/^extern \([^;]*\);.*/\1/p
88         g
89         s/^.*implemented:\([^   *]*\).*/P_POUNDCendif/p
90 }
91 /^extern.*generated/{
92         h
93         s/^.*generated:\([^     *]*\).*/P_POUNDCif_USE_\1_SUPPORT/p
94         g
95         s/^extern \([^;]*\);.*/\1/p
96         g
97         s/^.*generated:\([^     *]*\).*/P_POUNDCendif/p
98 }
99 EOF1
100 else
101         CALL=""
102         cat >$ED1 <<EOF1
103 /^extern.*${ALL}/{
104         h
105         s/^.*${ALL}:\([^        *]*\).*/P_POUNDCif_USE_\1_SUPPORT/p
106         g
107         s/^extern \([^;]*\);.*/\1/p
108         g
109         s/^.*${ALL}:\([^        *]*\).*/P_POUNDCendif/p
110 }
111 EOF1
112 fi
113
114 cat >$ED2 <<EOF2
115 /^P_/b nc
116 /(void)/b nc
117         s/,/ a1% /
118         s/,/ a2% /
119         s/,/ a3% /
120         s/,/ a4% /
121         s/,/ a5% /
122         s/,/ a6% /
123         s/,/ a7% /
124         s/,/ a8% /
125         s/,/ a9% /
126         s/,/ a10% /
127         s/,/ a11% /
128         s/,/ a12% /
129         s/,/ a13% /
130         s/,/ a14% /
131         s/,/ a15% /
132         s/*/ * /g
133         s/%/ , /g
134         s/)/ z)/
135         s/\.\.\. z)/...)/
136 :nc
137         s/(/ ( /
138         s/)/ )/
139 EOF2
140
141 cat >$ED3 <<EOF3
142 /^P_/{
143         s/^P_POUNDCif_/#if /
144         s/^P_POUNDCendif/#endif/
145         s/^P_//
146         b done
147 }
148         s/              */ /g
149         s/  */ /g
150         s/ ,/,/g
151         s/( /(/g
152         s/ )/)/g
153         s/ gen_/ /
154         s/^M_/#undef /
155         s/^[    ]*%[    ]*%[    ]*/     /
156 :done
157 EOF3
158
159 if test "$USE" = generated ; then
160 cat >$ED4 <<EOF
161         s/^\(.*\) \(.*\) (\(.*\))\$/NCURSES_EXPORT(\1) \2 (\3)/
162 EOF
163 else
164 cat >$ED4 <<EOF
165 /^\(.*\) \(.*\) (\(.*\))\$/ {
166         h
167         s/^\(.*\) \(.*\) (\(.*\))\$/extern \1 call_\2 (\3);/
168         p
169         g
170         s/^\(.*\) \(.*\) (\(.*\))\$/\1 call_\2 (\3)/
171         }
172 EOF
173 fi
174
175 cat >$AW1 <<\EOF1
176 BEGIN   {
177                 skip=0;
178         }
179 /^P_POUNDCif/ {
180                 print "\n"
181                 print $0
182                 skip=0;
183 }
184 /^P_POUNDCendif/ {
185                 print $0
186                 skip=1;
187 }
188 $0 !~ /^P_/ {
189         if (skip)
190                 print "\n"
191         skip=1;
192
193         first=$1
194         for (i = 1; i <= NF; i++) {
195                 if ( $i != "NCURSES_CONST" ) {
196                         first = i;
197                         break;
198                 }
199         }
200         second = first + 1;
201         if ( $first == "chtype" ) {
202                 returnType = "Char";
203         } else if ( $first == "SCREEN" ) {
204                 returnType = "SP";
205         } else if ( $first == "WINDOW" ) {
206                 returnType = "Win";
207         } else if ( $first == "attr_t" || $second == "attrset" || $second == "standout" || $second == "standend" || $second == "wattrset" || $second == "wstandout" || $second == "wstandend" ) {
208                 returnType = "Attr";
209         } else if ( $first == "bool" || $first == "NCURSES_BOOL" ) {
210                 returnType = "Bool";
211         } else if ( $second == "*" ) {
212                 returnType = "Ptr";
213         } else {
214                 returnType = "Code";
215         }
216         myfunc = second;
217         for (i = second; i <= NF; i++) {
218                 if ($i != "*") {
219                         myfunc = i;
220                         break;
221                 }
222         }
223         if (using == "generated") {
224                 print "M_" $myfunc
225         }
226         print $0;
227         print "{";
228         argcount = 1;
229         check = NF - 1;
230         if ($check == "void")
231                 argcount = 0;
232         if (argcount != 0) {
233                 for (i = 1; i <= NF; i++)
234                         if ($i == ",")
235                                 argcount++;
236         }
237
238         # suppress trace-code for functions that we cannot do properly here,
239         # since they return data.
240         dotrace = 1;
241         if ($myfunc ~ /innstr/)
242                 dotrace = 0;
243         if ($myfunc ~ /innwstr/)
244                 dotrace = 0;
245
246         # workaround functions that we do not parse properly
247         if ($myfunc ~ /ripoffline/) {
248                 dotrace = 0;
249                 argcount = 2;
250         }
251         if ($myfunc ~ /wunctrl/) {
252                 dotrace = 0;
253         }
254
255         call = "%%T((T_CALLED(\""
256         args = ""
257         comma = ""
258         num = 0;
259         pointer = 0;
260         argtype = ""
261         for (i = myfunc; i <= NF; i++) {
262                 ch = $i;
263                 if ( ch == "*" )
264                         pointer = 1;
265                 else if ( ch == "va_list" )
266                         pointer = 1;
267                 else if ( ch == "char" )
268                         argtype = "char";
269                 else if ( ch == "int" )
270                         argtype = "int";
271                 else if ( ch == "short" )
272                         argtype = "short";
273                 else if ( ch == "chtype" )
274                         argtype = "chtype";
275                 else if ( ch == "attr_t" || ch == "NCURSES_ATTR_T" )
276                         argtype = "attr";
277
278                 if ( ch == "," || ch == ")" ) {
279                         if (pointer) {
280                                 if ( argtype == "char" ) {
281                                         call = call "%s"
282                                         comma = comma "_nc_visbuf2(" num ","
283                                         pointer = 0;
284                                 } else
285                                         call = call "%p"
286                         } else if (argcount != 0) {
287                                 if ( argtype == "int" || argtype == "short" ) {
288                                         call = call "%d"
289                                         argtype = ""
290                                 } else if ( argtype != "" ) {
291                                         call = call "%s"
292                                         comma = comma "_trace" argtype "2(" num ","
293                                 } else {
294                                         call = call "%#lx"
295                                         comma = comma "(long)"
296                                 }
297                         }
298                         if (ch == ",")
299                                 args = args comma "a" ++num;
300                         else if ( argcount != 0 && $check != "..." )
301                                 args = args comma "z"
302                         call = call ch
303                         if (pointer == 0 && argcount != 0 && argtype != "" )
304                                 args = args ")"
305                         if (args != "")
306                                 comma = ", "
307                         pointer = 0;
308                         argtype = ""
309                 }
310                 if ( i == 2 || ch == "(" )
311                         call = call ch
312         }
313         call = call "\")"
314         if (args != "")
315                 call = call ", " args
316         call = call ")); "
317
318         if (dotrace)
319                 printf "%s", call
320
321         if (match($0, "^void"))
322                 call = ""
323         else if (dotrace)
324                 call = sprintf("return%s( ", returnType);
325         else
326                 call = "%%return ";
327
328         call = call $myfunc "(";
329         for (i = 1; i < argcount; i++) {
330                 if (i != 1)
331                         call = call ", ";
332                 call = call "a" i;
333         }
334         if ( argcount != 0 && $check != "..." ) {
335                 if (argcount != 1)
336                         call = call ", ";
337                 call = call "z";
338         }
339         if (!match($0, "^void"))
340                 call = call ") ";
341         if (dotrace)
342                 call = call ")";
343         print call ";"
344
345         if (match($0, "^void"))
346                 print "%%returnVoid;"
347         print "}";
348 }
349 EOF1
350
351 cat >$AW2 <<EOF1
352 BEGIN           {
353                 print "/*"
354                 print " * DO NOT EDIT THIS FILE BY HAND!"
355                 printf " * It is generated by $0 %s.\n", "$USE"
356                 if ( "$USE" == "generated" ) {
357                         print " *"
358                         print " * This is a file of trivial functions generated from macro"
359                         print " * definitions in curses.h to satisfy the XSI Curses requirement"
360                         print " * that every macro also exist as a callable function."
361                         print " *"
362                         print " * It will never be linked unless you call one of the entry"
363                         print " * points with its normal macro definition disabled.  In that"
364                         print " * case, if you have no shared libraries, it will indirectly"
365                         print " * pull most of the rest of the library into your link image."
366                 }
367                 print " */"
368                 print "#include <curses.priv.h>"
369                 print ""
370                 }
371 /^DECLARATIONS/ {start = 1; next;}
372                 {if (start) print \$0;}
373 END             {
374                 if ( "$USE" != "generated" ) {
375                         print "int main(void) { return 0; }"
376                 }
377                 }
378 EOF1
379
380 cat >$TMP <<EOF
381 #include <ncurses_cfg.h>
382 #include <curses.h>
383
384 DECLARATIONS
385
386 EOF
387
388 sed -n -f $ED1 \
389 | sed -e 's/NCURSES_EXPORT(\(.*\)) \(.*\) (\(.*\))/\1 \2(\3)/' \
390 | sed -f $ED2 \
391 | $AWK -f $AW1 using=$USE \
392 | sed -e 's/^\([a-z_][a-z_]*[ *]*\)/\1 gen_/' -e 's/  / /g' >>$TMP
393
394 $preprocessor $TMP 2>/dev/null \
395 | sed -e 's/  / /g' -e 's/^ //' \
396 | $AWK -f $AW2 \
397 | sed -f $ED3 \
398 | sed \
399         -e 's/^.*T_CALLED.*returnCode( \([a-z].*) \));/ return \1;/' \
400         -e 's/^.*T_CALLED.*returnCode( \((wmove.*) \));/        return \1;/' \
401 | sed -f $ED4