#!/bin/bash
#
# manual_deleteEntry.sh -- This function removes a documentation entry
# from documentation directory structure.
#
# 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_deleteEntry {
 
    local ENTRIES=''
    local ENTRYSTATUS=''
    local LOCATION=''
 
    # Check if the entry has been already removed.
    cli_checkFiles $ENTRY 'f'
 
    # Define root location to look for entries.
    LOCATION=$(echo $ENTRY | sed -r 's!\.texi$!!')
 
    # Redefine location to match the chapter's root directory. This
    # applies when you try to remove the whole chapter from the
    # working copy (e.g., centos-art manual --delete=/home/centos/artwork/trunk/).
    if [[ $ENTRY =~ "chapter-intro\.texi$" ]];then
        LOCATION=$(dirname "$ENTRY")
    fi
 
    # Define list of dependent entries. Dependent entries are stored
    # inside a directory with the same name of the entry you are
    # trying to remove. If such directory location doesn't exists, the
    # related entry doesn't have dependent entries either.
    if [[ -d $LOCATION ]];then
        ENTRIES=$(cli_getFilesList $LOCATION ".*\.texi")
    fi
    
    # Add entry being currently processed to list of files to precess.
    ENTRIES="${ENTRIES} ${ENTRY}"
 
    # Remove duplicated lines from entries list, be sure there is just
    # one path per line and they are ordered in reverse. At this
    # point, it is hard to find duplicated lines since the list of
    # entries is built from files and it is not possible to have two
    # files in the very same directory using the same name exactly, so
    # this could be considered a bit paranoid. ~:-)
    ENTRIES=$(echo "$ENTRIES" | tr ' ' "\n" | sort -r | uniq)
 
    # Print action preamble.
    cli_printActionPreamble "$ENTRIES" 'doDelete' 'AsResponseLine'
 
    # Process list of entries.
    for ENTRY in $ENTRIES;do
 
        # Define the versioning status of entry.
        if [[ -d $(dirname $ENTRY)/.svn ]];then
            ENTRYSTATUS=$(cli_getRepoStatus "$ENTRY")
        else
            # At this point we don't know what the entry versioning
            # status is, so consider the entry an unversion file.
            ENTRYSTATUS='?'
        fi
 
        # Verify entry inside the working copy. 
        if [[ "$ENTRYSTATUS" =~ '^(\?)?$' ]];then
 
            # Print action message.
            cli_printMessage "$ENTRY" "AsDeletingLine"
 
        else
 
            # Do not remove a versioned documentation entry with
            # changes inside. Print a message about it and stop script
            # execution instead.
            cli_printMessage "`gettext "There are changes that need to be committed first."`" 'AsErrorLine'
            cli_printMessage "$(caller)" 'AsToKnowMoreLine'
 
        fi
 
        # Remove documentation entry. At this point, documentation
        # entry can be under version control or not versioned at all.
        # Here we need to decide how to remove documentation entries
        # based on whether they are under version control or not.
        if [[ "$ENTRYSTATUS" == ' ' ]];then
 
            # Documentation entry is under version control and there
            # is no change to be committed up to central repository.
            # We are safe to schedule it for deletion.
            svn del "$ENTRY" --quiet
 
        elif [[ "$ENTRYSTATUS" == '?' ]];then
 
            # Documentation entry is not under version control, so we
            # don't care about changes inside it. If you say
            # centos-art.sh script to remove an unversion
            # documentation entry it will do so, using convenctional
            # `rm' command.
            rm -r "$ENTRY"
 
        fi
 
        # Remove entry on section's menu and nodes to reflect the
        # fact that documentation entry has been removed.
        manual_updateMenu "remove-entry"
        manual_updateNodes
 
        # Remove entry cross references from documentation manual.
        manual_deleteCrossReferences
 
    done
 
    # Update chapter's menu and nodes in the master texinfo document.
    # This is mainly applied when one of the chapters (e.g., trunk/,
    # tags/, or branches/) is removed.
    if [[ ! -d $MANUAL_DIR_CHAPTER ]];then
        manual_updateChaptersMenu 'remove-entry'
        manual_updateChaptersNodes
    fi
 
    # Update documentation output-related files.
    manual_updateOutputFiles
 
}