#---
## @Synopsis libhistory
#---

function add_history()
{
message "Generating HISTORY file ..."

echo \
"${HISTORY_DATE} ${GURU_NAME} <${GURU_EMAIL}>
	* DETAILS, ${PROVIDESISON}${DEPENDSISON}${CONFIGUREISON}${PREPAREISON}${CONFLICTSISON}${PREBUILDISON}${BUILDISON}${INSTALLISON}${POSTINSTALLISON}${TRIGGERSISON}${FINALISON}HISTORY${BUILD_DTFILE}: created spell" > HISTORY

message "Done."

}

#---
## @Synopsis Adds a new HISTORY entry. Uses idempotent date title handling.
## @param entry without the leading tab, bullet and space
#---
function add_history_entry()
{
  local title="$HISTORY_DATE $GURU_NAME <$GURU_EMAIL>"

  if grep -q "$title" HISTORY;
  then
    sed -i "/$title/ a\	* $1" HISTORY
  else # first time
    sed -i "1 s/^.*$/$title\n	* $1\n\n&/" HISTORY
  fi
}

#---
## @Synopsis Adds new HISTORY entries.
## @param entry without the leading tab, bullet and space
#---
function add_history_entries()
{
  local each
  message "Updating HISTORY ..."

  for each in "$@"; do
    add_history_entry "$each"
  done

  message "Done."
}

#---
##
## This software 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 software 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 software; if not, write to the Free Software
## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
##
#---

