Initial documentation for broadcasting and general vectorization guidelines * vectorize.txi: New file. * NEWS: Update with location of broadcasting documentation. * Makefile.am: Add vectorize.texi * arith.txi: Move accumarray and accumdim docstring to vectorize.txi * container.txi: Move structfun docstring to vectorize.txi * expr.txi: Mention broadcasting where relevant. * func.txi: Move vectorize docstring to vectorize.txi * matrix.txi: Move function application section to vectorize.txi * octave.texi: Add vectorize.txi and its menu options * sparse.txi: Move spfun to vectorize.txi * tips.txi: Move and rewrite coding tips section in vectorize.txi * bsxfun.h (is_valid_bsxfun, is_valid_inplace_bsxfun): Rename warning to "Octave:broadcast" * accumdim.m: Reformat to use @example in lieu of @smallexample * warning_ids.m: Add Octave:broadcast * bsxfun.cc: Reword docstring to mention broadcasting * cellfun.cc: Move comment about efficiency from tips.txi * version.h.in: Add a big startup warning about broadcasting

#! /bin/sh

if [ $# -ne 1 ]; then
  echo "usage: find-docstring-files TOP-SRCDIR" 1>&2
  exit 1
fi

## if there is a file in teh build directory tree, assume it is
## the file we are looking for.  Otherwise, get the one from the
## source tree.

if [ -f "../../scripts/DOCSTRINGS" ]; then
  echo "../../scripts/DOCSTRINGS"
else
  echo "$1/scripts/DOCSTRINGS"
fi

if [ -f "../../src/DOCSTRINGS" ]; then
  echo "../../src/DOCSTRINGS"
else
  echo "$1/src/DOCSTRINGS"
fi