#!/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 {

    # Verify language layout.
    manual_checkLanguageLayout

    # 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 )

                # Define action value passed through the command-line.
                ACTIONVAL="$2"

                # Define action name using action value as reference.
                ACTIONNAM="${FUNCNAM}_searchNode"

                # Rotate positional parameters.
                shift 2
                ;;

            --search )

                # Define action value passed through the command-line.
                ACTIONVAL="$2"

                # Define action name using action value as reference.
                ACTIONNAM="${FUNCNAM}_searchIndex"

                # Rotate positional parameters.
                shift 2
                ;;
    
            --edit )

                # Define action value passed through the command-line.
                ACTIONVAL="$2"

                # Define action name using action value as reference.
                ACTIONNAM="${FUNCNAM}_editEntry"

                # Rotate positional parameters.
                shift 2
                ;;
    
            --delete )

                # Define action value passed through the command-line.
                ACTIONVAL="$2"

                # Define action name.
                ACTIONNAM="${FUNCNAM}_deleteEntry"

                # Rotate positional parameters.
                shift 2
                ;;
    
            --update )

                # Execute action name. There is no need of action
                # value here, so let's execute the action right now.
                manual_updateOutputFiles

                # End script execution flow. There is nothing else to
                # do after updating documentation output.
                exit
                ;;
    
            --copy )

                # Define action value passed through the command-line.
                ACTIONVAL="$2"

                # Define action name using action value as reference.
                ACTIONNAM="${FUNCNAM}_copyEntry"

                # Rotate positional parameters.
                shift 2
                ;;

            --to )
                
                # Redefine target flag.
                FLAG_TO="$2"

                # Rotate positional parameters.
                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 directory used to store chapter's 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? 
    #
    # One solution would be: to use three chapters only to represent
    # the repository's first level structure (i.e., trunk,
    # branches, and tags) and handle everything else as sections. Sub
    # and subsub section will not have their own files, they will be
    # written inside section files instead.
    ENTRYCHAPTER=$(echo $ENTRY | cut -d / -f-10)

    # Define chapter name for this documentation entry.
    CHAPTERNAME=$(basename "$ENTRYCHAPTER")

    # Syncronize changes between the working copy and the central
    # repository to bring down changes.
    cli_commitRepoChanges ${MANUALS_DIR[0]}

    # 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 "${MANUALS_DIR[0]}"

}