search

rochus-keller / Oberon

Oberon parser, code model & browser, compiler and IDE with debugger, and an implementation of the Oberon+ programming language
GNU General Public License v2.0
464 stars 30 forks source link

Basic Instructions on how to use the IDE #1

Closed YusufCakan closed 3 years ago

YusufCakan commented 3 years ago

Hi, I can't work out how to open a new file or start a new project in the IDE. I click on new project, but it doesn't do anything. What am I doing wrong?

YusufCakan commented 3 years ago

ok worked out that I had to save an empty project to start it. If I may say, this is bit counter intitutive since menu has "new project" item which I expected to do this, but it doesn't seem to do anything. Now that I have a project, it's still not clear how to add modules (i.e files) to this project since "add module" in the context menu items doesn't seem to do anything.

rochus-keller commented 3 years ago

The File menu affects the project file; to add modules please use the Project menu (which is also available as a context menu on the Modules docking pane). I currently spend all my free time to implement the new OBX IDE with an extended version of Oberon. A new empty project looks always the same; that's why you think nothing happened when you repeatedly do "New Project". Do Project/Add Modules e.g. on the OberonSystem repository and select all .Mod files in the file selector dialog box; when you hit OK then the Modules pane should look like this: grafik Now do Project/Save Project which will create an .obnpro file in the file system. For the Oberon System to work don't forget to check the Project/Built-in Oberon System Inner menu item. Then you should be able to use the Build & Run menu to run the Oberon System. Hope this helps. Documentation and tutorials are on the todo list, but I have to set priorities.

EDIT: there is currently no "New Module" function; just create a .Mod file in the file system instead and add it to the project using Project/Add Module.

YusufCakan commented 3 years ago

Many thanks for your speedy reply. I appreciate your efforts in developing and extending this language and I understand that there must be many priorities on your list. Hopefully having this as an open issue would also help others get started until the documentation and tutorials come up to speed. I found the 'new project' and 'new module' menu items a bit confusing and it maybe something you reconsider when you get a chance to revisit this functionality. In the longer term, would be happy to help with documentation if I can learn the system well enough to contribute.

rochus-keller commented 3 years ago

Welcome, thanks for your feedback. The IDE was mostly intended to have something at all to navigate and edit a project; I consider implementing a Qt Creator plugin (such as e.g. https://github.com/rochus-keller/VerilogCreator) when the compiler is stable and the language extensions have proven to be useful.