source: trunk/docs/docs_dev/makefile_non_sphinx @ 2

#+
# .. _makefile_non_sphinx:
#
# ===================
# makefile_non_sphinx
# ===================
#
# DESCRIPTION
# ===========
#
# génération des manuels à partir des fichiers non assimilables directement
# par sphinx 
#
# SEE ALSO
# ========
# 
# :ref:`builddoc`
#
# :ref:`Makefile`
#
# :ref:`extract_rst.sh <fptools:extract_rst.sh>`
#
# :ref:`for_doc.sh`
#
# TODO
# ====
#
# improve dependencies
#
# autodoc not ok may be see  autodoc-process-docstring 
#
# sort pb within index_manuals for matlab scripts because severals
# directories. and for probably the same reason no next/previous
# continuation
#
# IDL and matlab in man_troff
#
# EVOLUTIONS
# ==========
#
# $Id: makefile_non_sphinx 532 2012-04-18 12:44:46Z pinsard $
#
# $URL$
#
# - fplod 20120424
#   
#   * creation
#
#-
#
LIST_SRCSH = \
$(shell find ../.. ! \( -name '.svn' -prune \) -name "*.sh"; \
        echo "Makefile"; \
        echo "makefile_non_sphinx" \
        | sort)

LIST_SRCSH_RST = \
        $(shell echo "$(LIST_SRCSH)" | \
        sed -e "s+../../adm+source/manuals/+g" \
        -e "s+../../src+source/manuals/+g" \
        -e "s+../../docs/docs_dev+source/manuals/+g" \
        -e "s+Makefile+source/manuals/Makefile.rst+g" \
        -e "s+makefile_non_sphinx+source/manuals/makefile_non_sphinx.rst+g" \
        -e "s+\.sh+.sh.rst+g")

LIST_SRCIDL = \
$(shell find ../.. ! \( -name '.svn' -prune \) -name "*.pro" | sort)

LIST_SRCIDL_RST = \
$(shell echo "$(LIST_SRCIDL)" | \
        sed -e "s+\.\./\.\./src+source/manuals/+g" \
            -e "s+\.\./\.\.+source/manuals/+g" \
            -e "s+\.pro+.pro.rst+g")

LIST_SRCMATLAB = \
$(shell find ../.. ! \( -name '.svn' -prune \) -name "*.m" | \
        grep -v external_matlab | sort)

LIST_SRCMATLAB_RST = \
$(shell echo "$(LIST_SRCMATLAB)" | \
        sed \
            -e "s+../../src/+source/manuals/+g" \
            -e "s+\.m+.m.rst+g")

LIST_SRCFERRET = \
$(shell find ../.. ! \( -name '.svn' -prune \) -name "*.jnl" | sort)

LIST_SRCFERRET_RST = \
$(shell echo "$(LIST_SRCFERRET)" | \
        sed -e "s+../../src/+source/manuals/+g" \
            -e "s+\.jnl+.jnl.rst+g")

LIST_RST = \
$(shell echo $(LIST_SRCSH_RST) \
$(LIST_SRCIDL_RST) \
$(LIST_SRCFERRET_RST) \
$(LIST_SRCODV_RST) \
$(LIST_SRCMATLAB_RST) | tr ' ' '\n' | sort | tr '\n' ' ')

.PHONY : \
help \
clean \
all

help :
        @echo "Following commands are available to build outputs :"
        @echo "\$$ make -f makefile_non_sphinx clean"
        @echo "\$$ make -f makefile_non_sphinx all"

clean :
        -@rm source/manuals/myimage*.png
        -@rm $(LIST_RST) 2> /dev/null
        -@rm source/manuals/manuals_non_sphinx.rst 2> /dev/null

all : \
source/manuals/manuals_non_sphinx.rst \
$(LIST_RST)
        @for_doc.sh

source/manuals/manuals_non_sphinx.rst : \
$(LIST_RST)
        @echo ".. _manuals_non_sphinx:" > $@
        @echo " " >> $@
        @echo " " >> $@
        @echo "non sphinx manuals" | tr [:print:] = >> $@
        @echo "non sphinx manuals" >> $@
        @echo "non sphinx manuals" | tr [:print:] = >> $@
        @echo " " >> $@
        @echo ".. toctree::" >> $@
        @echo "   :maxdepth: 1" >> $@
        @echo "   :glob:" >> $@
        @echo " " >> $@
        @echo $(LIST_RST)
        @for file in $(LIST_RST); \
        do \
                echo "   $$(basename $${file} .rst)"; \
                echo " "; \
        done >> $@
        @echo " " >> $@

source/manuals/%.sh.rst : ../../src/%.sh
        @extract_rst.sh -i $< -l sh -o $@

source/manuals/%.sh.rst : ../../adm/%.sh
        @extract_rst.sh -i $< -l sh -o $@

source/manuals/makefile_non_sphinx.rst : ../../docs/docs_dev/makefile_non_sphinx
        @extract_rst.sh -i $< -l sh -o $@

source/manuals/Makefile.rst : ../../docs/docs_dev/Makefile
        @extract_rst.sh -i $< -l sh -o $@

source/manuals/%.pro.rst : ../../src/%.pro
        @extract_rst.sh -i $< -l IDL -o $@

source/manuals/%.pro.rst : ../../%.pro
        @extract_rst.sh -i $< -l IDL -o $@

source/manuals/%.m.rst : ../../src/%.m 
        @extract_rst.sh -i $< -l matlab -o $@

source/manuals/%.jnl.rst : ../../src/%.jnl  
        @extract_rst.sh -i $< -l ferret -o $@