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

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

Webmaster