1#!/bin/awk -f
2# scripts/options.awk - library build configuration control
3#
4# last changed in libpng version 1.6.11 - June 5, 2014
5#
6# Copyright (c) 1998-2014 Glenn Randers-Pehrson
7#
8# This code is released under the libpng license.
9# For conditions of distribution and use, see the disclaimer
10# and license in png.h
11
12# The output of this script is written to the file given by
13# the variable 'out'.  The script is run twice, once with
14# an intermediate output file, 'options.tmp' then again on
15# that file to produce the final output:
16#
17#  awk -f scripts/options.awk out=options.tmp scripts/options.dfa 1>&2
18#  awk -f scripts/options.awk out=options.dfn options.tmp 1>&2
19#
20# Some options may be specified on the command line:
21#
22#  deb=1            Causes debugging to be output
23#  logunsupported=1 Causes all options to be recorded in the output
24#  everything=off   Causes all options to be disabled by default
25#  everything=on    Causes all options to be enabled by default
26#
27# If awk fails on your platform, try nawk instead.
28#
29# These options may also be specified in the original input file (and
30# are copied to the preprocessed file).
31
32BEGIN{
33   out=""                       # intermediate, preprocessed, file
34   pre=-1                       # preprocess (first line)
35   version="libpng version unknown" # version information
36   version_file=""              # where to find the version
37   err=0                        # in-line exit sets this
38   # The following definitions prevent the C preprocessor noticing the lines
39   # that will be in the final output file.  Some C preprocessors tokenise
40   # the lines, for example by inserting spaces around operators, and all
41   # C preprocessors notice lines that start with '#', most remove comments.
42   # The technique adopted here is to make the final output lines into
43   # C strings (enclosed in double quotes), preceeded by PNG_DFN.  As a
44   # consequence the output cannot contain a 'raw' double quote - instead put
45   # @' in, this will be replaced by a single " afterward.  See the parser
46   # script dfn.awk for more capabilities (not required here).  Note that if
47   # you need a " in a 'setting' in pnglibconf.dfa it must also be @'!
48   dq="@'"                      # For a single double quote
49   start=" PNG_DFN \""          # Start stuff to output (can't contain a "!)
50   end="\" "                    # End stuff to output
51   subs="@\" "                  # Substitute start (substitute a C macro)
52   sube=" \"@"                  # Substitute end
53   comment=start "/*"           # Comment start
54   cend="*/" end                # Comment end
55   def=start "#define PNG_"     # Arbitrary define
56   sup="_SUPPORTED" end         # end supported option
57   und=comment "#undef PNG_"    # Unsupported option
58   une="_SUPPORTED" cend        # end unsupported option
59   error=start "ERROR:"         # error message, terminate with 'end'
60
61   # Variables
62   deb=0                        # debug - set on command line
63   everything=""                # do not override defaults
64   logunsupported=0             # write unsupported options too
65
66   # Precreate arrays
67   # for each option:
68   option[""] = ""    # list of all options: default enabled/disabled
69   done[""] = 1       # marks option as having been output
70   requires[""] = ""  # requires by option
71   iffs[""] = ""      # if by option
72   enabledby[""] = "" # options that enable it by option
73   sets[""] = ""      # settings set by each option
74   setval[""] = ""    # value to set (indexed: 'option sets[option]')
75   # for each setting:
76   setting[""] = ""   # requires by setting
77   defaults[""] = ""  # used for a defaulted value
78   doneset[""] = 1    # marks setting as having been output
79   r[""] = ""         # Temporary array
80
81   # For decorating the output file
82   protect = ""
83}
84
85# The output file must be specified before any input:
86out == "" {
87   print "out=output.file must be given on the command line"
88   err = 1
89   exit 1
90}
91
92# The very first line indicates whether we are reading pre-processed
93# input or not, this must come *first* because 'PREPROCESSED' needs
94# to be the very first line in the temporary file.
95pre == -1{
96   if ($0 == "PREPROCESSED") {
97      pre = 0
98      next
99   } else {
100      pre = 1
101      print "PREPROCESSED" >out
102      # And fall through to continue processing
103   }
104}
105
106# While pre-processing if version is set to "search" look for a version string
107# in the following file.
108pre && version == "search" && version_file == ""{
109   version_file = FILENAME
110}
111
112pre && version == "search" && version_file != FILENAME{
113   print "version string not found in", version_file
114   err = 1
115   exit 1
116}
117
118pre && version == "search" && $0 ~ /^ \* libpng version/{
119   version = substr($0, 4)
120   print "version =", version >out
121   next
122}
123
124pre && FILENAME == version_file{
125   next
126}
127
128# variable=value
129#   Sets the given variable to the given value (the syntax is fairly
130#   free form, except for deb (you are expected to understand how to
131#   set the debug variable...)
132#
133#   This happens before the check on 'pre' below skips most of the
134#   rest of the actions, so the variable settings happen during
135#   preprocessing but are recorded in the END action too.  This
136#   allows them to be set on the command line too.
137$0 ~ /^[ 	]*version[ 	]*=/{
138   sub(/^[  ]*version[  ]*=[  ]*/, "")
139   version = $0
140   next
141}
142$0 ~ /^[ 	]*everything[ 	=]*off[ 	]*$/{
143   everything = "off"
144   next
145}
146$0 ~ /^[ 	]*everything[ 	=]*on[ 	]*$/{
147   everything = "on"
148   next
149}
150$0 ~ /^[ 	]*logunsupported[ 	=]*0[ 	]*$/{
151   logunsupported = 0
152   next
153}
154$0 ~ /^[ 	]*logunsupported[ 	=]*1[ 	]*$/{
155   logunsupported = 1
156   next
157}
158$1 == "deb" && $2 == "=" && NF == 3{
159   deb = $3
160   next
161}
162
163# Preprocessing - this just copies the input file with lines
164# that need preprocessing (just chunk at present) expanded
165# The bare "pre" instead of "pre != 0" crashes under Sunos awk
166pre && $1 != "chunk"{
167   print >out
168   next
169}
170
171# The first characters of the line determine how it is processed,
172# leading spaces are ignored.  In general tokens that are not
173# keywords are the names of options.  An option 'name' is
174# controlled by the definition of the corresponding macros:
175#
176#   PNG_name_SUPPORTED    The option is turned on
177#   PNG_NO_name
178#   PNG_NO_name_SUPPORTED If the first macro is not defined
179#                         either of these will turn the option off
180#
181# If none of these macros are defined the option is turned on, unless
182# the keyword 'off' is given in a line relating to the option.  The
183# keyword 'on' can also be given, but it will be ignored (since it is
184# the default.)
185#
186# In the syntax below a 'name' is indicated by "NAME", other macro
187# values are indicated by "MACRO", as with "NAME" the leading "PNG_"
188# is omitted, but in this case the "NO_" prefix and the "_SUPPORTED"
189# suffix are never used.
190#
191# Each line is introduced by a keyword - the first non-space characters
192# on the line.  A line starting with a '#' is a comment - it is totally
193# ignored.  Keywords are as follows, a NAME, is simply a macro name
194# without the leading PNG_, PNG_NO_ or the trailing _SUPPORTED.
195
196$1 ~ /^#/ || $0 ~ /^[ 	]*$/{
197   next
198}
199
200# com <comment>
201#   The whole line is placed in the output file as a comment with
202#   the preceding 'com' removed
203$1 == "com"{
204   if (NF > 1) {
205      # sub(/^[ 	]*com[ 	]*/, "")
206      $1 = ""
207      print comment $0, cend >out
208   } else
209      print start end >out
210   next
211}
212
213# version
214#   Inserts a version comment
215$1 == "version" && NF == 1{
216   if (version == "") {
217      print "ERROR: no version string set"
218      err = 1 # prevent END{} running
219      exit 1
220   }
221
222   print comment, version, cend >out
223   next
224}
225
226# file output input protect
227#   Informational: the official name of the input file (without
228#   make generated local directories), the official name of the
229#   output file and, if required, a name to use in a protection
230#   macro for the contents.
231$1 == "file" && NF >= 2{
232   print comment, $2, cend >out
233   print comment, "Machine generated file: DO NOT EDIT", cend >out
234   if (NF >= 3)
235      print comment, "Derived from:", $3, cend >out
236   protect = $4
237   if (protect != "") {
238      print start "#ifndef", protect end >out
239      print start "#define", protect end >out
240   }
241   next
242}
243
244# option NAME ( (requires|enables|if) NAME* | on | off | disabled |
245#                sets SETTING VALUE+ )*
246#
247#   Declares an option 'NAME' and describes its default setting (disabled)
248#   and its relationship to other options.  The option is disabled
249#   unless *all* the options listed after 'requires' are set and at
250#   least one of the options listed after 'if' is set.  If the
251#   option is set then it turns on all the options listed after 'enables'.
252#
253#   Note that "enables" takes priority over the required/if/disabled/off
254#   setting of the target option.
255#
256#   The definition file may list an option as 'disabled': off by default,
257#   otherwise the option is enabled: on by default.  A later (and it must
258#   be later) entry may turn an option on or off explicitly.
259
260$1 == "option" && NF >= 2{
261   opt = $2
262   sub(/,$/,"",opt)
263   onoff = option[opt]  # records current (and the default is "", enabled)
264   key = ""
265   istart = 3
266   do {
267      if (istart == 1) {     # continuation line
268         val = getline
269
270         if (val != 1) { # error reading it
271            if (val == 0)
272               print "option", opt ": ERROR: missing continuation line"
273            else
274               print "option", opt ": ERROR: error reading continuation line"
275
276            # This is a hard error
277            err = 1 # prevent END{} running
278            exit 1
279         }
280      }
281
282      for (i=istart; i<=NF; ++i) {
283         val=$(i)
284         sub(/,$/,"",val)
285         if (val == "on" || val == "off" || val == "disabled" || val =="enabled") {
286            key = ""
287            if (onoff != val) {
288               # on or off can zap disabled or enabled:
289               if (onoff == "" || (onoff == "disabled" || onoff == "enabled") &&
290                   (val == "on" || val == "off")) {
291                  # It's easy to mis-spell the option when turning it
292                  # on or off, so warn about it here:
293                  if (onoff == "" && (val == "on" || val == "off")) {
294                     print "option", opt ": ERROR: turning unrecognized option", val
295                     # For the moment error out - it is safer
296                     err = 1 # prevent END{} running
297                     exit 1
298                  }
299                  onoff = val
300               } else {
301                  # Print a message, otherwise the error
302                  # below is incomprehensible
303                  print "option", opt ": currently", onoff ": attempt to turn", val
304                  break
305               }
306            }
307         } else if (val == "requires" || val == "if" || val == "enables" || val =="sets") {
308            key = val
309         } else if (key == "requires") {
310            requires[opt] = requires[opt] " " val
311         } else if (key == "if") {
312            iffs[opt] = iffs[opt] " " val
313         } else if (key == "enables") {
314            enabledby[val] = enabledby[val] " " opt
315         } else if (key == "sets") {
316            sets[opt] = sets[opt] " " val
317            key = "setval"
318            set = val
319         } else if (key == "setval") {
320            setval[opt " " set] = setval[opt " " set] " " val
321         } else
322            break # bad line format
323      }
324
325      istart = 1
326   } while (i > NF && $0 ~ /,$/)
327
328   if (i > NF) {
329      # Set the option, defaulting to 'enabled'
330      if (onoff == "") onoff = "enabled"
331      option[opt] = onoff
332      next
333   }
334   # Else fall through to the error handler
335}
336
337# chunk NAME [requires OPT] [enables LIST] [on|off|disabled]
338#   Expands to the 'option' settings appropriate to the reading and
339#   writing of an ancilliary PNG chunk 'NAME':
340#
341#   option READ_NAME requires READ_ANCILLARY_CHUNKS [READ_OPT]
342#   option READ_NAME enables NAME LIST
343#   [option READ_NAME off]
344#   option WRITE_NAME requires WRITE_ANCILLARY_CHUNKS [WRITE_OPT]
345#   option WRITE_NAME enables NAME LIST
346#   [option WRITE_NAME off]
347
348pre != 0 && $1 == "chunk" && NF >= 2{
349   # 'chunk' is handled on the first pass by writing appropriate
350   # 'option' lines into the intermediate file.
351   opt = $2
352   sub(/,$/,"",opt)
353   onoff = ""
354   reqread = ""
355   reqwrite = ""
356   enables = ""
357   req = 0
358   istart = 3
359   do {
360      if (istart == 1) {     # continuation line
361         val = getline
362
363         if (val != 1) { # error reading it
364            if (val == 0)
365               print "chunk", opt ": ERROR: missing continuation line"
366            else
367               print "chunk", opt ": ERROR: error reading continuation line"
368
369            # This is a hard error
370            err = 1 # prevent END{} running
371            exit 1
372         }
373      }
374
375      # read the keywords/additional OPTS
376      for (i=istart; i<=NF; ++i) {
377         val = $(i)
378         sub(/,$/,"",val)
379         if (val == "on" || val == "off" || val == "disabled") {
380            if (onoff != val) {
381               if (onoff == "")
382                  onoff = val
383               else
384                  break # on/off conflict
385            }
386            req = 0
387         } else if (val == "requires")
388            req = 1
389         else if (val == "enables")
390            req = 2
391         else if (req == 1){
392            reqread = reqread " READ_" val
393            reqwrite = reqwrite " WRITE_" val
394         } else if (req == 2)
395            enables = enables " " val
396         else
397            break # bad line: handled below
398      }
399
400      istart = 1
401   } while (i > NF && $0 ~ /,$/)
402
403   if (i > NF) {
404      # Output new 'option' lines to the intermediate file (out)
405      print "option READ_" opt, "requires READ_ANCILLARY_CHUNKS" reqread, "enables", opt enables , onoff >out
406      print "option WRITE_" opt, "requires WRITE_ANCILLARY_CHUNKS" reqwrite, "enables", opt enables, onoff >out
407      next
408   }
409   # Else hit the error handler below - bad line format!
410}
411
412# setting MACRO ( requires MACRO* )* [ default VALUE ]
413#   Behaves in a similar way to 'option' without looking for NO_ or
414#   _SUPPORTED; the macro is enabled if it is defined so long as all
415#   the 'requires' macros are also defined.  The definitions may be
416#   empty, an error will be issued if the 'requires' macros are
417#   *not* defined.  If given the 'default' value is used if the
418#   macro is not defined.  The default value will be re-tokenised.
419#   (BTW: this is somewhat restrictive, it mainly exists for the
420#   support of non-standard configurations and numeric parameters,
421#   see the uses in scripts/options.dat
422
423$1 == "setting" && (NF == 2 || NF >= 3 && ($3 == "requires" || $3 == "default")){
424   reqs = ""
425   deflt = ""
426   isdef = 0
427   key = ""
428   for (i=3; i<=NF; ++i)
429      if ($(i) == "requires" || $(i) == "default") {
430         key = $(i)
431         if (key == "default") isdef = 1
432      } else if (key == "requires")
433         reqs = reqs " " $(i)
434      else if (key == "default")
435         deflt = deflt " " $(i)
436      else
437         break # Format error, handled below
438
439   setting[$2] = reqs
440   # NOTE: this overwrites a previous value silently
441   if (isdef && deflt == "")
442      deflt = " " # as a flag to force output
443   defaults[$2] = deflt
444   next
445}
446
447# The order of the dependency lines (option, chunk, setting) is irrelevant
448# - the 'enables', 'requires' and 'if' settings will be used to determine
449# the correct order in the output and the final values in pnglibconf.h are
450# not order dependent.  'requires' and 'if' entries take precedence over
451# 'enables' from other options; if an option requires another option it
452# won't be set regardless of any options that enable it unless the other
453# option is also enabled.
454#
455# Similarly 'enables' trumps a NO_ definition in CFLAGS or pngusr.h
456#
457# For simplicity cycles in the definitions are regarded as errors,
458# even if they are not ambiguous.
459# A given NAME can be specified in as many 'option' lines as required, the
460# definitions are additive.
461
462# For backwards compatibility equivalent macros may be listed thus:
463#
464# = [NO_]NAME MACRO
465#   Makes -DMACRO equivalent to -DPNG_NO_NAME or -DPNG_NAME_SUPPORTED
466#   as appropriate.
467#
468# The definition is injected into the C compiler input when encountered
469# in the second pass (so all these definitions appear *after* the @
470# lines!)
471#
472# 'NAME' is as above, but 'MACRO' is the full text of the equivalent
473# old, deprecated, macro.
474
475$1 == "=" && NF == 3{
476   print "#ifdef PNG_" $3 >out
477   if ($2 ~ /^NO_/)
478      print "#   define PNG_" $2 >out
479   else
480      print "#   define PNG_" $2 "_SUPPORTED" >out
481   print "#endif" >out
482   next
483}
484
485# Lines may be injected into the C compiler input by preceding them
486# with an "@" character.  The line is copied with just the leading
487# @ removed.
488
489$1 ~ /^@/{
490   # sub(/^[ 	]*@/, "")
491   $1 = substr($1, 2)
492   print >out
493   next
494}
495
496# Check for unrecognized lines, because of the preprocessing chunk
497# format errors will be detected on the first pass independent of
498# any other format errors.
499{
500   print "options.awk: bad line (" NR "):", $0
501   err = 1 # prevent END{} running
502   exit 1
503}
504
505# For checking purposes names that start with "ok_" or "fail_" are
506# not output to pnglibconf.h and must be either enabled or disabled
507# respectively for the build to succeed.  This allows interdependencies
508# between options of the form "at least one of" or "at most one of"
509# to be checked.  For example:
510#
511# option FLOATING_POINT enables ok_math
512# option FIXED_POINT enables ok_math
513#   This ensures that at least one of FLOATING_POINT and FIXED_POINT
514#   must be set for the build to succeed.
515#
516# option fail_math requires FLOATING_POINT FIXED_POINT
517#   This means the build will fail if *both* FLOATING_POINT and
518#   FIXED_POINT are set (this is an example; in fact both are allowed.)
519#
520# If all these options were given the build would require exactly one
521# of the names to be enabled.
522
523END{
524   # END{} gets run on an exit (a traditional awk feature)
525   if (err) exit 1
526
527   if (pre) {
528      # Record the final value of the variables
529      print "deb =", deb >out
530      if (everything != "") {
531         print "everything =", everything >out
532      }
533      print "logunsupported =", logunsupported >out
534      exit 0
535   }
536
537   # Do the options first (allowing options to set settings).  The dependency
538   # tree is thus:
539   #
540   #   name     >     name
541   #   name requires  name
542   #   name if        name
543   #   name enabledby name
544   #
545   # First build a list 'tree' by option of all the things on which
546   # it depends.
547   print "" >out
548   print "/* OPTIONS */" >out
549   print comment, "options", cend >out
550   for (opt in enabledby) tree[opt] = 1  # may not be explicit options
551   for (opt in option) if (opt != "") {
552      o = option[opt]
553      # option should always be one of the following values
554      if (o != "on" && o != "off" && o != "disabled" && o != "enabled") {
555         print "internal option error (" o ")"
556         exit 1
557      }
558      tree[opt] = ""   # so unlisted options marked
559   }
560   for (opt in tree) if (opt != "") {
561      if (tree[opt] == 1) {
562         tree[opt] = ""
563         if (option[opt] != "") {
564            print "internal error (1)"
565            exit 1
566         }
567         # Macros only listed in 'enables' remain off unless
568         # one of the enabling macros is on.
569         option[opt] = "disabled"
570      }
571
572      split("", list) # clear 'list'
573      # Now add every requires, iffs or enabledby entry to 'list'
574      # so that we can add a unique list of requirements to tree[i]
575      split(requires[opt] iffs[opt] enabledby[opt], r)
576      for (i in r) list[r[i]] = 1
577      for (i in list) tree[opt] = tree[opt] " " i
578   }
579
580   # print the tree for extreme debugging
581   if (deb > 2) for (i in tree) if (i != "") print i, "depends-on" tree[i]
582
583   # Ok, now check all options marked explicitly 'on' or 'off':
584   #
585   # If an option[opt] is 'on' then turn on all requires[opt]
586   # If an option[opt] is 'off' then turn off all enabledby[opt]
587   #
588   # Error out if we have to turn 'on' to an 'off' option or vice versa.
589   npending = 0
590   for (opt in option) if (opt != "") {
591      if (option[opt] == "on" || option[opt] == "off") {
592         pending[++npending] = opt
593      }
594   }
595
596   err = 0 # set on error
597   while (npending > 0) {
598      opt = pending[npending--]
599      if (option[opt] == "on") {
600         nreqs = split(requires[opt], r)
601         for (j=1; j<=nreqs; ++j) {
602            if (option[r[j]] == "off") {
603               print "option", opt, "turned on, but requirement", r[j], "is turned off"
604               err = 1
605            } else if (option[r[j]] != "on") {
606               option[r[j]] = "on"
607               pending[++npending] = r[j]
608            }
609         }
610      } else {
611         if (option[opt] != "off") {
612            print "internal error (2)"
613            exit 1
614         }
615         nreqs = split(enabledby[opt], r)
616         for (j=1; j<=nreqs; ++j) {
617            if (option[r[j]] == "on") {
618               print "option", opt, "turned off, but enabled by", r[j], "which is turned on"
619               err = 1
620            } else if (option[r[j]] != "off") {
621               option[r[j]] = "off"
622               pending[++npending] = r[j]
623            }
624         }
625      }
626   }
627   if (err) exit 1
628
629   # Sort options:
630   print "PNG_DFN_START_SORT 2" >out
631
632   # option[i] is now the complete list of all the tokens we may
633   # need to output, go through it as above, depth first.
634   finished = 0
635   while (!finished) {
636      finished = 1
637      movement = 0 # done nothing
638      for (i in option) if (!done[i]) {
639         nreqs = split(tree[i], r)
640         if (nreqs > 0) {
641            for (j=1; j<=nreqs; ++j) if (!done[r[j]]) {
642               break
643            }
644            if (j<=nreqs) {
645               finished = 0
646               continue  # next option
647            }
648         }
649
650         # All the requirements have been processed, output
651         # this option.  An option is _SUPPORTED if:
652         #
653         # all 'requires' are _SUPPORTED AND
654         # at least one of the 'if' options are _SUPPORTED AND
655         # EITHER:
656         #   The name is _SUPPORTED (on the command line)
657         # OR:
658         #   an 'enabledby' is _SUPPORTED
659         # OR:
660         #   NO_name is not defined AND
661         #   the option is not disabled; an option is disabled if:
662         #    option == off
663         #    option == disabled && everything != on
664         #    option == "" && everything == off
665         if (deb) print "option", i
666         print "" >out
667         print "/* option:", i, option[i] >out
668         print " *   requires:  " requires[i] >out
669         print " *   if:        " iffs[i] >out
670         print " *   enabled-by:" enabledby[i] >out
671         print " *   sets:      " sets[i], "*/" >out
672         print "#undef PNG_on" >out
673         print "#define PNG_on 1" >out
674
675         # requires
676         nreqs = split(requires[i], r)
677         for (j=1; j<=nreqs; ++j) {
678            print "#ifndef PNG_" r[j] "_SUPPORTED" >out
679            print "#   undef PNG_on /*!" r[j] "*/" >out
680            # This error appears in the final output if something
681            # was switched 'on' but the processing above to force
682            # the requires did not work
683            if (option[i] == "on") {
684               print error, i, "requires", r[j] end >out
685            }
686            print "#endif" >out
687         }
688
689         # if
690         have_ifs = 0
691         nreqs = split(iffs[i], r)
692         print "#undef PNG_no_if" >out
693         if (nreqs > 0) {
694            have_ifs = 1
695            print "/* if" iffs[i], "*/" >out
696            print "#define PNG_no_if 1" >out
697            for (j=1; j<=nreqs; ++j) {
698               print "#ifdef PNG_" r[j] "_SUPPORTED" >out
699               print "#   undef PNG_no_if /*" r[j] "*/" >out
700               print "#endif" >out
701            }
702            print "#ifdef PNG_no_if /*missing if*/" >out
703            print "#   undef PNG_on" >out
704            # There is no checking above for this, because we
705            # don't know which 'if' to choose, so whine about
706            # it here:
707            if (option[i] == "on") {
708               print error, i, "needs one of:", iffs[i] end >out
709            }
710            print "#endif" >out
711         }
712
713         print "#ifdef PNG_on /*requires, if*/" >out
714         # enables
715         print "#   undef PNG_not_enabled" >out
716         print "#   define PNG_not_enabled 1" >out
717         print "   /* enabled by" enabledby[i], "*/" >out
718         nreqs = split(enabledby[i], r)
719         for (j=1; j<=nreqs; ++j) {
720            print "#ifdef PNG_" r[j] "_SUPPORTED" >out
721            print "#   undef PNG_not_enabled /*" r[j] "*/" >out
722            # Oops, probably not intended (should be factored
723            # out by the checks above).
724            if (option[i] == "off") {
725               print error, i, "enabled by:", r[j] end >out
726            }
727            print "#endif" >out
728         }
729
730         print "#   ifndef PNG_" i "_SUPPORTED /*!command line*/" >out
731         print "#    ifdef PNG_not_enabled /*!enabled*/" >out
732         # 'have_ifs' here means that everything = "off" still allows an 'if' on
733         # an otherwise enabled option to turn it on; otherwise the 'if'
734         # handling is effectively disabled by 'everything = off'
735         if (option[i] == "off" || option[i] == "disabled" && everything != "on" || option[i] == "enabled" && everything == "off" && !have_ifs) {
736            print "#      undef PNG_on /*default off*/" >out
737         } else {
738            print "#      ifdef PNG_NO_" i >out
739            print "#       undef PNG_on /*turned off*/" >out
740            print "#      endif" >out
741            print "#      ifdef PNG_NO_" i "_SUPPORTED" >out
742            print "#       undef PNG_on /*turned off*/" >out
743            print "#      endif" >out
744         }
745         print "#    endif /*!enabled*/" >out
746         print "#    ifdef PNG_on" >out
747         # The _SUPPORTED macro must be defined so that dependent
748         # options output later work.
749         print "#      define PNG_" i "_SUPPORTED" >out
750         print "#    endif" >out
751         print "#   endif /*!command line*/" >out
752         # If PNG_on is still set the option should be defined in
753         # pnglibconf.h
754         print "#   ifdef PNG_on" >out
755         if (i ~ /^fail_/) {
756            print error, i, "is on: enabled by:" iffs[i] enabledby[i] ", requires" requires[i] end >out
757         } else if (i !~ /^ok_/) {
758            print def i sup >out
759            # Supported option, set required settings
760            nreqs = split(sets[i], r)
761            for (j=1; j<=nreqs; ++j) {
762               print "#    ifdef PNG_set_" r[j] >out
763               # Some other option has already set a value:
764               print error, i, "sets", r[j] ": duplicate setting" end >out
765               print error, "   previous value: " end "PNG_set_" r[j] >out
766               print "#    else" >out
767               # Else set the default: note that this won't accept arbitrary
768               # values, the setval string must be acceptable to all the C
769               # compilers we use.  That means it must be VERY simple; a number,
770               # a name or a string.
771               print "#     define PNG_set_" r[j], setval[i " " r[j]] >out
772               print "#    endif" >out
773            }
774         }
775         print "#   endif /* definition */" >out
776         print "#endif /*requires, if*/" >out
777         if (logunsupported || i ~ /^ok_/) {
778            print "#ifndef  PNG_on" >out
779            if (logunsupported) {
780               print und i une >out
781            }
782            if (i ~ /^ok_/) {
783               print error, i, "not enabled: requires:" requires[i] ", enabled by:" iffs[i] enabledby[i] end >out
784            }
785            print "#endif" >out
786         }
787
788         done[i] = 1
789         ++movement
790      }
791
792      if (!finished && !movement) {
793         print "option: loop or missing option in dependency tree, cannot process:"
794         for (i in option) if (!done[i]) {
795            print "  option", i, "depends on" tree[i], "needs:"
796            nreqs = split(tree[i], r)
797            if (nreqs > 0) for (j=1; j<=nreqs; ++j) if (!done[r[j]]) {
798               print "   " r[j]
799            }
800         }
801         exit 1
802      }
803   }
804   print "PNG_DFN_END_SORT" >out
805   print comment, "end of options", cend >out
806
807   # Do the 'setting' values second, the algorithm the standard
808   # tree walk (O(1)) done in an O(2) while/for loop; interations
809   # settings x depth, outputing the deepest required macros
810   # first.
811   print "" >out
812   print "/* SETTINGS */" >out
813   print comment, "settings", cend >out
814   # Sort (in dfn.awk) on field 2, the setting name
815   print "PNG_DFN_START_SORT 2" >out
816   finished = 0
817   while (!finished) {
818      finished = 1
819      movement = 0 # done nothing
820      for (i in setting) if (!doneset[i]) {
821         nreqs = split(setting[i], r)
822         if (nreqs > 0) {
823            # By default assume the requires values are options, but if there
824            # is no option with that name check for a setting
825            for (j=1; j<=nreqs; ++j) if (option[r[j]] == "" && !doneset[r[j]]) {
826               break
827            }
828            if (j<=nreqs) {
829               finished = 0
830               continue # try a different setting
831            }
832         }
833
834         # All the requirements have been processed, output
835         # this setting.
836         if (deb) print "setting", i
837         deflt = defaults[i]
838         # Remove any spurious trailing spaces
839         sub(/ *$/,"",deflt)
840         # A leading @ means leave it unquoted so the preprocessor
841         # can substitute the build time value
842         if (deflt ~ /^ @/)
843            deflt = " " subs substr(deflt, 3) sube
844         print "" >out
845         print "/* setting: ", i >out
846         print " *   requires:" setting[i] >out
847         print " *   default: ", defaults[i] deflt, "*/" >out
848         for (j=1; j<=nreqs; ++j) {
849            if (option[r[j]] != "")
850               print "#ifndef PNG_" r[j] "_SUPPORTED" >out
851            else
852               print "#ifndef PNG_" r[j] >out
853            print error, i, "requires", r[j] end >out
854            print "# endif" >out
855         }
856         # The precedence is:
857         #
858         #  1) External definition; trumps:
859         #  2) Option 'sets' value; trumps:
860         #  3) Setting 'default'
861         #
862         print "#ifdef PNG_" i >out
863         # PNG_<i> is defined, so substitute the value:
864         print def i, subs "PNG_" i sube end >out
865         print "#else /* use default */" >out
866         print "# ifdef PNG_set_" i >out
867         # Value from an option 'sets' argument
868         print def i, subs "PNG_set_" i sube end >out
869         # This is so that subsequent tests on the setting work:
870         print "#  define PNG_" i, "1" >out
871         if (defaults[i] != "") {
872            print "# else /*default*/" >out
873            print def i deflt end >out
874            print "#  define PNG_" i, "1" >out
875         }
876         print "# endif /* defaults */" >out
877         print "#endif /* setting", i, "*/" >out
878
879         doneset[i] = 1
880         ++movement
881      }
882
883      if (!finished && !movement) {
884         print "setting: loop or missing setting in 'requires', cannot process:"
885         for (i in setting) if (!doneset[i]) {
886            print "  setting", i, "requires" setting[i]
887         }
888         exit 1
889      }
890   }
891   print "PNG_DFN_END_SORT" >out
892   print comment, "end of settings", cend >out
893
894   # Regular end - everything looks ok
895   if (protect != "") {
896      print start "#endif", "/*", protect, "*/" end >out
897   }
898}
899