Remove building with NOCRYPTO option
[minix3.git] / usr.bin / m4 / TEST / test.m4
blob5b198073aa8c6ded4a639b1ca50e9956fd4bbf04
1 #       $NetBSD: test.m4,v 1.4 1995/09/28 05:38:05 tls Exp $
3 # Copyright (c) 1989, 1993
4 #       The Regents of the University of California.  All rights reserved.
6 # This code is derived from software contributed to Berkeley by
7 # Ozan Yigit.
9 # Redistribution and use in source and binary forms, with or without
10 # modification, are permitted provided that the following conditions
11 # are met:
12 # 1. Redistributions of source code must retain the above copyright
13 #    notice, this list of conditions and the following disclaimer.
14 # 2. Redistributions in binary form must reproduce the above copyright
15 #    notice, this list of conditions and the following disclaimer in the
16 #    documentation and/or other materials provided with the distribution.
17 # 3. All advertising materials mentioning features or use of this software
18 #    must display the following acknowledgement:
19 #       This product includes software developed by the University of
20 #       California, Berkeley and its contributors.
21 # 4. Neither the name of the University nor the names of its contributors
22 #    may be used to endorse or promote products derived from this software
23 #    without specific prior written permission.
25 # THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
26 # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28 # ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
29 # FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30 # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31 # OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32 # HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33 # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34 # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35 # SUCH DAMAGE.
37 #       @(#)test.m4     8.1 (Berkeley) 6/6/93
40 # test file for mp (not comprehensive)
42 # v7 m4 does not have `decr'.
44 define(DECR,`eval($1-1)')
46 # include string macros
48 include(string.m4)
50 # create some fortrash strings for an even uglier language
52 string(TEXT, "text")
53 string(DATA, "data")
54 string(BEGIN, "begin")
55 string(END, "end")
56 string(IF, "if")
57 string(THEN, "then")
58 string(ELSE, "else")
59 string(CASE, "case")
60 string(REPEAT, "repeat")
61 string(WHILE, "while")
62 string(DEFAULT, "default")
63 string(UNTIL, "until")
64 string(FUNCTION, "function")
65 string(PROCEDURE, "procedure")
66 string(EXTERNAL, "external")
67 string(FORWARD, "forward")
68 string(TYPE, "type")
69 string(VAR, "var")
70 string(CONST, "const")
71 string(PROGRAM, "program")
72 string(INPUT, "input")
73 string(OUTPUT, "output")
75 divert(2)
76 diversion #1
77 divert(3)
78 diversion #2
79 divert(4)
80 diversion #3
81 divert(5)
82 diversion #4
83 divert(0)
84 define(abc,xxx)
85 ifdef(`abc',defined,undefined)
87 # v7 m4 does this wrong. The right output is 
88 #       this is A vEry lon sEntEnCE
89 # see m4 documentation for translit.
91 translit(`this is a very long sentence', abcdefg, ABCDEF)
93 # include towers-of-hanoi
95 include(hanoi.m4)
97 # some reasonable set of disks
99 hanoi(6)
101 # include ackermann's function
103 include(ack.m4)
105 # something like (3,3) will blow away un*x m4.
107 ack(2,3)
109 # include a square_root function for fixed nums
111 include(sqroot.m4)
113 # some square roots.
115 square_root(15)
116 square_root(100)
117 square_root(-4)
118 square_root(21372)
120 # some textual material for enjoyment.
122 [taken from the 'Clemson University Computer Newsletter',
123  September 1981, pp. 6-7]
124      
125 I am a wizard in the magical Kingdom of Transformation and I
126 slay dragons for a living.  Actually, I am a systems programmer.
127 One of the problems with systems programming is explaining to
128 non-computer enthusiasts what that is.  All of the terms I use to
129 describe my job are totally meaningless to them.  Usually my response
130 to questions about my work is to say as little as possible.  For
131 instance, if someone asks what happened at work this week, I say
132 "Nothing much" and then I change the subject.
133      
134 With the assistance of my brother, a mechanical engineer, I have devised
135 an analogy that everyone can understand.  The analogy describes the
136 "Kingdom of Transformation" where travelers wander and are magically
137 transformed.  This kingdom is the computer and the travelers are information.
138 The purpose of the computer is to change information to a more meaningful
139 forma.  The law of conservation applies here:  The computer never creates
140 and never intentionally destroys data.  With no further ado, let us travel
141 to the Kingdom of Transformation:
142      
143 In a land far, far away, there is a magical kingdom called the Kingdom of
144 Transformation.  A king rules over this land and employs a Council of
145 Wizardry.  The main purpose of this kingdom is to provide a way for
146 neighboring kingdoms to transform citizens into more useful citizens.  This
147 is done by allowing the citizens to enter the kingdom at one of its ports
148 and to travel any of the many routes in the kingdom.  They are magically
149 transformed along the way.  The income of the Kingdom of Transformation
150 comes from the many toll roads within its boundaries.
151      
152 The Kingdom of Transformation was created when several kingdoms got
153 together and discovered a mutual need for new talents and abilities for
154 citizens.  They employed CTK, Inc. (Creators of Transformation, Inc.) to
155 create this kingdom.  CTK designed the country, its transportation routes,
156 and its laws of transformation, and created the major highway system.
157      
158 Hazards
159 =======
160      
161 Because magic is not truly controllable, CTK invariably, but unknowingly,
162 creates dragons.  Dragons are huge fire-breathing beasts which sometimes
163 injure or kill travelers.  Fortunately, they do not travel, but always
164 remain near their den.
165      
166 Other hazards also exist which are potentially harmful.  As the roads
167 become older and more weatherbeaten, pot-holes will develop, trees will
168 fall on travelers, etc.  CTK maintenance men are called to fix these
169 problems.
170      
171 Wizards
172 =======
173      
174 The wizards play a major role in creating and maintaining the kingdom but
175 get little credit for their work because it is performed secretly.  The
176 wizards do not wan the workers or travelers to learn their incantations
177 because many laws would be broken and chaos would result.
178      
179 CTK's grand design is always general enough to be applicable in many
180 different situations.  As a result, it is often difficult to use.  The
181 first duty of the wizards is to tailor the transformation laws so as to be
182 more beneficial and easier to use in their particular environment.
183      
184 After creation of the kingdom, a major duty of the wizards is to search for
185 and kill dragons.  If travelers do not return on time or if they return
186 injured, the ruler of the country contacts the wizards.  If the wizards
187 determine that the injury or death occurred due to the traveler's
188 negligence, they provide the traveler's country with additional warnings.
189 If not, they must determine if the cause was a road hazard or a dragon.  If
190 the suspect a road hazard, they call in a CTK maintenance man to locate the
191 hazard and to eliminate it, as in repairing the pothole in the road.  If
192 they think that cause was a dragon, then they must find and slay it.
193      
194 The most difficult part of eliminating a dragon is finding it.  Sometimes
195 the wizard magically knows where the dragon's lair it, but often the wizard
196 must send another traveler along the same route and watch to see where he
197 disappears.  This sounds like a failsafe method for finding dragons (and a
198 suicide mission for thr traveler) but the second traveler does not always
199 disappear.  Some dragons eat any traveler who comes too close; others are
200 very picky.
201      
202 The wizards may call in CTK who designed the highway system and
203 transformation laws to help devise a way to locate the dragon.  CTK also
204 helps provide the right spell or incantation to slay the dragon. (There is
205 no general spell to slay dragons; each dragon must be eliminated with a
206 different spell.)
207      
208 Because neither CTK nor wizards are perfect, spells to not always work
209 correctly.  At best, nothing happens when the wrong spell is uttered.  At
210 worst, the dragon becomes a much larger dragon or multiplies into several
211 smaller ones.  In either case, new spells must be found.
212      
213 If all existing dragons are quiet (i.e. have eaten sufficiently), wizards
214 have time to do other things.  They hide in castles and practice spells and
215 incatations.  They also devise shortcuts for travelers and new laws of
216 transformation.
217      
218 Changes in the Kingdom
219 ======================
220      
221 As new transformation kingdoms are created and old ones are maintained,
222 CTK, Inc. is constantly learning new things.  It learns ways to avoid
223 creating some of the dragons that they have previously created.  It also
224 discovers new and better laws of transformation.  As a result, CTK will
225 periodically create a new grand design which is far better than the old.
226 The wizards determine when is a good time to implement this new design.
227 This is when the tourist season is slow or when no important travelers
228 (VIPs) are to arrive.  The kingdom must be closed for the actual
229 implementation and is leter reopened as a new and better place to go.
230      
231 A final question you might ask is what happens when the number of tourists
232 becomes too great for the kingdom to handle in a reasonable period of time
233 (i.e., the tourist lines at the ports are too long).  The Kingdom of
234 Transformation has three options: (1) shorten the paths that a tourist must
235 travel, or (2) convince CTK to develop a faster breed of horses so that the
236 travelers can finish sooner, or (3) annex more territories so that the
237 kingdom can handle more travelers.
238      
239 Thus ends the story of the Kingdom of Transformation.  I hope this has
240 explained my job to you:  I slay dragons for a living.
243 #should do an automatic undivert..