doxygen.sh

Go to the documentation of this file.

#!/usr/bin/env zsh
#
#--------------------------------------------------------------------------------------
#
#                Utility script for generation of HTML Doxygen main page.
#
#--------------------------------------------------------------------------------------
# \author mdejong
#
script=${0##*/}
 
if [ -z $JPP_DIR ]; then
    echo "Variable JPP_DIR undefined."
    exit 1
fi
 
source $JPP_DIR/setenv.sh $JPP_DIR >& /dev/null
 
if do_usage $*; then
    usage "$script"
fi
 
setopt +o nomatch
 
set_variable NUMBER_OF_COLUMNS   3
set_variable WORKDIR             `mktemp -d ${TMPDIR:-/tmp}/XXXXXX`
 
#
function findapps()
{
    find  $*  -mindepth 1  -executable  ! -regex ".*\.\‍(\‍(\|c\|z\‍)sh\|py\‍)"  -printf "%f\n"  |  sort
}
 
#
function findscripts()
{
    find  $*  -mindepth 1  -executable    -regex ".*\.\‍(\‍(\|c\|z\‍)sh\|py\‍)"  -printf "%f\n"  |  sort
}
 
#
function findexamples()
{
    find  $*  -mindepth 1  -executable  |  sort
}
 
#
# Method to get file name of source code.
#
# \param  1       executable file
# \return         source     file
#
function get_source()
{
    file=`which $1 2> /dev/null`
 
    if [[ -n "${file}" && -x ${file} ]]; then
        if [[ $file == *\.((|c|z)sh|py) ]]; then
            source=${file}
        else
            source=`${file} -v 2> /dev/null | sed -n 's/source: *//p'`
        fi
    else
        source=$1
    fi
 
    echo ${source:a}
}
 
 
echo "/**"
echo " * \mainpage Documentation"
echo " * \htmlonly"
echo " * <style>"
echo " * ul.b { list-style-type: none; counter-reset: section; columns: ${NUMBER_OF_COLUMNS}; -moz-column-count: ${NUMBER_OF_COLUMNS}; -webkit-column-count: ${NUMBER_OF_COLUMNS}; column-count: ${NUMBER_OF_COLUMNS}; }"
echo " * </style>"
 
# Documents
 
echo " * <hr>"
echo " * <h2>Documents</h2>"
echo " * <ul class=\"b\">"
for file in `ls ${JPP_DOC}/*`; do
    if [ -f ${file} ]; then
            echo " * <li><a href=\"${file##*/}\">${file##*/}</a></li>"
    fi
done
echo " * </ul>"
 
 
# Applications header
 
echo " * <hr>"
echo " * <h2>Applications</h2>"
echo " * <ul class=\"b\">"
for file in `findapps ${JPP_BIN}`; do
    echo " * <li><a href=\"#${file}\">${file}</a></li>"
done
echo " * </ul>"
 
 
# Scripts header
 
echo " * <hr>"
echo " * <h2>Scripts</h2>"
echo " * <ul class=\"b\">"
for file in `findscripts ${JPP_BIN}`; do
    echo " * <li><a href=\"#${file}\">${file}</a></li>"
done
echo " * </ul>"
 
 
# Examples header
 
echo " * <hr>"
echo " * <h2>Examples</h2>"
echo " * <ul class=\"b\">"
for dir in `ls $JPP_DIR/examples`; do
 
    if [[ -d $JPP_DIR/examples/${dir} ]]; then
            echo " * <li><a href=\"#examples/${dir}\">${dir}</a></li>"
    fi
done
echo " * </ul>"
 
 
# Applications data
 
function makeapp()
{
    file=$1
 
    source=`get_source ${file}`
 
    echo " * <hr>"
    echo " * <h4 id=\"${file}\">"
    if [[ -n "${source}" ]]; then
        if (`ls $JPP_DIR/examples/*/${source:t} >& /dev/null`); then
                source=${source##${JPP_DIR:a}/}
        else
                source=${source:t}
        fi
            echo " * \\\\endhtmlonly"
            echo " * ${source}"
            echo " * \htmlonly"
    else
            echo " * ${file}"
    fi
    echo " * </h4>"
    echo " * <pre>"
    ${file} -h! 2> /dev/null | sed 's/</\&lt;/g;s/>/\&gt;/g'
    echo " * </pre>"
    echo " * <a href="index.html">Go back to main page.</a>"
}
 
FS=()
 
for file in `findapps ${JPP_BIN}`; do
 
    makeapp $file > $WORKDIR/${file:t}.txt &
 
    FS+=(${file:t}.txt)
done
 
if (( ${#FS} > 0 )); then
 
    wait
 
    cat   $WORKDIR/${^FS}
    rm -f $WORKDIR/${^FS} >& /dev/null
fi
 
 
# Scripts data
 
function makescript()
{
    file=$1
 
    source=`eval ls $JPP_DIR/software/*/$file`
 
    echo " * <hr>"
    echo " * <h4 id=\"${file}\">"
    if [[ -n "${source}" ]]; then
        if (`ls $JPP_DIR/examples/*/${source:t} >& /dev/null`); then
                source=${source##${JPP_DIR:a}/}
        else
                source=${source:t}
        fi
            echo " * \\\\endhtmlonly"
            echo " * ${source}"
            echo " * \htmlonly"
    else
            echo " * ${file}"
    fi
    echo " * </h4>"
    echo " * <pre>"
    ${file} -h! 2> /dev/null | sed 's/</\&lt;/g;s/>/\&gt;/g'
    echo " * </pre>"
    echo " * <a href="index.html">Go back to main page.</a>"
}
 
FS=()
 
for file in `findscripts ${JPP_BIN}`; do
 
    makescript $file > $WORKDIR/${file:t}.txt &
 
    FS+=(${file:t}.txt)
done
 
if (( ${#FS} > 0 )); then
 
    wait
 
    cat   $WORKDIR/${^FS}
    rm -f $WORKDIR/${^FS} >& /dev/null
fi
 
 
# Examples data
 
function makeexample()
{
    file=$1
 
        if [[ ! $file = *.sh && ! $file = *.csh ]]; then
                source=`get_source ${file}`
        else
                source=$file
        fi
 
        echo " * <hr>"
        echo " * <h4 id=\"${file}\">"
        if [[ -n "${source}" ]]; then
                if   (`ls ${JPP_DIR}/software/*/${source:t} >& /dev/null`); then
                    source=${source##${JPP_DIR:a}/}
                elif (( `ls ${JPP_DIR}/examples/*/${source:t} | wc -l` > 1 )); then
                    source=${source##${JPP_DIR:a}/examples/}
                else
                    source=${source:t}
                fi
                echo " * \\\\endhtmlonly"
                echo " * ${source}"
                echo " * \htmlonly"
        else
                echo " * ${file}"
        fi
        echo " * </h4>"
        echo " * <pre>"
        ${file} -h! 2>&1 | sed 's/</\&lt;/g;s/>/\&gt;/g'
        echo " * </pre>"
        echo " * <a href="index.html">Go back to main page.</a>"
}
 
for dir in `ls $JPP_DIR/examples`; do
 
    if [[ -d $JPP_DIR/examples/${dir} ]]; then
 
            echo " * <hr>"
            echo " * <h4 id=\"examples/${dir}\">${dir}</h4>"
            echo " * <ul class=\"b\">"
            for file in `findexamples $JPP_DIR/examples/${dir}`; do
                echo " * <li><a href=\"#${file}\">${file:t}</a></li>"
            done
            echo " * </ul>"
            echo " * <a href="index.html">Go back to main page.</a>"
 
        FS=()
 
            for file in `findexamples $JPP_DIR/examples/${dir}/`; do
 
            makeexample $file > $WORKDIR/${file:t}.txt &
 
            FS+=(${file:t}.txt)
        done
 
        if (( ${#FS} > 0 )); then
 
            wait
 
            cat   $WORKDIR/${^FS}
            rm -f $WORKDIR/${^FS} >& /dev/null
        fi
    fi
done
 
 
echo " * \\\\endhtmlonly"
echo " */"
 
rm -rf $WORKDIR >& /dev/null