describe bug, was: Re: [Maxima] First step toward a 5.9.2 rel ease

Raymond Toy writes:
>>>>>>"Vadim" == Vadim V Zhytnikov  writes:
> 
> 
>     Vadim> Fine, so the problem with describe is partially
>     Vadim> resolved.  But there is yet another problem.
>     Vadim> Describe dislikes national characters.  For example
>     Vadim> if I make info in Russian locale @defun/@defvar produces
>     Vadim> -- Function/Variable in Russian.  Describe can't work
>     Vadim> with such info files.  On clisp and sbcl it just
>     Vadim> crashes.  On gcl and cmucl it works but not quite well -
>     Vadim> once again it can't locate beginning and end of required
>     Vadim> info item.  This is one of reasons why I insist on replacing
> 
> That's because describe (cl-info) is pretty stupid.  It searches the
> info file for "Function", without looking at the language.  I don't
> know how to make it respect the locale.  And cl-info probably isn't
> capable of handling anything other than ASCII or Latin-1 at best.
> 
>     Vadim> @defun/@defvar by @deffn/@defvr - this resolves the trouble
> 
> How does @defun differ from @deffn?
> 

@defun  

produces

- Function  

with "Function" translated to loacale language.

@deffn   

gives

-   

Relationship between @deffav and @defvr is similar.

Finally I see why cl-info can't find

- Function

with "Function" in Russian - it tries to match

- [a-zA-Z]

This is not a big problem for translations.
One can translate body of the documentation
but keep  in English.


-- 
      Vadim V. Zhytnikov