#!/bin/bash

#

# docbook_expandLicenses.sh -- This function modifies the final

# DocBook instance to add license information. We are doing this way

# because using XInclude doesn't work and we want to reuse license

# information in all documents. So, if we cannot link the files, we

# modify the final instance and append the license information to it.

# Later, to reuse translation messages, the locale functionality takes

# care of merging po files related to licenses into documentation po

# file so changes made to licenses translations will also be available

# to documentation manuals in different languages.

#

# Copyright (C) 2009, 2010, 2011, 2012 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 docbook_expandLicenses {

    local INSTANCE=$1

    # Define absolute path to Docbook models.

    local DOCBOOK_MODELS="${TCAR_WORKDIR}/trunk/Documentation/Models/Docbook"

    # Define list of files holding licenses you want to include. Note

    # even this files are not inside the documentation structure

    # itself, they are connected with it. The files holding license

    # information does contain id information used inside the

    # documentation structure at cross references.

    local LICENSES="${DOCBOOK_MODELS}/Default/Licenses/gpl.docbook \

        ${DOCBOOK_MODELS}/Default/Licenses/gfdl.docbook"

    # Define top level structure in the instance. This is the tag

    # defined in the second field of DOCTYPE definition.

    local DOCTYPE=$(egrep '^

        | gawk '{ print $2 }')

    # Define temporal file to store license block.

    local BLOCK=$(cli_getTemporalFile "licenses.docbook")

    # Build license block into memory.

    BLOCK="\n"

    BLOCK="${BLOCK}\n<part id=\"licenses\">\n"

    BLOCK="${BLOCK}\n<title>`gettext "Licenses"`</title>\n"

    BLOCK="${BLOCK}\n$(cat ${LICENSES} | sed -r '/<\?xml/,/]>/d')\n"

    BLOCK="${BLOCK}\n</part>\n"

    BLOCK="${BLOCK}\n\n"

    # Expand the licenses section. Remove everything in-between

    # Licenses and Back matter comment. Recreate the comments to

    # support further actualizations and concatenate license

    # information without their document type definitions preamble.

    # This is required in order to prevent validation errors and reuse

    # (through locale functionality) the translation messages already

    # available for these license files. Finally, close any open tag.

    sed -r -i -e "//,//c$(echo ${BLOCK})" $INSTANCE

}