home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / GNU / GPTX01AS.ZIP / VERSION.AWK < prev    next >
Encoding:
Text File  |  1990-07-04  |  3.1 KB  |  101 lines
  1. # Augment the installation number in the version string.
  2. # Copyright (C) 1990 Free Software Foundation, Inc.
  3. # Francois Pinard <pinard@iro.umontreal.ca>, March 1990.
  4.  
  5.  
  6. # PURPOSE OF THIS SCRIPT.
  7. #  
  8. # The script reads its input and copies it verbatim, except for one line
  9. # line which, usually, looks like:
  10. # 
  11. #    #define VERSION "I.J.K"
  12. # 
  13. # where I, J and K are decimal numbers.  The third number will have
  14. # its value bumped up by one before the copy.  This special line can
  15. # also look like:
  16. #
  17. #    #define VERSION "I.J"
  18. #    #define VERSION "I"
  19. #    #define VERSION ""
  20. # 
  21. # Missing numbers, if any, are assumed to have the value zero, before
  22. # the bumping.  After the bumping, all three numbers will show.
  23. #
  24. #
  25. # MORE ABOUT THE VERSION STRING.
  26. # 
  27. # The version is a string containing three numbers separated by two
  28. # periods.  The first number indicates the major revision, the second
  29. # number indicates the minor revision, and the third number indicates
  30. # the installation number.  The first two numbers pertain to the
  31. # distributor, while the third pertains to the local installator.
  32. # This third number usually counts the number of times the package has
  33. # been locally re-installed to be made accessible to the users.
  34. # 
  35. # Interim modifications to a package which does not lead to a user
  36. # installation are considered experimental and, then, not worth a
  37. # change in the installation number.  It is mostly when a package is
  38. # made available to users that some feedback is expected, so the
  39. # installation number changes should be delayed until then.
  40. #
  41. #
  42. # INTERACTION WITH THE MAKEFILE.
  43. # 
  44. # A nice way to use this is to keep some `version.c' file in the
  45. # project containing such a #define, and to modify the install goal in
  46. # the Makefile.  Suppose the install goal was:
  47. #
  48. #    install: $(PROGRAMS)
  49. #        $(INSTALL) $(PROGRAMS) $(BINDIR)
  50. #
  51. # Then, modify it so it looks like this:
  52. #
  53. #    install: $(PROGRAMS)
  54. #        $(INSTALL) $(PROGRAMS) $(BINDIR)
  55. #        gawk -f version.awk version.c >newversion.c
  56. #        @mv version.c version.c~
  57. #        @mv newversion.c version.c
  58. # 
  59. # Given this provision, at each `make install' or `make -k install',
  60. # the local installation number will be bumped after the install,
  61. # but only if it was successful.  So, all local experimentation will
  62. # use this new version number, until another install is done.  Right
  63. # *after* the next install, the installation number will be bumped
  64. # again, and so on.
  65.  
  66.  
  67. # Look for the #define VERSION line.
  68.  
  69. /^[ \t]*#[ \t]*define[ \t][ \t]*VERSION[ \t][ \t]*"[^"]*"/ {
  70.  
  71.   # Split the version into numbers.
  72.  
  73.   match ($0, /"[^"]*"/)
  74.   version = substr ($0, RSTART + 1, RLENGTH - 2)
  75.   number = split (version, numbers, ".")
  76.  
  77.   # Insure three numbers, defaulting to 0.0.0; then bump the third up.
  78.  
  79.   if (number < 1) {
  80.     numbers[1] = "0"
  81.   }
  82.   if (number < 2) {
  83.     numbers[2] = "0"
  84.   }
  85.   if (number < 3) {
  86.     numbers[3] = "0"
  87.   }
  88.   numbers[3]++
  89.  
  90.   # Replace the new version numbers in the #define and write it out.
  91.  
  92.   sub (/"[^"]*"/, "\"" numbers[1] "." numbers[2] "." numbers[3] "\"", $0)
  93.   print
  94.   next
  95. }
  96.  
  97.  
  98. # Copy all other lines without change.
  99.  
  100. //
  101.