Menu
▾
▴
Re: [Maxima-discuss] Help viewers
|
From: Foad S. F. <f.s...@gm...> - 2022-11-04 08:02:12
|
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 > |
