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