MRG: Synchronized rfc-24-GDAL_overviews from develop.

e4b5e5c3 · Stéphane Albert · d1f2ddb3 · 677d2731 · e4b5e5c3 · e4b5e5c3
Commit e4b5e5c3 authored Mar 09, 2016 by Stéphane Albert
--- a/.travis.yml
+++ b/.travis.yml
@@ -20,7 +20,7 @@ before_script:
  - tar -xzf cmake-3.4.1-Linux-x86_64.tar.gz
  - wget https://github.com/martine/ninja/releases/download/v1.6.0/ninja-linux.zip --no-check-certificate
  - unzip ninja-linux.zip
-  - wget https://www.orfeo-toolbox.org/packages/xdk/OTB-5.2/OTB-5.2.0-xdk-Linux64.run  --no-check-certificate
+  - wget https://www.orfeo-toolbox.org/packages/xdk/OTB-5.2/OTB-5.2.0-xdk-Linux64.run --no-check-certificate
  - chmod +x /tmp/OTB-5.2.0-xdk-Linux64.run
  - /tmp/OTB-5.2.0-xdk-Linux64.run


--- a/CMake/CTestCustom.cmake.in
+++ b/CMake/CTestCustom.cmake.in
@@ -31,6 +31,10 @@ set(CTEST_CUSTOM_COVERAGE_EXCLUDE
 # Exclude files from the Examples directories
 #".*/Examples/.*"

+ # Exclude files from the Testing directories
+ ".*/test/.*"
+ ".*/Testing/.*"
+
 # Exclude files from the ThirdParty Utilities directories
 ".*/Modules/ThirdParty/.*"
 ".*/Utilities/.*"

--- a/Documentation/Latex/Copyright.tex
+++ b/Documentation/Latex/Copyright.tex
+\par
+Copyright \copyright{} 2001 The Insight Consortium.
+All rights reserved.
+
+See the end of this document for complete license and permissions
+information.
+\par
+
--- a/Documentation/Latex/HowtoExample.tex
+++ b/Documentation/Latex/HowtoExample.tex
+%
+% Complete documentation on the extended LaTeX markup used for Insight
+% documentation is available in ``Documenting Insight'', which is part
+% of the standard documentation for Insight.  It may be found online
+% at:
+%
+%     http://www.itk.org/
+
+\documentclass{InsightHowto}
+
+%  This is a template for short or medium-size Insight-related documents, 
+% mostly notably the series of HOWTOs, but it can be used for any
+% document you like.   
+
+% The title should be descriptive enough for people to be able to find
+% the relevant document. 
+\title{Spammifying Sprockets in Insight}
+
+% Increment the release number whenever significant changes are made.
+% The author and/or editor can define 'significant' however they like.
+\release{0.00}
+
+% At minimum, give your name and an email address.  You can include a
+% snail-mail address if you like.
+\author{Me, 'cause I wrote it}
+\authoraddress{Me, 'cause I'm self-employed.}
+
+\begin{document}
+\maketitle
+
+% This makes the Abstract go on a separate page in the HTML version;
+% if a copyright notice is used, it should go immediately after this.
+%
+\input{Copyright.tex}
+
+\ifhtml
+\chapter*{Front Matter\label{front}}
+\fi
+
+% Copyright statement should go here, if needed.
+% ...
+
+% The abstract should be a paragraph or two long, and describe the
+% scope of the document.
+\begin{abstract}
+\noindent
+This document describes how to spammify sprockets.  It is a useful
+example of a Insight HOWTO document.  It is not dependent on any
+particular sprocket implementation, and includes a Insight-based
+implementation in the \module{sprunkit} module.
+\end{abstract}
+
+\tableofcontents
+
+Spammifying sprockets from Insight is both fun and entertaining.
+Applying the techniques described here, you can also fill your hard
+disk quite effectively.
+
+\section{What is Sprocket Spammification?}
+
+You have to ask?  It's the only thing to do to your sprockets!
+
+
+\section{Why Use Insight?}
+
+Insight is an excellent language from which to spammify your sprockets
+since you can do it on any platform.
+
+
+\section{Software Requirements}
+
+You need to have the following software installed:
+
+% The {itemize} environment uses a bullet for each \item.  If you want the 
+% \item's numbered, use the {enumerate} environment instead.
+\begin{itemize}
+  \item  Insight 1.9.
+  \item  Some sprocket definition files.
+  \item  At least one sprocket system implementation.
+\end{itemize}
+
+Note that the \module{sprunkit} is provided with this package and
+implements ActiveSprockets in Insight.
+
+
+% The preceding sections will have been written in a gentler,
+% introductory style.  You may also wish to include a reference
+% section, documenting all the functions/exceptions/constants.
+% Often, these will be placed in separate files and input like this:
+
+
+
+\appendix
+
+\section{This is an Appendix}
+
+To create an appendix in a Insight HOWTO document, use markup like
+this:
+
+\begin{verbatim}
+\appendix
+
+\section{This is an Appendix}
+
+To create an appendix in a Insight HOWTO document, ....
+
+
+\section{This is another}
+
+Just add another \section{}, but don't say \appendix again.
+\end{verbatim}
+
+
+\end{document}
--- a/Documentation/Latex/Insight.bib
+++ b/Documentation/Latex/Insight.bib
--- a/Documentation/Latex/Insight.ist
+++ b/Documentation/Latex/Insight.ist
+line_max 100
+headings_flag 1
+heading_prefix "  \\bigletter "
+
+preamble "\\begin{theindex}
+\\def\\bigletter#1{{\\Large\\sffamily#1}\\nopagebreak\\vspace{1mm}}
+
+"
+
+symhead_positive "{Symbols}"
+numhead_positive "{Numbers}"
--- a/Documentation/Latex/Insight.sty
+++ b/Documentation/Latex/Insight.sty
--- a/Documentation/Latex/InsightBook.cls
+++ b/Documentation/Latex/InsightBook.cls
+%
+% InsightBook.cls for the Insight documentation
+%
+
+\NeedsTeXFormat{LaTeX2e}[1995/12/01]
+\ProvidesClass{InsightBook}
+             [1998/03/03 Document class (Insight book)]
+
+\RequirePackage{InsightPaper}
+
+% Change the options here to get a different set of basic options, but only
+% if you have to.  Paper and font size should be adjusted in itkpaper.sty.
+%
+\LoadClass[\itk@paper,\itk@ptsize,twoside,openright]{book}
+
+\setcounter{secnumdepth}{2}
+
+% Optional packages:
+%
+% If processing of these documents fails at your TeX installation,
+% these may be commented out (independently) to make things work.
+% These are both supplied with the current version of the teTeX
+% distribution.
+%
+% The "fancyhdr" package makes nicer page footers reasonable to
+% implement, and is used to put the chapter and section information in 
+% the footers.
+%
+\RequirePackage{fancyhdr}\typeout{Using fancier footers than usual.}
+
+
+% Required packages:
+%
+% The "fncychap" package is used to get the nice chapter headers.  The
+% .sty file is distributed with Insight, so you should not need to disable
+% it.  You'd also end up with a mixed page style; uglier than stock LaTeX!
+%
+\RequirePackage[Bjarne]{fncychap}\typeout{Using fancy chapter headings.}
+% Do horizontal rules it this way to match:
+\newcommand{\itk@doHorizontalRule}{\mghrulefill{\RW}}
+%
+%
+% This gives us all the Insight-specific markup that we really want.
+% This should come last.  Do not change this.
+%
+\RequirePackage{Insight}
+
+% support for module synopsis sections:
+\newcommand{\itk@ModSynopsisFilename}{\jobname\thechapter.syn}
+\let\itk@OldChapter=\chapter
+\renewcommand{\chapter}{
+  \itk@ProcessModSynopsis
+  \itk@closeModSynopsisFile
+  \itk@OldChapter
+}
+
+
+% Change the title page to look a bit better, and fit in with the
+% fncychap ``Bjarne'' style a bit better.
+%
+\renewcommand{\maketitle}{%
+  \begin{titlepage}%
+    \let\footnotesize\small
+    \let\footnoterule\relax
+    \itk@doHorizontalRule%
+    \@ifundefined{pdfinfo}{}{{
+      % This \def is required to deal with multi-line authors; it
+      % changes \\ to ', ' (comma-space), making it pass muster for
+      % generating document info in the PDF file.
+      \def\\{, }
+      \pdfinfo{
+        /Author (\@author)
+        /Title (\@title)
+      }
+    }}
+    \begin{flushright}%
+      {\rm\Huge\itk@HeaderFamily \@title \par}%
+      {\em\LARGE\itk@HeaderFamily \itk@release \par}
+      \vfill
+      {\LARGE\itk@HeaderFamily \@author \par}
+      \vfill\vfill
+      {\large
+       \@date \par
+       \vfill
+       \itk@authoraddress \par
+      }%
+    \end{flushright}%\par
+    \@thanks
+  \end{titlepage}%
+  \setcounter{footnote}{0}%
+  \let\thanks\relax\let\maketitle\relax
+  \gdef\@thanks{}\gdef\@author{}\gdef\@title{}
+}
+
+
+
+% This wraps the \tableofcontents macro with all the magic to get the
+% spacing right and have the right number of pages if the 'openright'
+% option has been used.  This eliminates a fair amount of crud in the
+% individual document files.
+%
+\let\itk@OldTableofcontents=\tableofcontents
+\renewcommand{\tableofcontents}{%
+  \setcounter{page}{1}%
+  \pagebreak%
+  \pagestyle{plain}%
+  {%
+    \parskip = 0mm%
+    \itk@OldTableofcontents%
+    \if@openright%
+      \ifodd\value{page}%
+        \typeout{Adding blank page after the table of contents.}%
+        \pagebreak\hspace{0pt}%
+      \fi%
+    \fi%
+    \cleardoublepage%
+  }%
+  \pagenumbering{arabic}%
+  \@ifundefined{fancyhf}{}{\pagestyle{normal}}%
+  \itk@doing@page@targetstrue%
+}
+% This is needed to get the width of the section # area wide enough in the
+% library reference.  Doing it here keeps it the same for all the manuals.
+%
+\renewcommand*\l@section{\@dottedtocline{1}{1.5em}{2.6em}}
+\renewcommand*\l@subsection{\@dottedtocline{2}{4.1em}{3.5em}}
+\setcounter{tocdepth}{1}
+
+
+% Fix the theindex environment to add an entry to the Table of
+% Contents; this is much nicer than just having to jump to the end of
+% the book and flip around, especially with multiple indexes.
+%
+\let\itk@OldTheindex=\theindex
+\renewcommand{\theindex}{
+  \cleardoublepage
+  \itk@OldTheindex
+  \addcontentsline{toc}{chapter}{\indexname}
+}
--- a/Documentation/Latex/InsightHowto.cls
+++ b/Documentation/Latex/InsightHowto.cls
+%
+% Insight-Howto.cls for the Insight documentation
+%
+
+\NeedsTeXFormat{LaTeX2e}[1995/12/01]
+\ProvidesClass{howto}
+             [1998/02/25 Document class (Insight HOWTO)]
+
+\RequirePackage{InsightPaper}
+
+% Change the options here to get a different set of basic options,  This
+% is where to add things like "a4paper" or "10pt".
+%
+\LoadClass[twoside]{article}
+
+\setcounter{secnumdepth}{1}
+
+% Optional packages:
+%
+% If processing of these documents fails at your TeX installation,
+% these may be commented out (independently) to make things work.
+% These are both supplied with the current version of the teTeX
+% distribution.
+%
+% The "fancyhdr" package makes nicer page footers reasonable to
+% implement, and is used to put the chapter and section information in 
+% the footers.
+%
+\RequirePackage{fancyhdr}\typeout{Using fancier footers than usual.}
+
+
+% Required package:
+%
+% This gives us all the Insight-specific markup that we really want.
+% This should come last.  Do not change this.
+%
+\RequirePackage{Insight}
+
+% support for module synopsis sections:
+\newcommand{\itk@ModSynopsisFilename}{\jobname.syn}
+
+
+% need to do one of these....
+\newcommand{\itk@doHorizontalRule}{\rule{\textwidth}{1pt}}
+
+
+% Change the title page to look a bit better, and fit in with the
+% fncychap ``Bjarne'' style a bit better.
+%
+\renewcommand{\maketitle}{
+  \itk@doHorizontalRule
+  \@ifundefined{pdfinfo}{}{{
+    % This \def is required to deal with multi-line authors; it
+    % changes \\ to ', ' (comma-space), making it pass muster for
+    % generating document info in the PDF file.
+    \def\\{, }
+    \pdfinfo{
+      /Author (\@author)
+      /Title (\@title)
+    }
+  }}
+  \begin{flushright}
+    {\rm\Huge\itk@HeaderFamily \@title} \par
+    {\em\large\itk@HeaderFamily \itk@release} \par
+    \vspace{25pt}
+    {\Large\itk@HeaderFamily \@author} \par
+    \vspace{25pt}
+    \@date \par
+    \itk@authoraddress \par
+  \end{flushright}
+  \@thanks
+  \setcounter{footnote}{0}
+  \let\thanks\relax\let\maketitle\relax
+  \gdef\@thanks{}\gdef\@author{}\gdef\@title{}
+}
+
+
+\let\itk@OldTableofcontents=\tableofcontents
+\renewcommand{\tableofcontents}{
+  \begingroup
+    \parskip = 0mm
+    \itk@OldTableofcontents
+  \endgroup
+  \itk@doHorizontalRule
+  \vspace{12pt}
+  \itk@doing@page@targetstrue
+}  
+
+% Fix the theindex environment to add an entry to the Table of
+% Contents; this is much nicer than just having to jump to the end of
+% the book and flip around, especially with multiple indexes.
+%
+\let\itk@OldTheindex=\theindex
+\renewcommand{\theindex}{
+  \clearpage
+  \itk@OldTheindex
+  \addcontentsline{toc}{section}{\indexname}
+}
+
+\@ifundefined{fancyhf}{
+  \pagestyle{plain}}{
+  \pagestyle{normal}}		% start this way; change for
+\pagenumbering{arabic}		% ToC & chapters
+\setcounter{secnumdepth}{2}
+
+\thispagestyle{empty}
--- a/Documentation/Latex/InsightManual.cls
+++ b/Documentation/Latex/InsightManual.cls
+%
+% InsightManual.cls for the Insight documentation
+%
+
+\NeedsTeXFormat{LaTeX2e}[1995/12/01]
+\ProvidesClass{InsightManual}
+             [1998/03/03 Document class (Insight manual)]
+
+\RequirePackage{InsightPaper}
+
+% Change the options here to get a different set of basic options, but only
+% if you have to.  Paper and font size should be adjusted in itkpaper.sty.
+%
+\LoadClass[\itk@paper,\itk@ptsize,twoside,openright]{report}
+
+\setcounter{secnumdepth}{2}
+
+% Optional packages:
+%
+% If processing of these documents fails at your TeX installation,
+% these may be commented out (independently) to make things work.
+% These are both supplied with the current version of the teTeX
+% distribution.
+%
+% The "fancyhdr" package makes nicer page footers reasonable to
+% implement, and is used to put the chapter and section information in 
+% the footers.
+%
+\RequirePackage{fancyhdr}\typeout{Using fancier footers than usual.}
+
+
+% Required packages:
+%
+% The "fncychap" package is used to get the nice chapter headers.  The
+% .sty file is distributed with Insight, so you should not need to disable
+% it.  You'd also end up with a mixed page style; uglier than stock LaTeX!
+%
+\RequirePackage[Bjarne]{fncychap}\typeout{Using fancy chapter headings.}
+% Do horizontal rules it this way to match:
+\newcommand{\itk@doHorizontalRule}{\mghrulefill{\RW}}
+%
+%
+% This gives us all the Insight-specific markup that we really want.
+% This should come last.  Do not change this.
+%
+\RequirePackage{Insight}
+
+% support for module synopsis sections:
+\newcommand{\itk@ModSynopsisFilename}{\jobname\thechapter.syn}
+\let\itk@OldChapter=\chapter
+\renewcommand{\chapter}{
+  \itk@ProcessModSynopsis
+  \itk@closeModSynopsisFile
+  \itk@OldChapter
+}
+
+
+% Change the title page to look a bit better, and fit in with the
+% fncychap ``Bjarne'' style a bit better.
+%
+\renewcommand{\maketitle}{%
+  \begin{titlepage}%
+    \let\footnotesize\small
+    \let\footnoterule\relax
+    \itk@doHorizontalRule%
+    \@ifundefined{pdfinfo}{}{{
+      % This \def is required to deal with multi-line authors; it
+      % changes \\ to ', ' (comma-space), making it pass muster for
+      % generating document info in the PDF file.
+      \def\\{, }
+      \pdfinfo{
+        /Author (\@author)
+        /Title (\@title)
+      }
+    }}
+    \begin{flushright}%
+      {\rm\Huge\itk@HeaderFamily \@title \par}%
+      {\em\LARGE\itk@HeaderFamily \itk@release \par}
+      \vfill
+      {\LARGE\itk@HeaderFamily \@author \par}
+      \vfill\vfill
+      {\large
+       \@date \par
+       \vfill
+       \itk@authoraddress \par
+      }%
+    \end{flushright}%\par
+    \@thanks
+  \end{titlepage}%
+  \setcounter{footnote}{0}%
+  \let\thanks\relax\let\maketitle\relax
+  \gdef\@thanks{}\gdef\@author{}\gdef\@title{}
+}
+
+
+% Catch the end of the {abstract} environment, but here make sure the
+% abstract is followed by a blank page if the 'openright' option is used.
+%
+\let\itk@OldEndAbstract=\endabstract
+\renewcommand{\endabstract}{
+  \if@openright
+    \ifodd\value{page}
+      \typeout{Adding blank page after the abstract.}
+      \vfil\pagebreak
+    \fi
+  \fi
+  \itk@OldEndAbstract
+}
+
+% This wraps the \tableofcontents macro with all the magic to get the
+% spacing right and have the right number of pages if the 'openright'
+% option has been used.  This eliminates a fair amount of crud in the
+% individual document files.
+%
+\let\itk@OldTableofcontents=\tableofcontents
+\renewcommand{\tableofcontents}{%
+  \setcounter{page}{1}%
+  \pagebreak%
+  \pagestyle{plain}%
+  {%
+    \parskip = 0mm%
+    \itk@OldTableofcontents%
+    \if@openright%
+      \ifodd\value{page}%
+        \typeout{Adding blank page after the table of contents.}%
+        \pagebreak\hspace{0pt}%
+      \fi%
+    \fi%
+    \cleardoublepage%
+  }%
+  \pagenumbering{arabic}%
+  \@ifundefined{fancyhf}{}{\pagestyle{normal}}%
+  \itk@doing@page@targetstrue%
+}
+% This is needed to get the width of the section # area wide enough in the
+% library reference.  Doing it here keeps it the same for all the manuals.
+%
+\renewcommand*\l@section{\@dottedtocline{1}{1.5em}{2.6em}}
+\renewcommand*\l@subsection{\@dottedtocline{2}{4.1em}{3.5em}}
+\setcounter{tocdepth}{1}
+
+
+% Fix the theindex environment to add an entry to the Table of
+% Contents; this is much nicer than just having to jump to the end of
+% the book and flip around, especially with multiple indexes.
+%
+\let\itk@OldTheindex=\theindex
+\renewcommand{\theindex}{
+  \cleardoublepage
+  \itk@OldTheindex
+  \addcontentsline{toc}{chapter}{\indexname}
+}
--- a/Documentation/Latex/InsightMarkup.sty
+++ b/Documentation/Latex/InsightMarkup.sty
+% Modified after the document  ltxmarkup.sty
+% Created by Fred L. Drake, Jr. <fdrake@acm.org>, as part of the
+% Python Documentation Project.
+%
+% Define some simple markup for the LaTeX command documentation:
+
+\ProvidesPackage{InsightMarkup}
+\RequirePackage{Insight}      % fulllineitems environment
+
+% These two macros are used in constructing the last parameter to the
+% envdesc and macrodesc environments.
+
+\newcommand{\itk@ltx@optparam}[1]{{[}\var{#1}{]}}
+\newcommand{\itk@ltx@param}[1]{\{\var{#1}\}}
+
+\newenvironment{envdesc}[2]{
+  \begin{fulllineitems}
+    \item[\code{\e begin\{{\bfseries #1}\}{%
+      \let\op=\itk@ltx@optparam%
+      \let\p=\itk@ltx@param%
+      \let\unspecified=\itk@unspecified%
+      \let\moreargs=\itk@moreargs%
+         #2}}]
+    \item[\code{\e end\{{\bfseries #1}\}}]
+    \index{#1 environment@\idxcode{#1} environment}
+    \index{environments!#1@\idxcode{#1}}
+}{\end{fulllineitems}}
+
+\newenvironment{macrodesc}[2]{
+  \begin{fulllineitems}
+    \item[\code{{\e\bfseries#1}{%
+      \let\op=\itk@ltx@optparam%
+      \let\p=\itk@ltx@param%
+      \let\unspecified=\itk@unspecified%
+      \let\moreargs=\itk@moreargs%
+      #2}}]
+    \index{#1@\idxcode{\e #1}}
+}{\end{fulllineitems}}
+
+\newcommand{\env}[1]{\code{#1}}
+\newcommand{\macro}[1]{\code{\e#1}}
--- a/Documentation/Latex/InsightPaper.sty
+++ b/Documentation/Latex/InsightPaper.sty
+%
+%  Change this to say a4paper instead of letterpaper if you want A4.  These
+%  are the latex defaults.
+%
+\newcommand{\itk@paper}{letterpaper}
+\newcommand{\itk@ptsize}{11pt}
+
+%  These set up the fonts for the documents.
+%
+%  The "times" package makes the default font the PostScript Times
+%  font, which makes for smaller PostScript and a font that more people 
+%  like.
+%
+%  The "avant" package causes the AvantGarde font to be used for
+%  sans-serif text, instead of the uglier Helvetica set up by the "times"
+%  package.
+%
+%\RequirePackage{avant}\typeout{Using AvantGarde instead of Computer Modern.}
+\RequirePackage{times}\typeout{Using Times instead of Computer Modern.}
--- a/Documentation/Latex/InsightSoftwareGuide.cls
+++ b/Documentation/Latex/InsightSoftwareGuide.cls