README updates

HISTORY.md

@@ -1,8 +1,10 @@
-## 1.1.0-alpha.7 - 2023-01-09
+## 1.1.0-alpha.7 - 2023-01-11
 
 * Debug output and "--debug" key
 * Unicode support in modules In and Out on Windows
 * Automatic linking of external libraries
+* OS clipboard integration
+* Fix paste of large text
 * Fix compilation outside FreeOberon directory on Windows
 * Fix parser in project builder
 

README.md

@@ -1,10 +1,10 @@
 # Free Oberon programming environment
 
-Oberon is a general-purpose programming language–the simplest of all, yet fully powerful. It is the old good Pascal, but developed and perfected.
+Oberon is a general-purpose programming language–the direct descendant of Pascal and Modula-2. It is both simpler and much more powerful than Pascal and Modula.
 
-Free Oberon is a cross-platform integrated development environment for programming in Oberon, made in the classical pseudo-graphic style (the famous blue Pascal screen).
+Free Oberon is a cross-platform integrated development environment for the Oberon programming language, designed in the classic pseudo-graphic style–the famous blue screen of Pascal.
 
-Fob is a console Oberon compiler.
+Fob is a convenient console-based Oberon compiler.
 
 ![Free Oberon screenshot](http://free.oberon.org/images/screenshot.png)
 
@@ -14,14 +14,14 @@ Fob is a console Oberon compiler.
 
 # Среда программирования Free Oberon
 
-Оберон — самый простой, и при этом всецело мощный, язык программирования общего назначения. Это развитый и доведённый до совершенства Паскаль.
+Оберон — язык программирования общего назначения, прямой наследник Паскаля и Модулы-2. Он одновременно и проще, и намного мощнее, чем Паскаль и Модула.
 
-Free Oberon представляет собой кроссплатформенную интегрированную среду разработки на языке программирования Оберон, выполненную в классическом псевдографическом стиле — знаменитого синего экрана Паскаля).
+Free Oberon представляет собой кроссплатформенную интегрированную среду разработки на языке программирования Оберон, выполненную в классическом псевдографическом стиле — знаменитого синего экрана Паскаля.
 
 Fob — это консольный компилятор языка Оберон.
 
