For most cases, you'll probably want to install to /home/httpd/cgi-bin, so
run configure like this (run configure on the target system to have it
automatically configure the default e-mail domain and default URL.  If
auto-detection fails or if you want to supply your own parameters,
see the bottom of the help page by running `configure --help`):

configure --prefix=/home/httpd --bindir=/home/httpd/cgi-bin

If this gives you an error while trying to detect the host domain, re-run
the above command with the emaildomain and defaulturl options.

Once it has been configured, do the following:

make
su -c "make install"

Now it is time to create a couple of directories and make a new index.
Go into the directory where dirlist2.cgi installed into
(/home/httpd/cgi-bin, in this example) and run the following:

mkdir -p dirlist_indexes
mkdir -p dirlist_html
./dirlist2.cgi --create dirlist_indexes/users.idx2

Now you are ready to set up the DirList Server.  Read the files in the
distribution's dirlist_html for more information on "bad templates."  If
you want to jump in, copy the users.web.*.html files into the dirlist_html
directory that you created above and modify as necessary.  The first part
of the filename is the index file that it is associated with and can be
changed with the i=indexname query string parameter.  The second part of
the filename corresponds to the h=htmlname parameter (in the example
files provided, h equals "web").  The third part of the filename
differentiates the header from the footer.  On HTML output, DirList Server
writes the header HTML file to the browser, outputs the requested fields
as table cells and rows, and then writes the footer HTML.  When JavaScript
is used (js=1), JavaScript is included in the output so that the header
and/or footer can use that information to customize the page further.

If you want to add a search page to your web site, copy the example
search.html into your /home/httpd/html directory (for example) and point
your web browser to that location.  Customize as necessary.

The "users" index is the default unless if you changed the Default URL
during configure to something else. For most systems, add your users to
the index by running the following command as any user, preferably the
same one that httpd runs as (usually "nobody"):

./dirlist2.cgi --update dirlist_indexes/users.idx2 /home

A user has a web site if their HTML directory contains, in this order:
index.shtml index.html, index.php, index.cgi, index.htm, default.htm,
username.html, where "username" is the current user's name.  This may be
configurable in the future; for now, hack the source code manually ;).
Note that if a file matches a "bad template," processing resumes on to the
next possible HTML file for that user.

The next step can take place regardless of the previous step.  Download
DirList2ODBC to a Windows system, install it, and then connect to your
new DirList server.  Go into the database configuration screen in the
sample Microsoft Access database and then modify the system values
appropriately.  The default web documents directory is
"public_html" but if your system is different, that can be changed
through the database access method described above.

Thank you for your interest in DirList Server!

--Steven Lawrance--
slawrance@yahoo.com
http://dirlist.sourceforge.net