浏览代码

doc: define @node and @chapter in the main document and not in the individual chapters

Nathalie Furmento 13 年之前
父节点
当前提交
bd47f03921

+ 0 - 3
doc/chapters/advanced-api.texi

@@ -6,9 +6,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node StarPU Advanced API
-@chapter StarPU Advanced API
-
 @menu
 @menu
 * Defining a new data interface::  
 * Defining a new data interface::  
 * Multiformat Data Interface::  
 * Multiformat Data Interface::  

+ 0 - 3
doc/chapters/advanced-examples.texi

@@ -6,9 +6,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Advanced Examples
-@chapter Advanced Examples
-
 @menu
 @menu
 * Using multiple implementations of a codelet::
 * Using multiple implementations of a codelet::
 * Enabling implementation according to capabilities::
 * Enabling implementation according to capabilities::

+ 0 - 3
doc/chapters/basic-api.texi

@@ -6,9 +6,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node StarPU Basic API
-@chapter StarPU Basic API
-
 @menu
 @menu
 * Initialization and Termination::  Initialization and Termination methods
 * Initialization and Termination::  Initialization and Termination methods
 * Workers' Properties::         Methods to enumerate workers' properties
 * Workers' Properties::         Methods to enumerate workers' properties

+ 0 - 3
doc/chapters/basic-examples.texi

@@ -6,9 +6,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Basic Examples
-@chapter Basic Examples
-
 @menu
 @menu
 * Compiling and linking options::  
 * Compiling and linking options::  
 * Hello World::                 Submitting Tasks
 * Hello World::                 Submitting Tasks

+ 0 - 3
doc/chapters/c-extensions.texi

@@ -4,9 +4,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node C Extensions
-@chapter C Extensions
-
 @cindex C extensions
 @cindex C extensions
 @cindex GCC plug-in
 @cindex GCC plug-in
 
 

+ 0 - 3
doc/chapters/configuration.texi

@@ -6,9 +6,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Configuring StarPU
-@chapter Configuring StarPU
-
 @menu
 @menu
 * Compilation configuration::   
 * Compilation configuration::   
 * Execution configuration through environment variables::  
 * Execution configuration through environment variables::  

+ 1 - 4
doc/chapters/fft-support.texi

@@ -2,13 +2,10 @@
 
 
 @c This file is part of the StarPU Handbook.
 @c This file is part of the StarPU Handbook.
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
-@c Copyright (C) 2010, 2011  Centre National de la Recherche Scientifique
+@c Copyright (C) 2010, 2011, 2012  Centre National de la Recherche Scientifique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node StarPU FFT support
-@chapter StarPU FFT support
-
 StarPU provides @code{libstarpufft}, a library whose design is very similar to
 StarPU provides @code{libstarpufft}, a library whose design is very similar to
 both fftw and cufft, the difference being that it takes benefit from both CPUs
 both fftw and cufft, the difference being that it takes benefit from both CPUs
 and GPUs. It should however be noted that GPUs do not have the same precision as
 and GPUs. It should however be noted that GPUs do not have the same precision as

+ 1 - 4
doc/chapters/installing.texi

@@ -2,13 +2,10 @@
 
 
 @c This file is part of the StarPU Handbook.
 @c This file is part of the StarPU Handbook.
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
-@c Copyright (C) 2010, 2011  Centre National de la Recherche Scientifique
+@c Copyright (C) 2010, 2011, 2012  Centre National de la Recherche Scientifique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Installing StarPU
-@chapter Installing StarPU
-
 @menu
 @menu
 * Downloading StarPU::          
 * Downloading StarPU::          
 * Configuration of StarPU::     
 * Configuration of StarPU::     

+ 1 - 4
doc/chapters/introduction.texi

@@ -2,13 +2,10 @@
 
 
 @c This file is part of the StarPU Handbook.
 @c This file is part of the StarPU Handbook.
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
-@c Copyright (C) 2010, 2011  Centre National de la Recherche Scientifique
+@c Copyright (C) 2010, 2011, 2012  Centre National de la Recherche Scientifique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Introduction
-@chapter Introduction to StarPU
-
 @menu
 @menu
 * Motivation::                  Why StarPU ?
 * Motivation::                  Why StarPU ?
 * StarPU in a Nutshell::        The Fundamentals of StarPU
 * StarPU in a Nutshell::        The Fundamentals of StarPU

+ 0 - 3
doc/chapters/mpi-support.texi

@@ -6,9 +6,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node StarPU MPI support
-@chapter StarPU MPI support
-
 The integration of MPI transfers within task parallelism is done in a
 The integration of MPI transfers within task parallelism is done in a
 very natural way by the means of asynchronous interactions between the
 very natural way by the means of asynchronous interactions between the
 application and StarPU.  This is implemented in a separate libstarpumpi library
 application and StarPU.  This is implemented in a separate libstarpumpi library

+ 0 - 3
doc/chapters/perf-feedback.texi

@@ -6,9 +6,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Performance feedback
-@chapter Performance feedback
-
 @menu
 @menu
 * On-line::                     On-line performance feedback
 * On-line::                     On-line performance feedback
 * Off-line::                    Off-line performance feedback
 * Off-line::                    Off-line performance feedback

+ 0 - 3
doc/chapters/perf-optimization.texi

@@ -6,9 +6,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Performance optimization
-@chapter How to optimize performance with StarPU
-
 TODO: improve!
 TODO: improve!
 
 
 @menu
 @menu

+ 1 - 4
doc/chapters/scaling-vector-example.texi

