Re: document AS_BASENAME

[Stepan Kasal]

Hello,

On Thu, Mar 30, 2006 at 10:01:39AM -0800, Noah Misch wrote:
> On Thu, Mar 30, 2006 at 06:18:43PM +0200, Stepan Kasal wrote:
> >  @example
> > ...
> >  file=`AS_BASENAME(["$file"])` # This is more portable.
> >  @end example
> 
> With you adding an example to the documentation of AS_BASENAME, this example 
> is
> now duplicative.  Consider deleting it.

well, my point was that it's better to duplicate a one-line example then to use
a cross reference.

But you might be right: it might be better to delete the examples from the
descriptions of basename and dirname limitations.

What do others think?

>   Some hosts lack `basename' (example?) or provide an implementation that
>   mishandles `/' (Solaris).  Use `AS_BASENAME' to portably extract the last
>   component of a file name.  Use `expr' to remove a suffix from a string.

Sounds good.  No, I don't know which systems miss basename/dirname.

Could any of the other readers help us?

> [...] I think it's important that we somehow avoid creating a myth that
> some basename implementations lack support for suffix removal.

I agree.  Thank you for catching this.

Have a nice day,
        Stepan Kasal