\input texinfo @c -*-texinfo-*-

@c %**start of header
@setfilename starpu.info
@settitle StarPU Handbook
@c %**end of header

@include chapters/version.texi

@copying
Copyright @copyright{} 2009--2013  Universit@'e de Bordeaux 1

@noindent
Copyright @copyright{} 2010--2013  Centre National de la Recherche Scientifique

@noindent
Copyright @copyright{} 2011, 2012 Institut National de Recherche en Informatique et Automatique

@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts.  A copy of the license is included in the section entitled ``GNU
Free Documentation License''.
@end quotation
@end copying

@setchapternewpage odd
@dircategory Development
@direntry
* StarPU: (starpu).             StarPU Handbook
@end direntry

@titlepage
@title StarPU Handbook
@subtitle for StarPU @value{VERSION}

@page
@vskip 0pt plus 1fill

@insertcopying

@end titlepage

@c @summarycontents
@contents
@page

@ifnottex
@node Top
@top StarPU Handbook
@end ifnottex

This manual documents the usage of StarPU version @value{VERSION}.  It
was last updated on @value{UPDATED}.

@ifnottex
@insertcopying
@end ifnottex

@comment
@comment  When you add a new menu item, please keep the right hand
@comment  aligned to the same column.  Do not use tabs.  This provides
@comment  better formatting.
@comment
@menu
* Introduction::                Getting started
* Building and Installing StarPU::
* Basic Examples::              Basic examples of the use of StarPU
* Advanced Examples::           Advanced examples of the use of StarPU
* Performance optimization::    How to optimize performance with StarPU
* Performance feedback::        Performance debugging tools
* Tips and Tricks::             Tips and tricks to know about
* StarPU MPI support::          How to combine StarPU with MPI
* StarPU FFT support::          How to perform FFT computations with StarPU
* StarPU MIC/SCC support::      How to build and run StarPU applications on MIC and SCC
* C Extensions::                Easier StarPU programming with GCC
* SOCL OpenCL Extensions::      How to use OpenCL on top of StarPU
* Scheduling Contexts in StarPU::         How to use Scheduling Context of StarPU
* Scheduling Context Hypervisor::  How to use Scheduling Context Hypervisor with StarPU
* StarPU's API::                The API to use StarPU
* Scheduling Context Hypervisor's API:: The API to use the Hypervisor
* Configuration Options for StarPU::
* Full source code for the 'Scaling a Vector' example::
* GNU Free Documentation License::  How you can copy and share this manual.

* Concept Index::               Index of programming concepts.
* Function Index::              Index of C functions.
* Datatype Index::              Index of C datatypes.
* Configuration Index::         Index of configuration options.
@end menu

@c ---------------------------------------------------------------------
@c Introduction to StarPU
@c ---------------------------------------------------------------------

@node Introduction
@chapter Introduction to StarPU
@include chapters/introduction.texi

@c ---------------------------------------------------------------------
@c Installing StarPU
@c ---------------------------------------------------------------------

@node Building and Installing StarPU
@chapter Building and Installing StarPU
@include chapters/installing.texi

@c ---------------------------------------------------------------------
@c Basic Examples
@c ---------------------------------------------------------------------

@node Basic Examples
@chapter Basic Examples
@include chapters/basic-examples.texi

@c ---------------------------------------------------------------------
@c Advanced Examples
@c ---------------------------------------------------------------------

@node Advanced Examples
@chapter Advanced Examples
@include chapters/advanced-examples.texi

@c ---------------------------------------------------------------------
@c Performance options
@c ---------------------------------------------------------------------

@node Performance optimization
@chapter How to optimize performance with StarPU
@include chapters/perf-optimization.texi

@c ---------------------------------------------------------------------
@c Performance feedback
@c ---------------------------------------------------------------------

@node Performance feedback
@chapter Performance feedback
@include chapters/perf-feedback.texi

@c ---------------------------------------------------------------------
@c Tips and Tricks
@c ---------------------------------------------------------------------

@node Tips and Tricks
@chapter Tips and Tricks to know about
@include chapters/tips-tricks.texi

@c ---------------------------------------------------------------------
@c MPI support
@c ---------------------------------------------------------------------

@node StarPU MPI support
@chapter StarPU MPI support
@include chapters/mpi-support.texi

@c ---------------------------------------------------------------------
@c FFT support
@c ---------------------------------------------------------------------

@node StarPU FFT support
@chapter StarPU FFT support
@include chapters/fft-support.texi

@c ---------------------------------------------------------------------
@c MIC/SCC support
@c ---------------------------------------------------------------------

@node StarPU MIC/SCC support
@chapter StarPU MIC/SCC support
@include chapters/mic-scc-support.texi

@c ---------------------------------------------------------------------
@c C Extensions
@c ---------------------------------------------------------------------

@node C Extensions
@chapter C Extensions
@include chapters/c-extensions.texi

@c ---------------------------------------------------------------------
@c SOCL
@c ---------------------------------------------------------------------

@node SOCL OpenCL Extensions
@chapter SOCL OpenCL Extensions
@include chapters/socl.texi

@c ---------------------------------------------------------------------
@c Scheduling Contexts in StarPU
@c ---------------------------------------------------------------------

@node Scheduling Contexts in StarPU
@chapter Scheduling Contexts in StarPU
@include chapters/sched_ctx.texi

@c ---------------------------------------------------------------------
@c Scheduling Context Hypervisor
@c ---------------------------------------------------------------------

@node Scheduling Context Hypervisor
@chapter Scheduling Context Hypervisor
@include chapters/sc_hypervisor.texi

@c ---------------------------------------------------------------------
@c StarPU API
@c ---------------------------------------------------------------------

@node StarPU's API
@chapter StarPU's API
@include chapters/api.texi

@c ---------------------------------------------------------------------
@c Scheduling Context Hypervisor's API
@c ---------------------------------------------------------------------

@node Scheduling Context Hypervisor's API
@chapter Scheduling Context Hypervisor's API
@include chapters/hypervisor_api.texi

@c ---------------------------------------------------------------------
@c Configuration options
@c ---------------------------------------------------------------------

@node Configuration Options for StarPU
@chapter Configuration Options for StarPU
@include chapters/configuration.texi

@c ---------------------------------------------------------------------
@c Appendices
@c ---------------------------------------------------------------------

@c ---------------------------------------------------------------------
@c Full source code for the 'Scaling a Vector' example
@c ---------------------------------------------------------------------

@node Full source code for the 'Scaling a Vector' example
@appendix Full source code for the 'Scaling a Vector' example
@include chapters/scaling-vector-example.texi

@c ---------------------------------------------------------------------
@c License
@c ---------------------------------------------------------------------

@node GNU Free Documentation License
@appendix GNU Free Documentation License
@include chapters/fdl-1.3.texi

@c ---------------------------------------------------------------------
@c Indices
@c ---------------------------------------------------------------------

@c comment it out for now, it is too small to be kept for now. See how
@c it can be merged with the glossary section in the introduction
@node Concept Index
@unnumbered Concept Index
@printindex cp

@node Function Index
@unnumbered Function Index
@printindex fn

@node Datatype Index
@unnumbered Datatype Index
@printindex tp

@node Configuration Index
@unnumbered Configuration Index
@printindex vr

@bye
