flrig/doxygen/make_docs.sh

#!/bin/bash
#
# A simple script for creating/archiving doxygen documentation for FLRig

PRG_NAME="flrig"

LATEX="0"
DOXY="0"
BUILD_PROG_DOCS="0"
BUILD_USER_DOCS="0"

if [ -z $1 ]; then
	BUILD_USER_DOCS="1"
else
	BUILD_USER_DOCS="0"
fi

help()
{
	echo ""
	echo "Use:"
	echo "   make_docs.sh <prog and/or user and/or help>"
	echo ""
	echo "default: user"
	echo "user: Generate user documentation"
	echo "prog: Generate programmer documentation"
	echo "help: This message"
	echo ""
}

rename_file()
{
	if [ -f "$1" ]; then
		mv "$1" "$2"
	fi
}

make_dir()
{
	echo "Make Dir: $1"

	if [ -d "$1" ]; then
		return
	fi

	mkdir "$1"
}

function check_dir()
{
	if [ -d "$1" ]; then
		echo "1"
		return
	fi

	echo "0"
}

function check_file()
{
	if [ -f "$1" ]; then
		echo "1"
		return
	fi

	echo "0"
}

check_doxy()
{
	RESULTS=$(check_file "$PWD/Doxyfile")

	if [ "$RESULTS" = "1" ]; then
		doxygen
	else
		echo "Doxyfile not found in directory $PWD"
	fi
}

check_doxy_exec()
{
	PROG_NAME=`which doxygen`
	EXEC_FILE=`basename $PROG_NAME`

	if [ "$EXEC_FILE" != "doxygen" ]; then
		echo "Install doxygen to build documentation"
		DOXY="0"
	else
		echo "Found $PROG_NAME"
		DOXY="1"
	fi
}

check_latex_exec()
{
	PROG_NAME=`which latex`
	EXEC_FILE=`basename $PROG_NAME`

	if [ "$EXEC_FILE" != "latex" ]; then
		echo "Install TeX/LaTeX to build pdf documentation"
		LATEX="0"
	else
		echo "Found $PROG_NAME"
		LATEX="1"
	fi
}

pdf_docs()
{
	if [ "$LATEX" = "1" ]; then

		OP_DIR="$1"

		RESULTS=$(check_dir "$OP_DIR")

		if [ "$RESULTS" = "1" ]; then
			cd $OP_DIR
			make
			rename_file "refman.pdf" "$2"
		fi
	fi
}

compress_html()
{
	if [ -z $1 ]; then
		return
	fi

	if [ -z $2 ]; then
		return
	fi

	TAR=`which tar`
	if [ -z $TAR ]; then
	    echo "***************************************"
		echo "* Compression program 'tar' not found *"
	    echo "***************************************"
		return
	fi

	SAVE_NAME="compressed_html/$1_html.tar.bz2"

	cd "../../doc"

	COMP_DIR="$2/html/"

	RESULTS=$(check_dir "$COMP_DIR")

	if [ "$RESULTS" = "1" ]; then
		$TAR -cvjf "$SAVE_NAME" "$COMP_DIR"
	fi
}

for var in "$@"
do
	case "$var" in
		prog)
			BUILD_PROG_DOCS="1"
			;;
		PROG)
			BUILD_PROG_DOCS="1"
			;;
		USER)
			BUILD_USER_DOCS="1"
			;;
		user)
			BUILD_USER_DOCS="1"
			;;
		*)
			help
			exit
			;;
	esac
done

check_doxy_exec

if [ "$DOXY" != "1" ]; then
	echo "**************************************"
	echo "* Install Doxygen to build documents *"
	echo "**************************************"
	exit
fi

check_latex_exec

if [ "$LATEX" != "1" ]; then
	echo "********************************************"
	echo "* Install TeX/LaTeX to build PDF documents *"
	echo "********************************************"
fi


SCRIPT_PATH="$PWD/make_docs.sh"

echo "Looking for Script: $SCRIPT_PATH"

if [ -f "$SCRIPT_PATH" ]; then
	make_dir "../doc"
	make_dir "../doc/pdf"
	make_dir "../doc/compressed_html"
	make_dir "../doc/programmer_docs"
	make_dir "../doc/user_docs"

else
	echo "***********************************************************************"
	echo "* Change Directory to the ./make_doc.sh location then execute script. *"
	echo "***********************************************************************"
	exit
fi

# User Manual
if [ $BUILD_USER_DOCS -eq "1" ]; then
(
	cd user_src_doc
	check_doxy
	( compress_html "${PRG_NAME}_help" "user_docs")
	pdf_docs "../../doc/user_docs/latex" "../../pdf/${PRG_NAME}_help.pdf"
)
fi

# Programmers Code Reference
if [ $BUILD_PROG_DOCS -eq "1" ]; then
(
	cd prog_src_doc
	check_doxy
	( compress_html "${PRG_NAME}_Code_Reference" "programmer_docs" )
	pdf_docs "../../doc/programmer_docs/latex" "../../pdf/${PRG_NAME}_Code_Reference.pdf"
)
fi