[03e621]: doc / mainpage.dox  Maximize  Restore  History

Download this file

114 lines (71 with data), 3.9 kB

// -*- mode: c++; mode: visual-line; mode: flyspell; fill-column: 100000 -*-
 *  doc/mainpage.dox
 *  Main page of STXXL doxygen tree. All doc pages should be linked here.
 *  Part of the STXXL. See http://stxxl.sourceforge.net
 *  Copyright (C) 2013 Timo Bingmann <tb@panthema.net>
 *  Distributed under the Boost Software License, Version 1.0.
 *  (See accompanying file LICENSE_1_0.txt or copy at
 *  http://www.boost.org/LICENSE_1_0.txt)

/** \mainpage Welcome to STXXL

The core of STXXL is an implementation of the C++ standard template library STL for <b>external memory</b> (out-of-core) computations, i.e., STXXL implements containers and algorithms that can process huge volumes of data that only fit on disks. While the compatibility to the STL supports ease of use and compatibility with existing applications, another design priority is high performance. Here is a selection of STXXL performance features:

- transparent support of multiple disks
- variable block lengths
- overlapping of I/O and computation
- prevention of OS file buffering overhead
- algorithm pipelining
- utilization of multiple processor cores for internal computation

See the \subpage introduction "introduction to external memory" for a longer description and our vision.

# Getting Started: Building and Tutorial

This section will help you if you are using the STXXL for the first time.

First you must compile the library. Pick one of the following \subpage install "build instructions", depending on your host system:

- \ref install_unix
- \ref install_windows

Once compiled, you can read the following simple tutorials on how to use STXXL containers and algorithms:

- \ref tutorial_vector
- \ref tutorial_stack
- \ref tutorial_pqueue

See the corresponding page for a \subpage tutorial "complete list of all Tutorials and Examples".

# Design and More Information

We have collected much documentation about the design of STXXL. Even more information is available as academic research papers, technical reports and theses.

- \subpage design "Design of STXXL concepts, containers and algorithms"

If you plan to contribute code to STXXL, please read the \subpage coding_style and use the \subpage common.

# FAQ, Troubleshooting, Bugs and More

- \subpage faq

- Questions concerning use and development of the STXXL library should be posted to the <a href="http://sourceforge.net/projects/stxxl/forums"><b>FORUMS</b></a>. Please search the forum before posting, your question may have been answered before.

- See \ref faq_compilers when compilation fails.

- Bugs and pull requests can be reported via <a href="http://github.com/stxxl/stxxl"><b>Github</b></a>: http://github.com/stxxl/stxxl.

- Check the \ref changelog for recent changes when switching version.

- The STXXL source also contains \subpage stxxl_tool "stxxl_tool", a collection of simple tools and benchmarks.

# License and Authors

\c STXXL is distributed under the Boost Software License, Version 1.0. \n
You can find a copy of the license in the accompanying file \ref license or at <a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>. \n
Many people have contributed to STXXL, see all \ref authors.
\subpage textfiles "&nbsp;"


/** \page textfiles Additional Text Files

- \subpage readme
- \subpage changelog
- \subpage authors
- \subpage textfiles_install
- \subpage license
- \subpage todo

\page readme README

\verbinclude README

\page changelog ChangeLog

\verbinclude CHANGELOG

\page authors AUTHORS

The following list of authors have contributed to STXXL:

\verbinclude AUTHORS

\page textfiles_install INSTALL

\verbinclude INSTALL

\page license LICENSE_1_0.txt

\verbinclude LICENSE_1_0.txt

\page todo TODO

\verbinclude TODO


Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

No, thanks