Re: [Maxima-discuss] Help viewers

[Foad S. F. <f.s...@gm...>]

Hello everyone,

I just wanted to interject and let you know the core Scilab team is
actively available on this Discord channel <https://discord.gg/XCAxqUQ> if
you want to discuss features/bugs/questions...
There is also a Maxima/WxMaxima channel <https://discord.gg/Fh4nfsY> that
you are all welcome to join.

Best,
F.

On Mon, Jul 25, 2022 at 7:23 PM Gunter Königsmann via Maxima-discuss <
max...@li...> wrote:

>
>
> Am 25. Juli 2022 16:53:59 MESZ schrieb Raymond Toy <toy...@gm...
> >:
> >On Mon, Jul 25, 2022 at 4:03 AM Gunter Königsmann <gu...@pe...>
> >wrote:
> >
> >> The fact that I can get list of topics took me a bit of surprise=> will
> >> need a few days for making the required changes to wxMaxima. But will do
> >> that.
> >>
> >
> >This is what you get when you use ?? foo and get a list of matches and you
> >select some or all of them.
> >
> >For html, you could get tens or hundreds of tabs opened.  But that's not
> >too different from getting hundreds of entries printed to the terminal.
> >
>
> I never thought of punting the question what manual pages to show to the
> gui. But I think it is a good idea. My attempt to a solution to that
> problem is to create a list of clickable topics so the user can choose what
> tab to instantiate: I am not the more-than-ten-tabs guy...
> >>
> >> And I wonder if we should change the name of the option from 'wxmaxima
> to
> >> 'frontend: there are many frontends and perhaps others have a built-in
> help
> >> browser, too, that we could use...
> >>
> >
> >How many are there? I only know of xmaxima and wxmaxima.  And it seems
> >xmaxima doesn't have anything special; it just prints to the xmaxima
> >console.
>
> Imaxima can use the emacs html browser. Don't know if that browser likes
> mathJaX, though. Xmaxima has an html browser, but I don't know if it has
> MathJaX support, neither. Jupyter is quite cool and I don't know what
> features it will get in the future. There is a lisp-only flgraphical
> frontend that feels quite responsive and I don't know if scilab or similar
> programs give you enough access to maxima that they might want to show its
> help...
> ...and there was maxima-online. Also one of the things I have learnt from
> my girlfriend's studies about utopia from 100 years ago is: You never know
> what will come next.
>
> Kind regards,
>
>    Gunter.
> >
> >>
> >> Am 25. Juli 2022 00:15:36 MESZ schrieb Raymond Toy <
> toy...@gm...
> >> >:
> >>>
> >>> I've merged it now.  When the nightly build is done, you should be able
> >>> to experiment as you see fit.
> >>>
> >>> Just define the function display-wxmaxima-topics to display the topics
> as
> >>> you wish.  It will replace the existing function.  Be sure to set
> >>> output_format_for_help to 'wxmaxima.
> >>>
> >>> On Sun, Jul 24, 2022 at 2:33 PM Raymond Toy <toy...@gm...>
> >>> wrote:
> >>>
> >>>>
> >>>>
> >>>> On Sun, Jul 24, 2022 at 2:24 PM Gunter Königsmann <
> gu...@pe...>
> >>>> wrote:
> >>>>
> >>>>> Thanks a lot!
> >>>>>
> >>>>> build_info() should return a struct that contains a field named
> >>>>> "frontend". I hope that was the exact name; of that field; wxMaxima
> sets
> >>>>> that field.
> >>>>>
> >>>>
> >>>> Ah, perfect.  There's a variable named maxima_frontend.  It's false
> for
> >>>> a terminal and Xmaxima when using Xmaxima.
> >>>>
> >>>> So I'll update the code and remove the function
> >>>> display-wxmaxima-topics.  When wxmaxima is loaded, it can define the
> >>>> function appropriately.
> >>>>
> >>>> Note that the display functions take a list of topics.  Look at
> >>>> display-text-topics or display-html-topics to see how to parse the
> list of
> >>>> topics to get the item name you want displayed.  I can help with that
> when
> >>>> the time comes.
> >>>>
> >>>>>
> >>>>> Kind regards,
> >>>>>
> >>>>> Gunter.
> >>>>>
> >>>>> Am 24. Juli 2022 23:15:14 MESZ schrieb Raymond Toy <
> >>>>> toy...@gm...>:
> >>>>>>
> >>>>>> Ok, I've got this mostly working, except I haven't tested it with
> >>>>>> wxmaxima.
> >>>>>>
> >>>>>> I got rid of $describe_uses_html and replaced it with
> >>>>>> $output_format_for_help.  It should take one of the values $text,
> $html, or
> >>>>>> $wxmaxima.  Anything else is an error.
> >>>>>>
> >>>>>> (Oh, I'd also like to rename $browser to $browser_command or maybe
> >>>>>> $browser_command_string; $browser isn't just the name of the browser
> >>>>>> anymore.  It's  really a format string that can be used to start a
> browser
> >>>>>> with a given URL.  I haven't done that yet.)
> >>>>>>
> >>>>>> This sets up *help-display-function* to an appropriate function to
> >>>>>> display help.  For wxmaxima, the function name is
> display-wxmaxima-topics.
> >>>>>>
> >>>>>> Currently, this function is just what Gunter sent; I can't test it.
> >>>>>> But hopefully, it will be tested soon.
> >>>>>>
> >>>>>> Is there a simple way to know if maxima is running in wxmaxima?  We
> >>>>>> would probably want to throw an error if the user sets the format to
> >>>>>> wxmaxima when not running in wxmaxima.
> >>>>>>
> >>>>>> You can find the current changes on the branch
> >>>>>> rtoy-output-help-wxmaxima.
> >>>>>>
> >>>>>> Ideally, I think I'd like it if display-wxmaxima-topics were not
> >>>>>> defined at all in maxima, but when wxmaxima is running, the function
> >>>>>> display-wxmaxima-topics is defined to handle the display.
> >>>>>>
> >>>>>> Anyway, I'm going to play with this a bit more and then merge it,
> with
> >>>>>> updated docs, to the main branch.
> >>>>>>
> >>>>>>
> >>>>
> >>>> --
> >>>> Ray
> >>>>
> >>>
> >>>
> >
>
>
> _______________________________________________
> Maxima-discuss mailing list
> Max...@li...
> https://lists.sourceforge.net/lists/listinfo/maxima-discuss
>