[BACK]Return to WWWApp.html CVS log [TXT] [DIR] Up to [Public] / libwww / Library / src

Annotation of libwww/Library/src/WWWApp.html, revision 2.11

2.1       frystyk     1: <HTML>
                      2: <HEAD>
2.9       frystyk     3: <TITLE>W3C Reference Library libwww APPLICATION</TITLE>
2.11    ! frystyk     4: <!-- Changed by: Henrik Frystyk Nielsen, 16-Apr-1996 -->
2.1       frystyk     5: <NEXTID N="z11">
                      6: </HEAD>
                      7: <BODY>
                      8: 
2.2       frystyk     9: <H1>Non-Mandatory Application Include File</H1>
2.1       frystyk    10: 
                     11: <PRE>
                     12: /*
                     13: **     (c) COPYRIGHT MIT 1995.
                     14: **     Please first read the full copyright statement in the file COPYRIGH.
                     15: */
                     16: </PRE>
                     17: 
                     18: In addition top the basic W3C Reference Library include file called <A
                     19: HREF="WWWLib.html">WWWLib.h</A> you <EM>can</EM> also include this
                     20: file called WWWApp.h depending on the needs of your
                     21: application. However, it is not required and none of the files
                     22: included below are ever used in the core part of the Library
                     23: itself. Only if this file is included, the extra modules will get
                     24: included in the linked object code. It is also possible to include
                     25: only a subset of the files below if the functionality you are after is
                     26: covered by them.
                     27: 
                     28: <PRE>
                     29: #ifndef WWWAPP_H
                     30: #define WWWAPP_H
                     31: </PRE>
                     32: 
                     33: <PRE>
                     34: #ifdef __cplusplus
                     35: extern "C" { 
                     36: #endif
                     37: </PRE>
                     38: 
2.11    ! frystyk    39: <H2>System dependencies</H2>
        !            40: 
        !            41: The <A HREF="sysdep.html">sysdep.h</A> file includes system-specific include
        !            42: files and flags for I/O to network and disk. The only reason for this
        !            43: file is that the Internet world is more complicated than Posix and
        !            44: ANSI.
        !            45: 
        !            46: <PRE>
        !            47: #include "sysdep.h"
        !            48: </PRE>
        !            49: 
2.7       frystyk    50: <H2>Generating the First Anchor</H2>
2.2       frystyk    51: 
                     52: This module provides some "make life easier" functions in order to get
                     53: the application going. They help you generate the first anchor, also
                     54: called the <EM>home anchor</EM>. It also contains a nice set of
                     55: default WWW addresses.
                     56: 
                     57: <PRE>
                     58: #include "<A HREF="HTHome.html">HTHome.h</A>"
2.1       frystyk    59: </PRE>
                     60: 
2.8       frystyk    61: <H2>User Dialogs and Messages</H2>
                     62: 
                     63: You can register a set of callback functions to handle user prompting,
                     64: error messages, confimations etc. Here we give a set of functions that
                     65: can be used on almost anu thinkable platform. If you want to provide
                     66: your own platform dependent implementation then fine :-)
                     67: 
                     68: <PRE>
                     69: #include "<A HREF="HTDialog.html">HTDialog.h</A>"
                     70: </PRE>
                     71: 
                     72: <H2>After Terminating a Request</H2>
2.3       frystyk    73: 
                     74: When a request is terminated, the application often has to do some
                     75: action as a result of the request (and of the result of the
                     76: request). The Application part of the Library provides two following
                     77: modules to handle <EM>logging</EM> and <EM>history
                     78: management</EM>. You can register a <EM>POST request handler</EM> in
                     79: the <A HREF="HTNet.html">Net Manager</A> as described in the <A
2.4       frystyk    80: HREF="../User/Using/Overview.html">User's Guide</A>. <P>
                     81: 
                     82: You can find a function called <CODE>HTLoadTerminate</CODE> in the <A
2.5       frystyk    83: HREF="HTHome.html">HTHome module</A> that enables all the functionality
2.4       frystyk    84: for handling a request result.
2.3       frystyk    85: 
                     86: <H3>Logging</H3>
2.1       frystyk    87: 
                     88: Often it is required to log the requests issued to the Library. This
                     89: can either be the case if the application is a server or it can also
                     90: be useful in a client application. This module provides a simple
                     91: logging mechanism which can be enabled if needed.
                     92: 
                     93: <PRE>
2.2       frystyk    94: #include "<A HREF="HTLog.html">HTLog.h</A>"
2.1       frystyk    95: </PRE>
                     96: 
2.3       frystyk    97: <H3>History Management</H3>
2.1       frystyk    98: 
                     99: Another type of logging is keeping track of which documents a user has
                    100: visited when browsing along on the Web. The Library history manager
                    101: provides a basic set of functionality to keep track of a linear
                    102: history list.
                    103: 
                    104: <PRE>
2.2       frystyk   105: #include "<A HREF="HTHist.html">HTHist.h</A>"
2.1       frystyk   106: </PRE>
                    107: 
                    108: End of application specific modules
                    109: 
                    110: <PRE>
                    111: #ifdef __cplusplus
                    112: } /* end extern C definitions */
                    113: #endif
                    114: 
                    115: #endif
                    116: </PRE>
                    117: 
2.10      frystyk   118: <HR>
                    119: <ADDRESS>
2.11    ! frystyk   120: @(#) $Id: WWWApp.html,v 2.10 1996/04/12 17:49:59 frystyk Exp $
2.10      frystyk   121: </ADDRESS>
2.1       frystyk   122: </BODY>
                    123: </HTML>
Webmaster