Add seealso strings to list- related functions.

[Muthiah Annamalai]

John W. Eaton wrote:
> On 14-Jan-2008, Muthiah Annamalai wrote:
>
> | I would like to propose a patch to add seealso strings to
> | list- related functions like list, nth, reverse, append and splice.
> | It helps users to know how to deal with lists, as lists are almost
> | impervious to any operations on them, except through the 5
> | functions. This patch helps cross reference the functions.
>
> Lists are also obsolete (use cell arrays instead).  So rather than
> improving the documentation for them, I think we should probably
> officially deprecate them and plan to remove them from a future
> version of Octave.
>
> jwe
>
>   
I agree. But also lists are currently the only form of return values 
from the
function dir(), and I was looking for a while on how to use the lists. I 
thought
it would be nice to have cross-references. However I am not aware of any 
other
functions that may return lists. Then for dir() and any such functions, 
we can
homogeneously make all builtins return anything except lists.


Thanks,
-Muthu