source: palm/trunk/SCRIPTS/generate_documentation @ 4625

#!/bin/bash
#--------------------------------------------------------------------------------#
# This file is part of the PALM model system.
#
# PALM is free software: you can redistribute it and/or modify it under the terms
# of the GNU General Public License as published by the Free Software Foundation,
# either version 3 of the License, or (at your option) any later version.
#
# PALM is distributed in the hope that it will be useful, but WITHOUT ANY
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
# A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along with
# PALM. If not, see <http://www.gnu.org/licenses/>.
#
# Copyright 1997-2020  Leibniz Universitaet Hannover
#--------------------------------------------------------------------------------#
#
# Current revisions:
# ------------------
# 
# 
# Former revisions:
# -----------------
# $Id: generate_documentation 4481 2020-03-31 18:55:54Z oliver.maas $
# Corrected "Former revisions" section
# svn propset keyword
# 
# 
#
# 2696 2017-12-14 17:12:51Z kanani
# Change in file header (GPL part)
# 
# 1714 knoop
# Initial revision
# 
#--------------------------------------------------------------------------------#
# generate_documentation - script for generating the PALM code documentation
#--------------------------------------------------------------------------------#
SOURCE="${BASH_SOURCE[0]}"
while [ -h "$SOURCE" ]; do # resolve $SOURCE until the file is no longer a symlink
  DIR="$( cd -P "$( dirname "$SOURCE" )" && pwd )"
  SOURCE="$(readlink "$SOURCE")"
  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE" # if $SOURCE was a relative symlink, we need to resolve it relative to the path where the symlink file was located
done
SCRIPT_LOCATION="$( cd -P "$( dirname "$SOURCE" )" && pwd )"

working_dir=$(readlink -f "${SCRIPT_LOCATION}/../../")

echo "Generating PALM source code documentation..."


doc_dir=$working_dir/documentation

# Checking for doxygen
if type -t doxygen; then

   # Removing old documentation
   if [[ -d $doc_dir ]];then
      echo "Remove old documentation"
      rm -r $doc_dir
   fi
   # Generating HTML documentation
   echo "found doxygen. Continuing..."
   cd $SCRIPT_LOCATION
   doxygen palm2doxygen.config
   if [[ $? -ne 0 ]];then
      echo "doxygen detected an error."
      exit 1
   fi
   cd $doc_dir
   doc_dir=$(pwd)
   ln -s $(pwd)/html/index.html PALM_doc.html
   echo "HTML source code documentation generated."
   
   # Checking for pdflatex
   if type -t pdflatex; then
   
      # Generating PDF documentation
      cd $doc_dir/latex
      make pdf
      cd $doc_dir
      ln -s $(pwd)/latex/refman.pdf PALM_doc.pdf
      echo "PDF source code documentation generated."
   
   else
      echo "ERROR: pdflatex not found."
      echo "Skipping PDF documentation generation. Terminating!"
      exit 1
   fi
else
   echo "ERROR: doxygen not found."
   echo "Skipping PALM documentation generation. Terminating!"
   exit 1
fi

echo "The PALM source code documentation is located in: $doc_dir"
echo "Done."