#!/bin/bash
#
# locale.sh -- This function provides internationalization features
# for centos-art.sh script through GNU gettext standard processes.
#
# Copyright (C) 2009, 2010, 2011 The CentOS Project
#
# 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., 675 Mass Ave, Cambridge, MA 02139, USA.
#
# ----------------------------------------------------------------------
# $Id$
# ----------------------------------------------------------------------

function locale {

    # Verify current locale information to avoid English messages from
    # being localized to themselves.  The English language is used as
    # reference to write translatable strings inside the source files.
    if [[ $(cli_getCurrentLocale) =~ '^en' ]];then
        cli_printMessage "`gettext "The English language cannot be localized to itself."`" --as-error-line
    fi

    local ACTIONNAMS=''
    local ACTIONNAM=''
    local ACTIONVAL=''

    # Initialize machine object flag (`--dont-create-mo').  This flag
    # controls whether the centos-art.sh script does create/update
    # machine object (MO) files from related portable object (PO)
    # files or not. By default, MO files are created.
    local FLAG_DONT_CREATE_MO='false'

    # Define localization (l10n) base directory. This is the place
    # where all translation messages are organized in. Translation
    # messages are organized herein using the same layout of the
    # components they represent under the `trunk/Identity',
    # `trunk/Manuals' or `trunk/Scripts' directory structures.  The
    # localization base directory must be used as source location for
    # subversion operations (e.g., status, update, commit, etc.).
    # Otherwise, it would be difficult to add directory structures
    # that have several levels down from the localization base
    # directory up to the repository (e.g., it is not possible in
    # subversion to add a directory which parent directory hasn't been
    # added to the repository previously.).
    L10N_BASEDIR="$(cli_getRepoTLDir)/Locales"

    # Interpret arguments and options passed through command-line.
    locale_getOptions

    # Redefine positional parameters using ARGUMENTS. At this point,
    # option arguments have been removed from ARGUMENTS variable and
    # only non-option arguments remain in it. 
    eval set -- "${ARGUMENTS}"

    # Syncronize changes between repository and working copy. At this
    # point, changes in the repository are merged in the working copy
    # and changes in the working copy committed up to repository.
    cli_syncroRepoChanges "${L10N_BASEDIR}"

    # Loop through non-option arguments passed to centos-art.sh script
    # through its command-line.
    for ACTIONVAL in "$@";do

        # Sanitate non-option argument to be sure it matches the
        # directory convenctions stablished by centos-art.sh script
        # against source locations in the working copy.
        ACTIONVAL=$(cli_checkRepoDirSource "${ACTIONVAL}")

        # Verify directory passed as non-option argument to be sure it
        # supports localization.
        if [[ ! $(cli_isLocalized "${ACTIONVAL}") == 'true' ]];then
            cli_printMessage "`gettext "The path provided does not support localization."`" --as-error-line
        fi

        # Define localization working directory using directory passed
        # as non-option argument. The localization working directory
        # is the place where POT and PO files are stored inside the
        # working copy.
        L10N_WORKDIR=$(echo "${ACTIONVAL}" \
            | sed -r -e "s!trunk/(Identity|Scripts|Manuals)!trunk/Locales/\1!")/$(cli_getCurrentLocale)

        # Execute localization actions provided to centos-art.sh
        # script through its command-line. Notice that localization
        # actions will be executed in the same order they were
        # provided in the command-line.
        for ACTIONNAM in ${ACTIONNAMS};do
            ${ACTIONNAM}
        done

    done

    # Syncronize changes between repository and working copy. At this
    # point, changes in the repository are merged in the working copy
    # and changes in the working copy committed up to repository.
    cli_syncroRepoChanges "${L10N_BASEDIR}"

}