-* Версия 1.1.0-alpha.6
-* Рига, 22 апреля 2022 г.
+* Версия 1.1.0-alpha.7
+* Рига, 11 января 2023 г.
 * Сайт: [free.oberon.org](https://free.oberon.org)
 
 # Установка
@@ -37,7 +37,7 @@ Fob — это консольный компилятор языка Оберон
    На сайте https://github.com/kekcleader/FreeOberon.git
    нажмите зелёную кнопку «Code» и «Download ZIP»,
    распакуйте архив в домашнем каталоге.
-   Вы можете переименовать каталог `FreeOberon-main` в `FreeOberon`.
+   Переименуйте каталог `FreeOberon-main` в `FreeOberon`.
 
 2. Находясь в распакованном каталоге, запустите `install.sh` с правами администратора.
   ```
@@ -55,7 +55,7 @@ Fob — это консольный компилятор языка Оберон
   ```
   Это позволит запускать Free Oberon командой `fo`.
 
-  Для запуска Free Oberon на русском языке, напишите:
+  Для запуска Free Oberon на конкретном языке, укажите язык (en или ru):
   ```
   ./FreeOberon --lang ru
   ```
@@ -75,14 +75,13 @@ Fob — это консольный компилятор языка Оберон
 # Использование
 
 Запустите Free Oberon и наберите текст программного модуля на языке Оберон (или откройте файл с примером программы, например `Life.Mod`). Нажмите `F9`, чтобы скомпилировать и запустить программу.
-Файлы с исходным кодом ваших программ сохраняются в подкаталоге `Programs`, а скомпилированные исполняемые файлы сохраняются в подкаталоге `bin`. Сценарий `Data/bin/compile.sh` (`Data\bin\compile.bat`) используется на Линуксе (Виндоусе) для компиляции программ на Обероне. Вы можете править эти сценарии.
+Файлы с исходным кодом ваших программ сохраняются в подкаталоге `Programs`, а скомпилированные исполняемые файлы сохраняются в подкаталоге `bin`. Сценарий `Data/bin/compile.sh` (`Data\bin\compile.bat`) используется на Линуксе (Виндоусе) в ходе компиляции. Вы можете править эти сценарии.
 
-Можно писать программы, состоящие из нескольких модулей. Откройте главный модуль и нажмите `F9`. Free Oberon автоматически компилирует их в правильном порядке.
+Можно писать программы, состоящие из нескольких модулей. Откройте главный модуль и нажмите `F9`. Free Oberon автоматически скомпилирует и скомпонует их в правильном порядке.
 
-Если вы компилируете программу, файл главного модуля которой не находится непосредственно в подкаталоге `Programs`, то скомпилированный исполнимый файл будет находится рядом с ним, а не в подкаталоге `bin`.
+Если вы компилируете программу, файл главного модуля которой не находится непосредственно в подкаталоге `Programs` или `Programs/Examples`, то скомпилированный исполнимый файл будет находится рядом с ним, а не в подкаталоге `bin`.
 
 Если в одном из модулей программы будет найдена ошибка, соответствующий файл откроется, место и характер ошибки будут указаны. Чтобы перекомпилировать, снова перейдите к окну главного модуля и нажмите `F9`.
-Если в программе используется модуль Graph, к ней будет автоматически прикомпонована библиотека Allegro5 — будет использован сценарий `Data/bin/link_graph.sh` (`.bat`) вместо `Data/bin/link_console.sh`.
 
 [История версий](HISTORY.md)
 
@@ -91,13 +90,13 @@ ______
 
 *ENGLISH*
 
-* Version 1.1.0-alpha.6
-* Riga, April 22, 2022
+* Version 1.1.0-alpha.7
+* Riga, January 11, 2023
 * Website: [free.oberon.org](https://free.oberon.org/en)
 
 # Install
 
-## Installation on Linux
+## Install on Linux
 
 1. Download Free Oberon in tar.gz format from
    [free.oberon.org](https://free.oberon.org/en/download)
@@ -108,7 +107,7 @@ ______
    Go to https://github.com/kekcleader/FreeOberon.git and
    click the green button labeled "Code" and then click "Download ZIP",
    unpack the archive inside your home directory.
-   You can rename directory `FreeOberon-main` to `FreeOberon`.
+   Rename directory `FreeOberon-main` to `FreeOberon`.
 
 2. Inside the unpacked directory, run `install.sh` with root privileges.
   ```
@@ -126,8 +125,17 @@ ______
   ```
   This will allow you to launch Free Oberon using the `fo` command.
 
+  To run Free Oberon in a specific language, specify it (en or ru):
+  ```
+  ./FreeOberon --lang ru
+  ```
+  or
+  ```
+  fo --lang ru
+  ```
+
 
-## Installation on Windows
+## Install on Windows
 
 Download Free Oberon in a ZIP archive (from [free.oberon.org](https://free.oberon.org/en)), extract it to a path on the disk that does not have any non-latin characters in it, and lauch `FreeOberon.exe`.
 
@@ -137,13 +145,12 @@ Note. If you want to recompile Free Oberon under Windows from the source code, r
 # Usage
 
 Run Free Oberon and type the text of an Oberon module (or open a sample program such as `Life.Mod`) and press `F9` to compile and run the program.
-The source code files of your programs are saved in the `Programs` subdirectory, and the compiled executables are saved in the `bin` subdirectory. The script `Data/bin/compile.sh` (`Data\bin\compile.bat`) is used on Linux (Windows) to compile an Oberon program. You can edit these scripts.
+The source code files of your programs are saved in the `Programs` subdirectory, and the compiled executables are saved in the `bin` subdirectory. The script `Data/bin/compile.sh` (`Data\bin\compile.bat`) is used on Linux (Windows) for compilation. You can edit these scripts.
 
-You can write programs consisting of several modules. Open the main module and press `F9`. Free Oberon automatically compiles them in the correct order.
+You can write programs consisting of several modules. Open the main module and press `F9`. Free Oberon automatically compiles and links them in the correct order.
 
-If you compile a program whose main module file is not directly in the `Programs` subdirectory, the compiled executable will be located next to it and not in the `bin` subdirectory.
+If you compile a program whose main module file is not directly in the `Programs` or `Programs/Examples` subdirectory, the compiled executable will be located next to it and not in the `bin` subdirectory.
 
 If an error occurres during the compilation of one of the modules, the corresponding file will be open and error position and message will be indicated. To recompile, go to the main module window again and press `F9`.
-If module Graph is used in the program, Allegro5 will be automatically linked to it – `Data/bin/link_graph.sh` (`.bat`) will be used instead of `Data/bin/link_console.sh`.
 
 [Version history](HISTORY.md)

README_build_eng.md

@@ -1,6 +1,6 @@
 # How to build a new version of Free Oberon for Linux
 
-The commands are for Debian / Ubuntu.
+The commands are for Debian/Ubuntu OS.
 
 ## Option 1. Download the archive and run the installer
 
@@ -18,7 +18,7 @@ su
 
 ## Option 2. Build Free Oberon manually
 
-1. Install Git, Gcc and Allegro5:
+1. Install Git, GCC and Allegro5:
 ```
 apt-get install -y liballegro5-dev git gcc
 ```
@@ -60,4 +60,4 @@ This is done from the directory where the executable file `FreeOberon` is locate
 ./FreeOberon
 ```
 
-Document updated January 27, 2022.
+Document updated on January 11, 2023.

README_build_rus.md

@@ -1,6 +1,6 @@
 # Как собрать новую версию Free Oberon под Линукс
 
-Команды приведены для ОС Дебиан / Убунту.
+Команды приведены для ОС Дебиан/Убунту.
 
 ## Вариант 1. Скачать архив и запустить установщик
 
@@ -17,17 +17,17 @@ su
 
 ## Вариант 2. Собрать Free Oberon вручную
 
-1. Установите Git, Gcc и Allegro5:
+1. Установите Git, GCC и Allegro5:
 ```
 apt-get install -y liballegro5-dev git gcc
 ```
 
-2. Клонируйте репозиторий Free Oberon:
+2. Склонируйте репозиторий Free Oberon:
 ```
 git clone https://github.com/kekcleader/FreeOberon.git
 ```
 
-3. Клонируйте репозиторий OfrontPlus с помощью команды загрузки подмодулей:
+3. Склонируйте репозиторий OfrontPlus с помощью команды загрузки подмодулей:
 
 ```
 cd FreeOberon
@@ -59,4 +59,4 @@ cd FreeOberon/src
 ./FreeOberon
 ```
 
-Документ обновлён 27 января 2022 года.
+Документ обновлён 11 апреля 2023 года.