Language Docu Lisp, Python, DCL

So, a lot of ugly work...

But finally done.

I need good developer help that can be accessed from the command line or from the IDE.

I built a lightweight browser that you can build as a LC tool.
The browser can render qrc:// files as html.
This is broken in all Qt examples under Linux since Google libs. But I know a bit about it and I managed it.

And then the ugly work  over 400 commands/settings. I just pushed for help for over a week.
Well, but what is a developer interface worth?

The browser can of course also go to the web in the online help and YouTube can also be accessed in full screen for tutorials. Unfortunately I haven't gotten around to building anything in Windows yet.

Which compiler are you using for Windows - MS20?? or MinGW?

Greetings Emanuel

Hi,

Sorry for the late reply. I am on a business trip this week.

In windows, we are mostly using mingw-gcc to build the official releases.

When I get a chance, I will see what's the issue with windows building.

emanuel wrote

So, a lot of ugly work...

But finally done.

I need good developer help that can be accessed from the command line or from the IDE.

I built a lightweight browser that you can build as a LC tool.
The browser can render qrc:// files as html.
This is broken in all Qt examples under Linux since Google libs. But I know a bit about it and I managed it.

And then the ugly work  over 400 commands/settings. I just pushed for help for over a week.
Well, but what is a developer interface worth?

The browser can of course also go to the web in the online help and YouTube can also be accessed in full screen for tutorials. Unfortunately I haven't gotten around to building anything in Windows yet.

Which compiler are you using for Windows - MS20?? or MinGW?

Greetings Emanuel

I finally got the developer documentation/help ready enough to generate the htmls I need.
I have now documented everything I have already programmed in terms of functionality.
I noticed what was still missing. Well, I still did a lot during that time.

I was now even able to build the LibreBrowser, which I need for Lisp, Dcl, Python help, under Windows 64.
Unfortunately, it doesn't work in one go like it does in Linux.
The Chromium Lib is to blame. You can only build it with MSVC.
This is also to blame for the fact that all Qt examples with qtc:/ html src no longer work in 6.X.
But the fact that Windows only works with MS was new to me.
You can't even build the examples with MinGW (WebEngine).
But that doesn't matter in and of itself, because the browser has to be independent.
Otherwise it will block the CAD.

I tried building LibreCAD under Win with the same compiler.
That then depended on swig.exe.

How exactly do you build this under Windows with MinGW.
In Qt Creator or just via CMD.EXE with CMAKE.EXE?

Please take a look at the lightweight browser for help.

Thanks Emanuel

I thought about it again and came up with a much better solution.
Windows always takes a while for me...

I compiled a Windows chm file from the HTML files and everything goes well.
I packed everything and put a BATCH in it to call the test for a developer command.
The search function even works in Windows Help.
But to make it nicer I have to invest time in it.

Now I finally have to do something with my actual interpreter sources again.

Best regards

Emanuel

LibreCAD_WindowsHelp.zip

emanuel wrote

I compiled a Windows chm file...

This is a two decade old legacy format. A more modern solution would be browser based HTML.

I like https://www.mkdocs.org/ - Project documentation with Markdown deploying on https://www.mkdocs.org/user-guide/deploying-your-docs/#github-pages

The format doesn't matter, I have text files as source and I can generate anything from them. Personally, I don't like Markdown at all because I have automatic space removal in the editor and if I forget to do that, the Markdown file is broken. But with MD I'm faced with the same problem again as with HTML under Windows with QT. If I want to build a Markdown browser, I need MSVC.

Can't people just use their existing browser (eg same as with LibreOffice)? If so, you would not need to build one.

emanuel wrote

The format doesn't matter, I have text files as source and I can generate anything from them.

https://github.com/emanuel4you/LibreCAD-Developer-Help/blob/main/python/OpenFileDialog.txt

PYTHON Functions

   string OpenFileDialog(string title, string fileName, string fileExt)
     __________________________________________________________________

   displays a dialogbox for opening a file.
     __________________________________________________________________

   This function returns the filename as a string.

More about...
   [link]GetIntDialog

Seems a clear case for https://peps.python.org/pep-0257/#multi-line-docstrings which are much more functional:

def complex(real=0.0, imag=0.0):
    """Form a complex number.

    Keyword arguments:
    real -- the real part (default 0.0)
    imag -- the imaginary part (default 0.0)
    """
    if imag == 0.0 and real == 0.0:
        return complex_zero
    ...

I'm working without empty lines. https://github.com/emanuel4you/LibreCAD-Developer-Help/blob/main/lispHtml.py#L164
They are only for better reading.