Annotation of libwww/Library/src/WWWDir.html, revision 2.6

2.1       frystyk     1: <HTML>
                      2: <HEAD>
2.6     ! frystyk     3:   <TITLE>W3C Reference Library libwww Directory Listings</TITLE>
2.1       frystyk     4: </HEAD>
                      5: <BODY>
2.6     ! frystyk     6: <H1>
        !             7:   Declaration of W3C Reference Directory Listings
        !             8: </H1>
2.1       frystyk     9: <PRE>
                     10: /*
                     11: **     (c) COPYRIGHT MIT 1995.
                     12: **     Please first read the full copyright statement in the file COPYRIGH.
                     13: */
                     14: </PRE>
2.6     ! frystyk    15: <P>
        !            16: This is the include file for the directory handling modules for parsing and
        !            17: presenting directory listings - often in the form of a HTML document.
2.1       frystyk    18: <PRE>
                     19: #ifndef WWWDIR_H
                     20: #define WWWDIR_H
                     21: </PRE>
                     22: <PRE>
                     23: #ifdef __cplusplus
                     24: extern "C" { 
                     25: #endif
                     26: </PRE>
2.6     ! frystyk    27: <H3>
        !            28:   System dependencies
        !            29: </H3>
        !            30: <P>
2.5       frystyk    31: The <A HREF="sysdep.html">sysdep.h</A> file includes system-specific include
2.6     ! frystyk    32: files and flags for I/O to network and disk. The only reason for this file
        !            33: is that the Internet world is more complicated than Posix and ANSI.
2.1       frystyk    34: <PRE>
2.6     ! frystyk    35: #include "<A HREF="sysdep.html">sysdep.h</A>"
2.5       frystyk    36: </PRE>
2.6     ! frystyk    37: <H2>
        !            38:   Icons
        !            39: </H2>
        !            40: <P>
        !            41: No directory listings without icons! The WWWDir interface contains support
        !            42: for including references (URLs and ALT text tags) to icons in directory listings.
        !            43: The icons are selected as a function of the media type and the content encoding
        !            44: of the file in question. That is - you can set up icons for compressed files,
        !            45: postscript files etc. There is also a small set of specific icons representing
        !            46: directories etc.
        !            47: <P>
        !            48: <B>Note</B>: Icons are not set up by default! You must enable them yourself.
        !            49: The Library distribution contains a small default set of icons which you
        !            50: can find at <CODE>$(datadir)/www-icons</CODE>, and they can be set up using
        !            51: the <A HREF="HTInit.html#icons">HTIconInit() initialization</A> function
        !            52: in the <A HREF="WWWInit.html">WWWInit startup interface</A>
        !            53: <PRE>#include "<A HREF="HTIsonc.html">HTIcons.h</A>"
        !            54: </PRE>
        !            55: <H2>
        !            56:   File Descriptions
        !            57: </H2>
        !            58: <P>
        !            59: Descriptions appearing in <A HREF="HTDir.html">directory listings</A> are
        !            60: produced by this module. This may be overridden by another module for those
        !            61: who which descriptions to come from somewhere else. It's only HTTP directory
        !            62: listings that contain a description field (if enabled by the
        !            63: <A HREF="HTDir.html">Directory browsing module</A>.
        !            64: <PRE>
        !            65: #include "<A HREF="HTDescpt.html">HTDescpt</A>.h"
        !            66: </PRE>
        !            67: <H2>
        !            68:   Directory listings
        !            69: </H2>
        !            70: <P>
        !            71: The directory manager generates directory listings for FTP and HTTP requests.
        !            72: This module contains the protocol independent code and it produces the HTML
        !            73: object. It is only included if either the <A HREF="HTFTP.html">FTP</A> or
        !            74: the <A HREF="HTFile.html">File</A> module is included.
2.5       frystyk    75: <PRE>
2.6     ! frystyk    76: #include "<A HREF="HTDir.html">HTDir.h</A>"
2.1       frystyk    77: </PRE>
2.6     ! frystyk    78: <P>
2.1       frystyk    79: End of DIR module
                     80: <PRE>
                     81: #ifdef __cplusplus
                     82: } /* end extern C definitions */
                     83: #endif
                     84: 
                     85: #endif
                     86: </PRE>
2.6     ! frystyk    87: <P>
        !            88:   <HR>
2.4       frystyk    89: <ADDRESS>
2.6     ! frystyk    90:   @(#) $Id: WWWDir.html,v 2.5 1996/04/16 16:23:25 frystyk Exp $
2.4       frystyk    91: </ADDRESS>
2.6     ! frystyk    92: </BODY></HTML>

Webmaster