Annotation of libwww/Library/src/HTML.html, revision 2.9

2.7       timbl       1: <HTML>
                      2: <HEAD>
                      3: <TITLE>HTML to rich text converter for libwww</TITLE>
2.8       timbl       4: <NEXTID N="z4">
2.7       timbl       5: </HEAD>
2.6       timbl       6: <BODY>
2.8       timbl       7: <H1>The HTML to styled text object converter</H1>This interprets the <A
                      8: NAME="z0" HREF="../../MarkUp/MarkUp.html">HTML</A> semantics
                      9: and some HTMLPlus.<P>
                     10: Part of <A
                     11: NAME="z2" HREF="Overview.html">libwww</A> . Implemented by <A
                     12: NAME="z3" HREF="HTML.c">HTML.c</A>
2.6       timbl      13: <PRE>#ifndef HTML_H
2.1       timbl      14: #define HTML_H
                     15: 
                     16: #include "HTUtils.h"
                     17: #include "HTAnchor.h"
2.8       timbl      18: #include "HTMLPDTD.h"
2.1       timbl      19: 
2.8       timbl      20: #define DTD HTMLP_dtd
                     21: 
2.6       timbl      22: #ifdef SHORT_NAMES
                     23: #define HTMLPresentation       HTMLPren
                     24: #define HTMLPresent            HTMLPres
                     25: #endif
2.1       timbl      26: 
                     27: extern CONST HTStructuredClass HTMLPresentation;
                     28: 
2.6       timbl      29: </PRE>
2.8       timbl      30: <H2>HTConverter instances to present
                     31: HTML</H2>
                     32: <PRE>/* PUBLIC HTStream* HTMLToPlain PARAMS((HTRequest * request,
                     33:                                        HTFormat input_format,
                     34:                                        HTFormat output_format,
                     35:                                        HTStream * output_stream));
                     36: 
                     37: PUBLIC HTStream* HTMLToC PARAMS((HTRequest * request,
                     38:                                        HTFormat input_format,
                     39:                                        HTFormat output_format,
                     40:                                        HTStream * output_stream));
                     41: 
                     42: PUBLIC HTStream* HTMLPresent PARAMS((HTRequest * request,
                     43:                                        HTFormat input_format,
                     44:                                        HTFormat output_format,
                     45:                                        HTStream * output_stream));
                     46: */
                     47: 
2.9     ! timbl      48: </PRE>
        !            49: <H2>HTML_new: A structured stream to
        !            50: parse HTML</H2>
        !            51: <PRE>extern HTStructured* HTML_new PARAMS((HTRequest * request,
2.8       timbl      52:                                        void *   param,
                     53:                                        HTFormat input_format,
                     54:                                        HTFormat output_format,
                     55:                                        HTStream * output_stream));
                     56: 
2.1       timbl      57: 
2.8       timbl      58: extern HTConverter HTMLToPlain, HTMLToC, HTMLPresent;
                     59: 
                     60: 
                     61: </PRE>
                     62: <H2>Selecting internal character set
                     63: representations</H2>
                     64: <PRE>typedef enum _HTMLCharacterSet {
2.1       timbl      65:        HTML_ISO_LATIN1,
                     66:        HTML_NEXT_CHARS,
                     67:        HTML_PC_CP950
                     68: } HTMLCharacterSet;
                     69: 
                     70: extern void HTMLUseCharacterSet PARAMS((HTMLCharacterSet i));
                     71: 
2.6       timbl      72: </PRE>
                     73: <H2>Record error message as a hypertext
                     74: object</H2>The error message should be marked
                     75: as an error so that it can be reloaded
                     76: later. This implementation just throws
                     77: up an error message and leaves the
                     78: document unloaded.
                     79: <PRE>/* On entry,
2.1       timbl      80: **     sink    is a stream to the output device if any
                     81: **     number  is the HTTP error number
                     82: **     message is the human readable message.
                     83: ** On exit,
2.6       timbl      84: **     a retrun code like HT_LOADED if object exists else 60; 0
2.1       timbl      85: */
                     86: 
                     87: PUBLIC int HTLoadError PARAMS((
                     88:        HTStream *      sink,
                     89:        int             number,
                     90:        CONST char *    message));
                     91: 
                     92: #endif
2.6       timbl      93: 
2.7       timbl      94: 
2.8       timbl      95: 
                     96: 
                     97: 
                     98: 
                     99: 
                    100: 
                    101: 
2.9     ! timbl     102: 
        !           103: </BODY>
2.7       timbl     104: </HTML>

Webmaster