summaryrefslogtreecommitdiffabout
path: root/htdocs/exceptions/index.chtml
Unidiff
Diffstat (limited to 'htdocs/exceptions/index.chtml') (more/less context) (show whitespace changes)
-rw-r--r--htdocs/exceptions/index.chtml3
1 files changed, 2 insertions, 1 deletions
diff --git a/htdocs/exceptions/index.chtml b/htdocs/exceptions/index.chtml
index 6bb2a3c..c700e42 100644
--- a/htdocs/exceptions/index.chtml
+++ b/htdocs/exceptions/index.chtml
@@ -1,50 +1,51 @@
1% html(); return; /* vim:set ft=sitecing: */ 1% /* vim:set ft=sitecing: */
2%%derive layout = "/ancestry/layout.chtml"; 2%%derive layout = "/ancestry/layout.chtml";
3%%pragma main=page
3<%constructor> 4<%constructor>
4 PN_PREV("/simple","simple page","building a really simple page"); 5 PN_PREV("/simple","simple page","building a really simple page");
5 PN_NEXT("/exceptions/preprocess","preprocess","preprocessing errors"); 6 PN_NEXT("/exceptions/preprocess","preprocess","preprocessing errors");
6</%constructor> 7</%constructor>
7<%codemethod string title() %> 8<%codemethod string title() %>
8 return "exceptions handling"; 9 return "exceptions handling";
9</%codemethod> 10</%codemethod>
10<%method void content() %> 11<%method void content() %>
11 <h1>site-C-ing exception handling</h1> 12 <h1>site-C-ing exception handling</h1>
12 <p> 13 <p>
13 The purpose of this section is to give an overview of the <em>site-C-ing</em> 14 The purpose of this section is to give an overview of the <em>site-C-ing</em>
14 exception handling mechanism. Before the web visitor can see the page each 15 exception handling mechanism. Before the web visitor can see the page each
15 site-C-ing component goes through a few stages, namely, preprocessing, 16 site-C-ing component goes through a few stages, namely, preprocessing,
16 compiling and execution. Having three stages to go through also means three 17 compiling and execution. Having three stages to go through also means three
17 stages one can fail to go through and three exciting opportunities to handle 18 stages one can fail to go through and three exciting opportunities to handle
18 different errors. 19 different errors.
19 </p> 20 </p>
20 <p> 21 <p>
21 First each component is preprocessed so that you can feed the valid c++ code 22 First each component is preprocessed so that you can feed the valid c++ code
22 to the compiler. Here is where the preprocessor can choke at your broken 23 to the compiler. Here is where the preprocessor can choke at your broken
23 source code. Once preprocessor failes to parse your code it will throw an 24 source code. Once preprocessor failes to parse your code it will throw an
24 exception which <em>site-C-ing</em> will catch and pass to <a 25 exception which <em>site-C-ing</em> will catch and pass to <a
25 href="/sources/htdocs/handlers/exception_dev" title="development mode 26 href="/sources/htdocs/handlers/exception_dev" title="development mode
26 exception handler source">the exception handler component</a>. Want to <a 27 exception handler source">the exception handler component</a>. Want to <a
27 href="/exceptions/preprocess">read more</a> about preprocessor exception 28 href="/exceptions/preprocess">read more</a> about preprocessor exception
28 handling? 29 handling?
29 </p> 30 </p>
30 <p> 31 <p>
31 After the preprocessing stage is over we have a great opportunity to catch 32 After the preprocessing stage is over we have a great opportunity to catch
32 the compile-time errors. After <em>site-C-ing</em> fails to compile the 33 the compile-time errors. After <em>site-C-ing</em> fails to compile the
33 component it throws another exception and passes it to the same handler which 34 component it throws another exception and passes it to the same handler which
34 may show you some information on what's gone wrong with your source code from 35 may show you some information on what's gone wrong with your source code from
35 the compiler's perspective. If you've gone this far you definitely want to <a 36 the compiler's perspective. If you've gone this far you definitely want to <a
36 href="/exceptions/compile">read more</a> about the compiler error handling. 37 href="/exceptions/compile">read more</a> about the compiler error handling.
37 </p> 38 </p>
38 <p class="note"> 39 <p class="note">
39 Note, that it is likely that you will want to disable the steps above for the 40 Note, that it is likely that you will want to disable the steps above for the
40 production environment to save time on unnecessary checking whether the 41 production environment to save time on unnecessary checking whether the
41 component is up to date. 42 component is up to date.
42 </p> 43 </p>
43 <p> 44 <p>
44 Finally, we need to execute the component and present its output to the web 45 Finally, we need to execute the component and present its output to the web
45 site visitor. This is also where things may go wrong and here is where your 46 site visitor. This is also where things may go wrong and here is where your
46 component may throw an exception for the engine to catch and pass to the 47 component may throw an exception for the engine to catch and pass to the
47 handler. Feel free to <a href="/exceptions/runtime">learn more</a> about it 48 handler. Feel free to <a href="/exceptions/runtime">learn more</a> about it
48 as well. 49 as well.
49 </p> 50 </p>
50 <p class="note"> 51 <p class="note">