#! /bin/sh
#
# Copyright (C) 1999, 2002, 2005, 2007, 2009 John W. Eaton
#
# This file is part of Octave.
# 
# Octave 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 3 of the License, or (at
# your option) any later version.
# 
# Octave 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 Octave; see the file COPYING.  If not, see
# <http://www.gnu.org/licenses/>.

## Expecting arguments in this order:
##
##  SRCDIR SRCDIR-FILES ... -- LOCAL-FILES ...

set -e

PERL=${PERL:-'perl'}

prefix="$1/"
shift

if test -f gethelp; then
  cat << EOF
### DO NOT EDIT!
###
### This file is generated automatically from the Octave sources.
### Edit those files instead and run make to update this file.

EOF
  for arg
  do
    if [ "$arg" = "--" ]; then
      prefix=""
    else
      echo "$prefix$arg" | $PERL -n -e 'chop;
	$f = "$_";
        next unless m{(.*)/(.*)\.m};
	for (qx{./gethelp $2 "$f" < "$f"}) {
	  s/^\s+\@/\@/ unless $i_am_in_example;
	  s/^\s+\@group/\@group/;
	  s/^\s+\@end\s+group/\@end\s+group/;
	  $i_am_in_example = 1 if /\s*\@example/;
	  $i_am_in_example = 0 if /\s*\@end\s+example/;
	  print;
	}'
    fi
  done
else
  echo "gethelp program seems to be missing!" 1>&2
  exit 1
fi