Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

bug15216

  • Loading branch information...
commit 26eab6fa24447eaf39c84a9e13ff153aa1555151 1 parent 3d5e7a2
authored December 13, 2005

Showing 1 changed file with 23 additions and 24 deletions. Show diff stats Hide diff stats

  1. 47  webactions/doc/webactions.html
47  webactions/doc/webactions.html
@@ -162,7 +162,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
162 162
 
163 163
 <br>
164 164
 
165  
-<pre>You are using this browser: Netscape 4.01<br>How do you like it?</pre>
  165
+<pre>You are using this browser: Firefox 1.5<br>How do you like it?</pre>
166 166
 
167 167
 <br>
168 168
 
@@ -185,8 +185,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
185 185
 This clp file fragment checks to see if the session state has a
186 186
 variable
187 187
 named winner defined and if it does it includes the appropriate text.
188  
-&nbsp;If winner is not defined then<br>
189  
-
  188
+&nbsp;If winner is not defined then
190 189
 it includes the loser message. &nbsp; &nbsp;The clp_ifdef and
191 190
 clp_ifndef
192 191
 functions are supplied with AllegroServe.<br>
@@ -228,7 +227,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
228 227
 &nbsp;
229 228
 The parser may encounter a clp tag referencing a clp function that's
230 229
 not
231  
-yet defined (in Lisp we don't require that function be defined before
  230
+yet defined (in Lisp we don't require that a function be defined before
232 231
 we'll recognize a call to that function). &nbsp; The problem then is
233 232
 determining whether a given tag in the file is a call to a clp function
234 233
 or
@@ -286,7 +285,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
286 285
 &nbsp;A clp function is not supposed to examine the value of <span style="font-weight: bold;">body. &nbsp;</span>It should do one of two
287 286
 things with <span style="font-weight: bold;">body</span>. &nbsp;It can
288 287
 just ignore the value in which case the text and calls to clp
289  
-functions&nbsp; between the start and end tags is ignored and not sent
  288
+functions&nbsp; between the start and end tags are ignored and not sent
290 289
 as part of the response to the web browser. &nbsp; Alternatively it can
291 290
 cause the <span style="font-weight: bold;">body</span> to be sent back
292 291
 as part of the response by calling <span style="font-weight: bold;">(emit-clp-entity
@@ -358,7 +357,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
358 357
 <ol>
359 358
 
360 359
   <li>Model - this is the &nbsp;code that implements the data objects
361  
-being manipulated by users of the web site. &nbsp;In a online store the
  360
+being manipulated by users of the web site. &nbsp;In an online store the
362 361
 model includes the notions of a shopping cart and orders and so on.
363 362
 &nbsp; &nbsp;This is the code that must be written specifically for the
364 363
 objects being modeled.</li>
@@ -433,7 +432,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
433 432
 <span style="font-weight: bold;">clp-suffixes</span> - &nbsp;a list of
434 433
 strings naming the suffixes of files, which if found inside the
435 434
 project,
436  
-are assume to be clp files. &nbsp; By default the value of clp-suffixes
  435
+are assumed to be clp files. &nbsp; By default the value of clp-suffixes
437 436
 is a list of the string "clp". &nbsp; You may wish to add "htm" or
438 437
 "html" to this list if you want those files to be parsed as clp files
439 438
 when referenced inside this project.<br>
@@ -482,7 +481,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
482 481
 for the session-lifetime.&nbsp;&nbsp; If this function returns a
483 482
 non-nil value then the session will <span style="font-style: italic;">not</span>
484 483
 be reaped and instead the session will be treated as if it was just
485  
-reference and thus it wil be kept alive for another
  484
+reference and thus it will be kept alive for another
486 485
 session-lifetime.&nbsp;&nbsp; One common use for this function is to
487 486
 deallocate objects associated with the session that won't be recovered
488 487
 by the Lisp garbage collector when the session is garbage collected.<br>
@@ -604,9 +603,9 @@ <h1 style="text-align: center;">Allegro Webactions<br>
604 603
 
605 604
 <br>
606 605
 
607  
-In our psuedo-bnf, the '*' means zero or more occurances.&nbsp; The
  606
+In our psuedo-bnf, the '*' means zero or more occurrences.&nbsp; The
608 607
 square brackets mean
609  
-zero or one occurance.<br>
  608
+zero or one occurrence.<br>
610 609
 
611 610
 <br>
612 611
 
@@ -618,7 +617,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
618 617
 <br>
619 618
 
620 619
 An action function may modify the Model behind the website and then it
621  
-returns either&nbsp; a string naming a symbolic page name, as string
  620
+returns either&nbsp; a string naming a symbolic page name, as a string
622 621
 naming a file to send back to the browser,&nbsp; or the keyword symbol<span style="font-weight: bold;"> :continue</span> meaning go on to the next
623 622
 item in the map entry.<br>
624 623
 
@@ -969,7 +968,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
969 968
 Prefix map entries are the last ones considered when Webactions looks
970 969
 for a map entry to handle a symbolic page name.&nbsp; Webactions first
971 970
 looks for a specific symbolic page name entry.&nbsp;&nbsp;&nbsp; Then
972  
-Webactions see if the symbolic page name names an actual file in the
  971
+Webactions sees if the symbolic page name names an actual file in the
973 972
 project directory.&nbsp; And finally if those first two searches fail
974 973
 to find a map entry, Webactions looks for a prefix entry.<br>
975 974
 
@@ -990,7 +989,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
990 989
 
991 990
 <br>
992 991
 
993  
-then this this url<br>
  992
+then this url<br>
994 993
 
995 994
 <br>
996 995
 
@@ -1018,7 +1017,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1018 1017
 <br>
1019 1018
 
1020 1019
 We'll show two important uses for prefix map entries.&nbsp; The first
1021  
-is that you can catch references to non-existent symbolic pages names
  1020
+is that you can catch references to non-existent symbolic page names
1022 1021
 and return a nicer error message than the standard one AllegroServe
1023 1022
 returns.&nbsp;&nbsp; The map entry<br>
1024 1023
 
@@ -1027,7 +1026,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1027 1026
 <span style="font-family: monospace;">("" handle-undefined-page
1028 1027
 (:prefix t))<br>
1029 1028
 <br>
1030  
-</span>will catch all symbolic pages references that don't have a
  1029
+</span>will catch all symbolic page references that don't have a
1031 1030
 handler.&nbsp; You'll want to list this entry before any other prefix
1032 1031
 entry in the map since you want this entry to be checked last.<br>
1033 1032
 
@@ -1084,7 +1083,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1084 1083
 <br>
1085 1084
 
1086 1085
 One way to handle this is that whenever a POST is done the webserver
1087  
-processes the posted data and then return a Redirect response to the
  1086
+processes the posted data and then returns a Redirect response to the
1088 1087
 browser which then does a GET of the page that's the target of the
1089 1088
 redirect.&nbsp;&nbsp; Thus the user ends up looking at a page that was
1090 1089
 fetched with a GET, and thus IE will have no problem returning to this
@@ -1100,8 +1099,8 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1100 1099
 
1101 1100
 <br>
1102 1101
 
1103  
-The redirect flag say that rather than simply return the contents of
1104  
-showresult.clp to the browser, instead Webactions will return a
  1102
+The redirect flag says that rather than simply return the contents of
  1103
+showresult.clp to the browser, Webactions will return a
1105 1104
 Redirect response to the browser which will then fetch "showresult.clp".<br>
1106 1105
 
1107 1106
 The consequence of this redirect is that clp functions invoked by
@@ -1179,7 +1178,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1179 1178
 <span style="font-weight: bold;">webaction</span> - An instance of this
1180 1179
 class contains the information on a webaction project. &nbsp;It
1181 1180
 contains
1182  
-the information passed as arguments to webaction-project as well as a a
  1181
+the information passed as arguments to webaction-project as well as a
1183 1182
 websession-master instance if sessions are to be maintained.<br>
1184 1183
 
1185 1184
 <br>
@@ -1416,7 +1415,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1416 1415
 the location is session then the values are retrieved from the session
1417 1416
 variables. &nbsp; &nbsp;If <span style="font-weight: bold;">safe</span>
1418 1417
 is given then the value will be printed in such a way to escape any
1419  
-characters that would be interpreted as html &nbsp;(e.g as <span style="font-family: monospace;">(html (:princ-safe xxx))</span> would
  1418
+characters that would be interpreted as html &nbsp;(e.g. as <span style="font-family: monospace;">(html (:princ-safe xxx))</span> would
1420 1419
 print the value).<br>
1421 1420
 
1422 1421
 Example:<br>
@@ -1465,7 +1464,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1465 1464
 &lt;clp_ifeq name="xxx" value="yyy" [query | request | session]&gt;</span><span style="font-family: courier new,courier,monospace;">body</span><span style="font-weight: bold; font-family: courier new,courier,monospace;">&lt;/clp_ifeq&gt;<br>
1466 1465
 <br>
1467 1466
 </span>If the value of the variable xxx found at the given location is
1468  
-eql to the value yyy then the body will be emitted to the html
  1467
+not eql to the value yyy then the body will be emitted to the html
1469 1468
 stream.
1470 1469
 &nbsp; &nbsp;The value yyy should be an integer value.<br>
1471 1470
 
@@ -1555,7 +1554,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1555 1554
 <pre>&lt;select name="color"&gt;<br>&lt;clp_options name="defcolor" session&gt;<br>"blue" "green" "yellow"<br>"red" "purple" "gold"<br>&lt;/clp_options&gt;<br>&lt;/select&gt;<br><br><br></pre>
1556 1555
 
1557 1556
 <span style="font-weight: bold; font-family: courier new,courier,monospace;">&lt;clp_select
1558  
-<span style="font-style: italic;">args</span>&gt;</span><span style="font-family: courier new,courier,monospace;">body</span><span style="font-weight: bold; font-family: courier new,courier,monospace;">&lt;/clp_select&gt;</span><br>
  1557
+<span style="font-style: italic;">args</span>&gt;</span><span style="font-family: courier new,courier,monospace;">body</span><span style="font-weight: bold; font-family: courier new,courier,monospace;">&lt;/clp_select&gt;</span><br><br>
1559 1558
 
1560 1559
 This&nbsp; function simply emits a select form: &lt;<span style="font-weight: bold;">select</span> <span style="font-style: italic;">args</span>&gt;body&lt;/<span style="font-weight: bold;">select</span>&gt;.&nbsp;&nbsp;&nbsp;&nbsp;
1561 1560
 The reason for using <span style="font-weight: bold;">clp_select</span>
@@ -1622,7 +1621,7 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1622 1621
 that value in red in the html being returned as part of the
1623 1622
 request.&nbsp; &nbsp;If <span style="font-weight: bold;">clear</span>
1624 1623
 is
1625  
-given then set the valueof variable <span style="font-weight: bold;">xxx</span>&nbsp;
  1624
+given then set the value of variable <span style="font-weight: bold;">xxx</span>&nbsp;
1626 1625
 to nil. &nbsp; This is commonly used to display error messages on a
1627 1626
 page, such as when a form wasn't filled out correctly and you're
1628 1627
 redisplaying the page and asking the user to try again. &nbsp; The
@@ -1638,4 +1637,4 @@ <h1 style="text-align: center;">Allegro Webactions<br>
1638 1637
 
1639 1638
 <br>
1640 1639
 
1641  
-</body></html>
  1640
+</body></html>

0 notes on commit 26eab6f

Please sign in to comment.
Something went wrong with that request. Please try again.