Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-14 Thread fredvs
Hello Graeme. In some GitHub C projects where I participate there are automatic reviews and checks that must be ok before the pull-request is acceptable. For example: https://github.com/libsndfile/libsndfile/pull/732 Do you know it it exists for fpc? And is it useful? Fre;D -- Sent

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-14 Thread Graeme Geldenhuys
On 14/04/2021 9:02 pm, fredvs wrote: > Hum, yes, but then Graeme and I have to fight against each other to decide > who takes the chair. LOL - it is very good practice to always do code reviews, so I'm definitely in agreement with Roland on this. Whoever reviews first can commit it, but I feel

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-14 Thread fredvs
> > Ok, perfect, and after the pull requests, you may accept it! ;-) > Yes, I know I could, but I will let you (or Graeme) do it. Hum, yes, but then Graeme and I have to fight against each other to decide who takes the chair. And it is not the moment to create a second "sofagate". ;-) Fre;D

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-14 Thread Roland Chastain
> Ok, perfect, and after the pull requests, you may accept it! ;-) Yes, I know I could, but I will let you (or Graeme) do it. > Nice work Roland. Thank you for the compliment. Glad that you like it. The style is the default PasDoc style. See you. -- Sent from:

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-14 Thread fredvs
Hello Roland! > I will do the fixes, but I prefer using a fork and doing pull requests. Ok, perfect, and after the pull requests, you may accept it! ;-) > You can take a look to the latest version of the tenumtypeedit page: > http://msegui.net/doc/msedataedits.tenumtypeedit.html Wow, I like

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-14 Thread Roland Chastain
Thank you Fred, for that reminder about git basics. :) I will do the fixes, but I prefer using a fork and doing pull requests. I already forked the repository: https://github.com/rchastain/mseide-msegui I continued to work on MSE documentation (the PasDoc version and the fpdoc version). You can

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-13 Thread fredvs
Hello Roland. Yes, it is still me. IMHO, msestrings.pas (and others) should be fixed, like in the commit of Graeme. To do this, a short remembering how to push the fixes: 1) Clone the last mseide-msegui: $ git clone https://github.com/mse-org/mseide-msegui 2) Go in that directory: $ cd

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-13 Thread fredvs
Ooops, in previous post: > Could it be the same for msestrings.pas and a _ "_ is missing after > 'Integer' ? Please read this: Could it be the same for msestrings.pas and a ";" is missing after "Integer" ? Fre;D -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-13 Thread fredvs
Re-hello Roland. Did you see one of the last commits of Graeme in mseide-msegui? https://github.com/mse-org/mseide-msegui/commit/5ca765b8bc69afa5c0decb0968c67c7e7a20bced Here his comment: "Documentation generator detected the malformed syntax, which is now corrected. Having a documentation

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-13 Thread fredvs
Hello Roland. About http vs https, it seems that FireFox does not like http anymore and set as insecure. About converting your site into https, maybe this could help: https://www.brafton.com/blog/distribution/how-to-convert-http-to-https-a-quick-guide/ About fpdoc-generate doc, I have to jump

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-13 Thread Roland Chastain
I don't know Fred. I have asked the question on a forum, but didn't received many answers. About the fpdoc-generated documentation for MSEgui, I see that there are errors during generation process. For example this one : Parsing used unit "msestrings" with commandLine "..." Error:

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-11 Thread fredvs
Hello Roland. My knowledge in Web things is very poor, but I have seen that you use a no-secured site: "http://; vs "https://;. Maybe there is something to do with this. Fre;D -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-11 Thread Roland Chastain
Thank you for the information Fred. No idea of what happens. (I don't have that problem here.) I will make a research with the message that you received, to see if I find something. -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-11 Thread fredvs
Hello Roland. > http://msegui.net/doc/msedataedits.tenumtypeedit.html Superbe, but I have a strange problem that I dont have with any other site. If I click on something, there is that message: "La requête ne peut aboutir Le site à l’adresse http://msegui.net/doc/AllVariables.html a subi une

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-11 Thread Roland Chastain
> Maybe I will use french in the PasDoc doc. http://msegui.net/doc/msedataedits.tenumtypeedit.html -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___ mseide-msegui-talk mailing list mseide-msegui-talk@lists.sourceforge.net

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-11 Thread Roland Chastain
> > You can see the result here: > > http://msegui.net/doc/msedataedits.tenumtypeedit.html > Wow, sincerely the most clear and beautiful doc I ever seen. > Congrats. Thank you Fred. (I have just seen your message.) I was about to delete the PasDoc pages (Graeme converted me to fpdoc), but

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Graeme Geldenhuys
On 11/04/2021 1:40 am, Graeme Geldenhuys wrote: > You use the EXAMPLE tag inside an ELEMENT tag. Here is a > complete ELEMENT example: I forgot to mention, you can also use the CODE tag inside the DESCR tag. Thus you don't have to use a external file for the code example. Regards, Graeme --

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Graeme Geldenhuys
On 10/04/2021 9:25 pm, Roland Chastain wrote: > Please could you tell me how I can insert a Pascal code example? You use the EXAMPLE tag inside an ELEMENT tag. Here is a complete ELEMENT example: The constructor for TfpgSystemTrayIcon . Modern operating systems usually provide a special area

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Roland Chastain
>MSEide+MSEgui's latest `master` now contains the fpdoc project file and the > xml documentation - moved over from MSEUniverse repo. > The generated HTML is beau-ti-ful! Graeme, you did a great job. I looked into the little XML files: I think I understood the principle. Please could you tell me

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Roland Chastain
Thank you for your work Graeme. I downloaded the msegui.inf file and tested the integration into MSEide. It is great! Just a small detail. I didn't understand where the FPCHELP variable is defined. So I did put the explicit path to the file, and it worked. Thank you for the links to IPF

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Graeme Geldenhuys
On 10/04/2021 4:03 pm, Roland Chastain wrote: > I looked for IPF syntax guide and examples but didn't find many things. I've included the official documentation from IBM inside the fpGUI repository. https://github.com/graemeg/fpGUI/tree/develop/docview/docs The file you'll be most interested

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Graeme Geldenhuys
On 10/04/2021 11:20 am, Graeme Geldenhuys wrote: > Like advanced search, inline annotations, > runtime or compile time Index page building, runtime concatenation of INF > files, very compact binary format etc. I've just tested fpdoc (from FPC 3.2.1) generating HTML, CHM and INF help as final

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Roland Chastain
Thank you Graeme for having taken time to give all these informations. I tried (successfully) to generate a documentation for a project I am working on. I simply used fpdoc to generate the IPF. I haven't yet tried to create a project. I will try later. I looked for IPF syntax guide and examples

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Graeme Geldenhuys
On 10/04/2021 9:34 am, Roland Chastain wrote: > So, I have a fully functional *wipfc* + *docview* + *fpdoc* installation. :) That's excellent news. > 1. To generate the IPF for MSEgui, do you also use the XML? fpdoc can generate documentation output only using the source code, but then there

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread fredvs
Hello Roland. > (I noticed that I waste too much energy to find words in english. Maybe I > will continue in french.) Same for me. But I notice that Google Translate works much better from French to English than English to French. So maybe it will be faster and easier to do all the work in

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread fredvs
Hello Roland! > You can see the result here: > http://msegui.net/doc/msedataedits.tenumtypeedit.html Wow, sincerely the most clear and beautiful doc I ever seen. Congrats. Fre;D -- Sent from: http://mseide-msegui-talk.13964.n8.nabble.com/ ___

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Roland Chastain
I continue to explore the features of PasDoc. Here is my first comment: {++ Component for editing a value of enumerated type. The @code(OnInit) event can be used to import the different values of the type. @includeCode(../../../contributed/examples/tenumtypeedit1.pas) } tenumtypeedit =

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-10 Thread Roland Chastain
Hello Graeme (and other)! So, I have a fully functional *wipfc* + *docview* + *fpdoc* installation. :) I tested IPF to INF conversion (with wipfc): OK. I tested HTML doc for MSEgui generation (with fpdoc, using the XML files that you provided): OK. I tested your Lazarus demo, including an INF

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-09 Thread Graeme Geldenhuys
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

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-09 Thread Roland Chastain
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

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-09 Thread Graeme Geldenhuys
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

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-09 Thread Graeme Geldenhuys
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

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-09 Thread Patrick
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

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-09 Thread fredvs
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

Re: [MSEide-MSEgui-talk] MSEgui documentation generated with PasDoc

2021-04-09 Thread fredvs
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] MSEgui documentation generated with PasDoc

2021-04-09 Thread Roland Chastain
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: