#!/bin/bash
#
# manual_getActions.sh -- This function interpretes arguments passed
# to `manual' functionality and calls actions accordingly.
#
# Copyright (C) 2009-2011 Alain Reguera Delgado
# 
# This program 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 2 of the
# License, or (at your option) any later version.
# 
# This program 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 this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
# USA.
# 
# ----------------------------------------------------------------------
# $Id$
# ----------------------------------------------------------------------

function manual_getActions {

    # Define short options we want to support.
    local ARGSS=""

    # Define long options we want to support.
    local ARGSL="read:,search:,edit:,delete:,update:,copy:,to:"

    # Parse arguments using getopt(1) command parser.
    cli_doParseArguments

    # Reset positional parameters using output from (getopt) argument
    # parser.
    eval set -- "$ARGUMENTS"

    # Define action to take for each option passed.
    while true; do
        case "$1" in

            --read )
                ACTIONVAL="$2"
                ACTIONNAM="${FUNCNAM}_searchNode"
                shift 2
                ;;

            --search )
                ACTIONVAL="$2"
                ACTIONNAM="${FUNCNAM}_searchIndex"
                shift 2
                ;;
    
            --edit )
                ACTIONVAL="$2"
                ACTIONNAM="${FUNCNAM}_editEntry"
                shift 2
                ;;
    
            --delete )
                ACTIONVAL="$2"
                ACTIONNAM="${FUNCNAM}_deleteEntry"
                shift 2
                ;;
    
            --update )
                ACTIONVAL="$2"
                ACTIONNAM="${FUNCNAM}_updateOutputFiles"
                shift 2
                ;;
    
            --copy )
                ACTIONVAL="$2"
                ACTIONNAM="${FUNCNAM}_copyEntry"
                shift 2
                ;;

            --to )
                FLAG_TO="$(manual_getEntry "$2")"
                shift 2
                ;;

            * )
                # Break options loop.
                break
        esac
    done

    # Check action value passed through the command-line using source
    # directory definition as reference.
    cli_checkRepoDirSource

    # Define documentation entry.
    ENTRY=$(manual_getEntry)

    # Define documentation entry directory. This is the directory
    # where the entry file is stored.
    ENTRY_DIR=$(dirname ${ENTRY} | sed -r 's!\.texi$!!')

    # Define documentation entry file (without extension).
    ENTRY_FILE=$(basename ${ENTRY} | sed -r 's!\.texi$!!')

    # Define directory for documentation manual. This is the place the
    # specific documentation manual we are working with is stored in.
    MANUAL_DIR=$(echo $ENTRY | cut -d / -f-7)

    # Define file name for documentation manual. This is the file used
    # to initiate the structure of documentation manual.
    MANUAL_NAME=$(cli_getRepoName ${MANUAL_DIR} 'f')

    # Define directory to store documentation entries.  At this point,
    # we need to take a desition about documentation design, in order
    # to answer the question: How do we assign chapters, sections and
    # subsections automatically, based on the repository structure?
    # and also, how such design could be adapted to changes in the
    # repository structure?
    #
    # One solution would be: represent the repository's first level
    # structure in three chapters only (i.e., trunk, branches, and
    # tags) and handle everything else inside them as sections. Sub
    # and subsub section will not have their own files, they will be
    # written inside section files instead.
    MANUAL_DIR_CHAPTER=$(echo $ENTRY | cut -d / -f-8)

    # Define chapter name for the documentation entry we are working
    # with.
    MANUAL_CHA_NAME=$(basename "$MANUAL_DIR_CHAPTER")

    # Define base name for documentation manual files (without
    # extension). This is the main file name used to build texinfo
    # related files (.info, .pdf, .xml, etc.).
    MANUAL_BASEFILE=$(cli_getFilesList "${MANUAL_DIR}" ".*${MANUAL_NAME}\.texi" | sed 's!\.texi$!!' )

    # Set action preable.
    cli_printActionPreamble "${MANUAL_BASEFILE}.texi"

    # Syncronize changes between the working copy and the central
    # repository to bring down changes.
    cli_commitRepoChanges ${MANUAL_DIR}

    # Execute action name.
    if [[ $ACTIONNAM =~ "^${FUNCNAM}_[A-Za-z]+$" ]];then
        eval $ACTIONNAM
    else
        cli_printMessage "`gettext "A valid action is required."`" 'AsErrorLine'
        cli_printMessage "$(caller)" 'AsToKnowMoreLine'
    fi

    # Syncronize changes between the working copy and the central
    # repository to commit up changes.
    cli_commitRepoChanges ${MANUAL_DIR}

}