For now, there is no full user guide for Fresh. I will write in this page some tips and tricks. Later, they will be used in the real user guide.
- How to find the place in the source where application crashes?
Press Ctrl+G in order to open "Goto address" dialog. Then enter the address where application crashes and press OK. Fresh will show you the line of the source that is compiled on the given address. The format of the number is standard FASM number format.
- How to use "Procedure arguments hint"?
This function works with call macros: stdcall, ccall, invoke and cinvoke; When you type such line and the function is known (the source have to be compiled prior to that moment) Fresh shows a hint window that helps you to enter the arguments. This happens automatically when you type "," somewhere in the line. When you want to open the hint window without typing (just for check up) you can press Ctrl+Q when the caret is at the line.
- How to use "Auto completion" function?
Auto completion is very powerful function, that can save you thousands of keystrokes. In order to use it, the source have to be compiled (at least partially - some errors are acceptable) because Fresh have to build the tree of labels, defined in you program.
Fresh does not relays on fixed lists. It uses the labels you defined in the source. This is the only possible solution, because Fresh is not committed to any particular OS or platform. If you write Win32 program, you will have Windows API in the auto completion box. When you write Linux program, you will have all Linux constants and API functions.
To open auto completion, press Ctrl+Space. Then when you type, the content of the box will be refreshed in order to correspond with the word you type. You can select suitable element from the list and press Enter to insert it in the line.
- How to move a file from one category to another in the project?
Open the file in the editor. Select the category where you want it to be moved. Click the right mouse button on the tab of the file in order to display the context menu. Select "Add to project" function. It will remove the file from the old category and will move it to the current selected category.
- How to develop Linux application from Windows?
For now, Fresh is Windows application. This will be changed in time but still it is useful to be able to write Linux applications while working under Windows.
Of course Fresh and FASM can compile ELF executables, but how to run, test and debug them?
There are two solutions to this problem. First is to run Fresh in Windows but to run and debug compiled applications in Linux using the amazing andLinux.
Second is to run Fresh in Linux using Wine and to run compiled applications directly in Linux.
Fresh and Linux article describes these two solutions in details.
- How to open the file specified in "include" or "file" directive.
Place the caret on the line that contains file name and press Ctrl+Enter.
Opening files this way, Fresh replace the directory aliases and/or environment variables in the filename.
Files like "%lib%/%TargetOS%/MyFile.asm" will have been opened correctly.