lite-xl/README_OS4.md

# Lite XL for AmigaOS 4.1 FE

Lite XL is coming to AmigaOS 4.1.

A few things are not quite working. Please have a look at the "Known issues" 
section below.

## Installation
You can extract the Lite XL archive wherever you want and run the *lite* 
editor.

## Configuration folder
This editor creates a `.config` folder where the configuration is saved, as 
well as plugins, themes etc.. By default this AmigaOS 4.1 FE version uses the
executable folder, but if you want to ovveride it, create an ENV variable 
named `HOME` and set there your path. 

You can check if there is one already set by executing the following command
in a shell
```
GetEnv HOME
```
If there is one set, then you will see the path at the output.

Otherwise, you can set your home path be executing the following command. 
Change the path to the one of your preference.
```
SetEnv SAVE HOME "Sys:home/"
```


## Know issues
You can find the known issues at 
https://git.walkero.gr/walkero/lite-xl/issues


# Changelog

## [1.16.12.7] - future
## Added
- Added config.scroll_past_end that when its true lets the user scroll
  further than the end of the file. By default is set to true.
- Added "SDL_RENDERER_ACCELERATED" and "SDL_RENDERER_PRESENTVSYNC" on 
  SDL_CreateRenderer() since this reduces the CPU usage when the user
  scrolls and seems to work pretty good on my systems (X5000, A1222 and 
  microAmigaOne). This is exeprimental. If this brings problems on your
  system, you can disable them using SDL ENV variable, like below:
  setenv SDL_RENDER_VSYNC 0
  setenv SDL_RENDER_DRIVER "software"

## [1.16.12.6] - 2022-01-04
### Fixed
- Fixed a problem introduced in previous version when LiteXL was executed 
  from the root path of a partition or from ram disk (#13)

## [1.16.12.5] - 2022-01-03
### Changed
- Changed the Gfx memory leak solution to a fix that was applied by the
  editor development team on Lua scripts at a later version. Less custom
  code for AmigaOS 4 port.
- Now, when return from fullscreen, there is no extra header visible
  at the top of the window content

### Fixed
- Fixed the assertion error and crash when the window is resized (#2)
- Fixed the resolution on fullscreen toggle to be like the workbench (#4)
- Fixed loading the current folder from terminal using the dot, like 
  `lite .` or without it (#3)

## [1.16.12.4] - 2021-12-31
### Fixed
- Fixed the Gfx memory leak. Now LiteXL frees the reserved memory from the
  gfx card.

## [1.16.12.3] - 2021-12-29
### Changed
- Compiled with an experimental version of the latest Anti-Grain Geometry
  library. This is might have issues and crash LiteXL

## [1.16.12.2] - 2021-12-26
### Added
- Added Amiga version. This version of LiteXL is based on v1.16.12 source code 
  which will not change. I will use the fourth digit to distinguish different 
  AmigaOS 4 releases, until a new port of the latest available source (v2.x) 
  is made.

### Fixed
- The keyboard shortcuts are now working

### Changed
- Now the `HOME` ENV variable is optional. If this is not set, the LiteXL 
  folder will be used to create user's `.config` folder