

_O_u_t_e_r _P_r_o_d_u_c_t _o_f _V_e_c_t_o_r_s

     outer(x, y, FUN = "*", ...)
     x %o% y

_A_r_g_u_m_e_n_t_s:

       x: a vector.

       y: a vector.

     FUN: a function to use on the outer products, it may be
          a quoted string.

     ...: optional arguments to be passed to `fun'.

_D_e_s_c_r_i_p_t_i_o_n:

     The outer product of the vectors `x' and `y' is the
     matrix `A' with elements `A[i, j] = FUN(x[i], y[j],
     ...)'.  `FUN' must be a function which expects at least
     two arguments and which operates elementwise on arrays.

     This needs to be extended to taking arrays of arbitrary
     dimension for `x' and `y' and returns an array of
     dimension `c(dim(x), dim(y))'.

     `%o%' is an `.Alias' for `outer' (where `FUN' cannot be
     changed from `"*"'.

_E_x_a_m_p_l_e_s:

     outer(1:5, 1:5, "+")
     all(outer(1:5, 1:5) == 1:5 %o% 1:5)

