#!/bin/bash
#
# texinfo_updateSectionMenu.sh -- This function updates the section's
# menu definition file of a chapter. If this function is called with
# the '--delete-entry' string as first argument, the menu line related
# to the entry being processed is removed. Otherwise, if this function
# is called with the '--add-entry' string as first argument, the menu
# line related to the entry being processed is added to menu's bottom.
# If no argument is passed to this function, the '--add-entry' action
# is assumed.
#
# Copyright (C) 2009, 2010, 2011 The CentOS Artwork SIG
#
# 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 texinfo_updateSectionMenu {
# Specify which action to do with documentation entry inside the
# chapter menu.
local ACTION="$1"
# Build node information used inside chapter menu.
local MENUNODE=$(${FLAG_BACKEND}_getEntryNode "$MANUAL_ENTRY")
# Define menu entry using texinfo style and node information as
# reference.
local MENULINE="* ${MENUNODE}::"
# Retrive list of menu entries from chapter menu and exclude
# `@menu', `@end menu' and empty lines from output.
local MENU=$(cat $MANUAL_CHAPTER_DIR/chapter-menu.${MANUAL_EXTENSION} \
| egrep -v '^[[:space:]]*$' | egrep -v '^@(end )?menu')
# Re-defined chapter menu entries based on action provided to this
# function as first positional parameter.
case $ACTION in
--delete-entry )
# Remove menu entry from chapter menu.
MENU=$(echo "$MENU" | egrep -v "$MENULINE")
;;
--add-entry | * )
# Add menu entry to chapter menu list as last entry.
MENU="$MENU
$MENULINE"
;;
esac
# Remove opening spaces/tabs and empty lines from final menu
# entries.
MENU=$(echo "$MENU" | sed -r 's!^[[:space:]]+!!g' \
| egrep -v '^[[:space:]]*$')
# Define order of menu entries based on sort option provided to
# `centos-art.sh' script on the command-line. When no sort option
# is provided, the menu entry creation order is used as default.
# Notice that, once you've sorted the menu, it is hard to sort the
# list back to former creation order. Go sorted or not sorted at
# all to use creation order.
case $FLAG_SORT in
'ordered' )
MENU="$(echo "$MENU" | sort )"
;;
'reversed' )
MENU="$(echo "$MENU" | sort -r )"
;;
esac
# Rebuild list of chapter menu entries including '@menu' and '@end
# menu' lines back into chapter menu.
MENU="@menu
$MENU
@end menu"
# Remove opening spaces/tabs and empty lines from final menu
# structure.
MENU=$(echo "$MENU" | sed -r 's!^[[:space:]]+!!g' \
| egrep -v '^[[:space:]]*$')
# Dump chapter menu entries back into chapter's menu definition
# file.
echo "$MENU" > $MANUAL_CHAPTER_DIR/chapter-menu.${MANUAL_EXTENSION}
}