@@ -2,13 +2,10 @@
 
 
 @c This file is part of the StarPU Handbook.
 @c This file is part of the StarPU Handbook.
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
-@c Copyright (C) 2010, 2011  Centre National de la Recherche Scientifique
+@c Copyright (C) 2010, 2011, 2012  Centre National de la Recherche Scientifique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Full source code for the 'Scaling a Vector' example
-@appendix Full source code for the 'Scaling a Vector' example
-
 @menu
 @menu
 * Main application::            
 * Main application::            
 * CPU Kernel::                 
 * CPU Kernel::                 

+ 0 - 3
doc/chapters/tips-tricks.texi

@@ -6,9 +6,6 @@
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Tips and Tricks
-@chapter Tips and Tricks to know about
-
 @menu
 @menu
 * Per-worker library initialization::  How to initialize a computation library once for each worker?
 * Per-worker library initialization::  How to initialize a computation library once for each worker?
 @end menu
 @end menu

+ 1 - 4
doc/chapters/using.texi

@@ -2,13 +2,10 @@
 
 
 @c This file is part of the StarPU Handbook.
 @c This file is part of the StarPU Handbook.
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
 @c Copyright (C) 2009--2011  Universit@'e de Bordeaux 1
-@c Copyright (C) 2010, 2011  Centre National de la Recherche Scientifique
+@c Copyright (C) 2010, 2011, 2012  Centre National de la Recherche Scientifique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c Copyright (C) 2011 Institut National de Recherche en Informatique et Automatique
 @c See the file starpu.texi for copying conditions.
 @c See the file starpu.texi for copying conditions.
 
 
-@node Using StarPU
-@chapter Using StarPU
-
 @menu
 @menu
 * Setting flags for compiling and linking applications::  
 * Setting flags for compiling and linking applications::  
 * Running a basic StarPU application::  
 * Running a basic StarPU application::  

+ 33 - 2
doc/starpu.texi

@@ -77,8 +77,8 @@ was last updated on @value{UPDATED}.
 * StarPU Basic API::            The Basic API to use StarPU
 * StarPU Basic API::            The Basic API to use StarPU
 * StarPU Advanced API::         Advanced use of StarPU
 * StarPU Advanced API::         Advanced use of StarPU
 * Configuring StarPU::          How to configure StarPU
 * Configuring StarPU::          How to configure StarPU
-* Full source code for the 'Scaling a Vector' example::
-* GNU Free Documentation License::    How you can copy and share this manual.
+* Full source code for the 'Scaling a Vector' example::  
+* GNU Free Documentation License::  How you can copy and share this manual.
 * Function Index::              Index of C functions.
 * Function Index::              Index of C functions.
 * Datatype Index::              Index of C datatypes
 * Datatype Index::              Index of C datatypes
 @end menu
 @end menu
@@ -87,84 +87,112 @@ was last updated on @value{UPDATED}.
 @c Introduction to StarPU
 @c Introduction to StarPU
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node Introduction
+@chapter Introduction to StarPU
 @include chapters/introduction.texi
 @include chapters/introduction.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c Installing StarPU
 @c Installing StarPU
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node Installing StarPU
+@chapter Installing StarPU
 @include chapters/installing.texi
 @include chapters/installing.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c Using StarPU
 @c Using StarPU
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node Using StarPU
+@chapter Using StarPU
 @include chapters/using.texi
 @include chapters/using.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c Basic Examples
 @c Basic Examples
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node Basic Examples
+@chapter Basic Examples
 @include chapters/basic-examples.texi
 @include chapters/basic-examples.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c Advanced Examples
 @c Advanced Examples
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node Advanced Examples
+@chapter Advanced Examples
 @include chapters/advanced-examples.texi
 @include chapters/advanced-examples.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c Performance options
 @c Performance options
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node Performance optimization
+@chapter How to optimize performance with StarPU
 @include chapters/perf-optimization.texi
 @include chapters/perf-optimization.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c Performance feedback
 @c Performance feedback
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node Performance feedback
+@chapter Performance feedback
 @include chapters/perf-feedback.texi
 @include chapters/perf-feedback.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c Tips and Tricks
 @c Tips and Tricks
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node Tips and Tricks
+@chapter Tips and Tricks to know about
 @include chapters/tips-tricks.texi
 @include chapters/tips-tricks.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c MPI support
 @c MPI support
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node StarPU MPI support
+@chapter StarPU MPI support
 @include chapters/mpi-support.texi
 @include chapters/mpi-support.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c FFT support
 @c FFT support
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node StarPU FFT support
+@chapter StarPU FFT support
 @include chapters/fft-support.texi
 @include chapters/fft-support.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c C Extensions
 @c C Extensions
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node C Extensions
+@chapter C Extensions
 @include chapters/c-extensions.texi
 @include chapters/c-extensions.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c StarPU API
 @c StarPU API
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node StarPU Basic API
+@chapter StarPU Basic API
 @include chapters/basic-api.texi
 @include chapters/basic-api.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c Advanced Topics
 @c Advanced Topics
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node StarPU Advanced API
+@chapter StarPU Advanced API
 @include chapters/advanced-api.texi
 @include chapters/advanced-api.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c Configuration options
 @c Configuration options
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 
 
+@node Configuring StarPU
+@chapter Configuring StarPU
 @include chapters/configuration.texi
 @include chapters/configuration.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
@@ -175,11 +203,14 @@ was last updated on @value{UPDATED}.
 @c Full source code for the 'Scaling a Vector' example
 @c Full source code for the 'Scaling a Vector' example
 @c ---------------------------------------------------------------------
 @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
 @include chapters/scaling-vector-example.texi
 
 
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
 @c License
 @c License
 @c ---------------------------------------------------------------------
 @c ---------------------------------------------------------------------
+
 @node GNU Free Documentation License
 @node GNU Free Documentation License
 @appendix GNU Free Documentation License
 @appendix GNU Free Documentation License
 @include chapters/fdl-1.3.texi
 @include chapters/fdl-1.3.texi