Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc
On 09/04/2021 7:41 pm, Roland Chastain wrote: > ... never really got into the habit of using it. Integrate it into MSEide and reassign F1 to trigger help based on where the edit cursor is. Instructions are here: http://fpgui.sourceforge.net/docview_ide_integration.shtml I personally use the Free Pascal's RTL + FCL and fpGUI docs inside MSEide - while I do coding. I can't remember every method or class. ;-) I also have a lot of personal notes or examples embedded inside my docs (thanks to the feature from DocView). The same can be done with RTL + FCL + MSEgui docs in INF format. Though it would be much better if MSEgui was actually documented, but we can hope that one day the community would band together on that effort. [fingers crossed] Regards, Graeme -- fpGUI Toolkit - a cross-platform GUI toolkit using Free Pascal http://fpgui.sourceforge.net/ My public PGP key: http://tinyurl.com/graeme-pgp ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc
Hello Graeme! Glad to read something from you. Thank you very much for informations and links. I will study all. In fact, I already have DocView installed (I even have a shortcut on my desktop), but never really got into the habit of using it. I remember I failed to generate by myself the documentation. I will give another try. By the way, the latest version of PasDoc allows to use external files. Anyway, it's something that I do for myself. If it isn't useful, it won't hurt. :) Regards. Roland -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
[MSEide-MSEgui-talk] Fwd: Allegro5 instead of xorg libraries
Accidentally replied directly to Fred and not the mailing list. Forwarded Message Subject: Re: [MSEide-MSEgui-talk] Allegro5 instead of xorg libraries Date: Fri, 9 Apr 2021 17:33:07 +0100 From: Graeme Geldenhuys To: fredvs On 09/04/2021 12:35 pm, fredvs wrote: > Then, maybe no worry too much about the end of Xorg, all X11 applications > will work exactly like "pure" Wayland applications. Exactly! Xlib is going to be like Win32. It will be support for indefinite. It is worth noting that from the very start, one requirement for a xorg replacement display server was that it MUST be backwards compatible, otherwise 30+ years worth of software will stop running, and the Linux community can't afford that to happen. At this time Wayland only targets Linux. Other operating systems like Solaris (and it's new open source equivalent), all *BSDs etc will continue to support Xorg. So it's highly unlikely that Xorg will simply become abandon-ware. > It would be interesting that people who have a "pure" Wayland system > installed try to run some MSEgui applications and see if there is problems. Latest Ubuntu can switch to Wayland display server and fpGUI and MSEide runs fine on it. Ubuntu 21.04 will default to Wayland display server. Regards, Graeme -- fpGUI Toolkit - a cross-platform GUI toolkit using Free Pascal http://fpgui.sourceforge.net/ My public PGP key: http://tinyurl.com/graeme-pgp ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc
On 09/04/2021 12:35 pm, Roland Chastain wrote: > I am playing with the latest release of PasDoc. Not again! This has been raised so many times over the years. Martin (and I) full agreed that PasDoc is not the way to go, because it requires the source code to be bloated with documentation and code examples. A better alternative: * "fpdoc" comes standard with FPC. * It supports multiple output formats. * Is very well supported. * And most importantly, supports external documentation (not included in the source code files). I've already started fpdoc based documentation back in 2015 to show Martin and the MSEide+MSEgui community. But the uptake of somebody actually writing the documentation has never happened. I only use the IDE of this project, so was not going to consume all my time learning MSEgui, just to document it. However, I did put some time into it: https://github.com/graemeg/msegui/tree/api-docs/contributed In the above like I did the following: * Created a fpdoc project file. Makes things so much easier than adding all those command line parameters in manually. * Created documentation for 3 MSEgui units * Found existing txt based documentation and moved what I could understand to the XML format. * Generated INF binary help output to show usage with DocView. I thought this would be a good enough proof of concept. https://github.com/graemeg/msegui/releases/tag/docs-s2 You can read all about it here (mailing list archive), with screenshots. https://sourceforge.net/p/mseide-msegui/mailman/mseide-msegui-talk/thread/55E72659.7050201%40geldenhuys.co.uk/#msg34427184 Regards, Graeme -- fpGUI Toolkit - a cross-platform GUI toolkit using Free Pascal http://fpgui.sourceforge.net/ My public PGP key: http://tinyurl.com/graeme-pgp ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc
On 09/04/2021 12:35 pm, Roland Chastain wrote: > I am playing with the latest release of PasDoc. And I forgot to mention in my previous message, the fpdoc HTML output doesn't have to look as ugly as the default FPC docs does. It's fully customisable using CSS. Here is fpGUI's Class docs generated as HTML, as an example of how it can look different: A specific method: http://fpgui.sourceforge.net/apidocs/fpg_base/tfpgpoint.manhattanlength.html Main index: http://fpgui.sourceforge.net/apidocs/index.html The above docs were generate quite a while back. I believe the newer fpdoc now supports built-in search capability too. Hence I always used INF + DocView for searching and inline annotations/comments in my docs. Regards, Graeme -- fpGUI Toolkit - a cross-platform GUI toolkit using Free Pascal http://fpgui.sourceforge.net/ My public PGP key: http://tinyurl.com/graeme-pgp ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc
On 4/9/21 8:29 AM, fredvs wrote: Example: application.checkwindowname vs Application.CheckWindowName. But this is taste and using only lowercase looks maybe more pro. Personally I use Uppercase for the beginning of words in all my projects. It is definitely clearer to me when reading code to be able to quickly distinguish individual words. Patrick ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc
Re hello Roland. About taste and color. Martin uses for all msegui methods lowercase. Of course it is faster to write but, imho, to read, like in a doc, using some uppercase make it clearer. Example: application.checkwindowname vs Application.CheckWindowName. But this is taste and using only lowercase looks maybe more pro. Fre;D -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc
Hello Roland! http://msegui.net/doc/index.html Houlala, beautiful! Of course it will be very useful (once filled). Fre;D -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] Allegro5 instead of xorg libraries
Re-re hello. It seems too that Allegro5 is not Wayland compatible, so it will not help very much: https://github.com/liballeg/allegro5/issues/501#issuecomment-637078368 Fre;D -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
[MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc
Hello! I am playing with the latest release of PasDoc. I am not sure that the result will be really useful, but I am learning things while I do it. :) If you want to take a look, I uploaded a first version here: http://msegui.net/doc/index.html Regards. Roland -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] Allegro5 instead of xorg libraries
Re-hello. It seems that the only part of Xorg still maintained/updated is XWayland: https://gitlab.freedesktop.org/search?utf8=%E2%9C%93&search=xwayland&group_id=1154&project_id=371&scope=commits&search_code=false&snippets=false&repository_ref=master&nav_source=navbar XWayland is part of Wayland and integrated in each Wayland OS. Then, maybe no worry too much about the end of Xorg, all X11 applications will work exactly like "pure" Wayland applications. It would be interesting that people who have a "pure" Wayland system installed try to run some MSEgui applications and see if there is problems. Fre;D -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] Allegro5 instead of xorg libraries
Hello. There is also the fpc source for Wayland done by Andrew. https://github.com/andrewd207/fpc-wayland -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] Allegro5 instead of xorg libraries
Not only for XOrg, but also for console framebuffer. Factorio game is made with Allegro... On Fri, Apr 9, 2021 at 11:16 AM code dz wrote: > but allegro is built on top of xorg if i remember correctly ! > there was an atempt from martin to introduce SDL2 as a graphic backend for > msegui but he just stop working on it > > On Fri, Apr 9, 2021, 08:34 vasi vasi wrote: > >> I was thinking, Allegro5 lib is ported everywhere, it might be better >> used instead of xorg libs? >> >> -- >> Vasi >> ___ >> mseide-msegui-talk mailing list >> mseide-msegui-talk@lists.sourceforge.net >> https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk >> > ___ > mseide-msegui-talk mailing list > mseide-msegui-talk@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk > -- Vasi ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
Re: [MSEide-MSEgui-talk] Allegro5 instead of xorg libraries
but allegro is built on top of xorg if i remember correctly ! there was an atempt from martin to introduce SDL2 as a graphic backend for msegui but he just stop working on it On Fri, Apr 9, 2021, 08:34 vasi vasi wrote: > I was thinking, Allegro5 lib is ported everywhere, it might be better used > instead of xorg libs? > > -- > Vasi > ___ > mseide-msegui-talk mailing list > mseide-msegui-talk@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk > ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk
[MSEide-MSEgui-talk] Allegro5 instead of xorg libraries
I was thinking, Allegro5 lib is ported everywhere, it might be better used instead of xorg libs? -- Vasi ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mseide-msegui-talk