Browse Source

Revert "Update README.md"

This reverts commit a1ea154ff0ba201ea5ff7b7054858f12a003c562.
Alexander Shiryaev 1 year ago
parent
commit
5aabd963e9
1 changed files with 76 additions and 81 deletions
  1. 76 81
      README.md

+ 76 - 81
README.md

@@ -1,125 +1,120 @@
-# BlackBox Component Builder cross-platform
-
-## Supported operating systems
-
-List of supported operating systems:
-* Windows
-* GNU/Linux (amd64, i386)
-* OpenBSD (i386)
-* FreeBSD (i386)
+BlackBox Component Builder for Windows, GNU/Linux, OpenBSD, FreeBSD
 
 Tested on:
-* Windows XP, Windows 7, Windows 10, Windows 11
-* GNU/Linux:
-  * Ubuntu 16.04 LTS, 18.04 LTS, 20.04 LTS
-  * Debian 9.3, 9.4 (Xfce/Mate/GNOME/Cinnamon)
-  * Mint 20 (Cinnamon)
-  * Fedora Core 17
-  * Red Hat Enterprise Linux Server 6.3
-  * CentOS 8
-  * Arch Linux 4.9.6, Manjaro Linux 18.0.4
-  * Alt Education 9.1
-* OpenBSD 7.2 (i386)
-* FreeBSD 12.1 (i386)
+* Windows XP, 7, 10, 11
+* Ubuntu 16.04 LTS, 18.04 LTS, 20.04 LTS
+* Alt Education 9.1
+* Debian 9.3, 9.4 Xfce/Mate/GNOME/Cinnamon
+* Linux Mint 20 Cinnamon
+* FreeBSD 12.1
+* OpenBSD 6.8
+* CentOS 8
+* Arch Linux 4.9.6, Manjaro Linux 18.0.4
+* Red Hat Enterprise Linux Server 6.3
+* Fedora Core 17
 
-## Packages
+Download: https://blackbox.oberon.org/download
 
-Packages available [here](https://blackbox.oberon.org/download)
+Directories structure:
 
-## Build
+	BlackBox/
+		universal development environment for Component Pascal programming language
+	BlackBox/_*
+		platform-specific files
 
-### Install dependencies
+	dev/
+		files for continuous integration system & technical notes for framework developers
 
-#### Ubuntu 18.04 LTS Bionic Beaver / Linux Mint 19.X (amd64)
+	examples/
+		append/  - append string to .odc file
+		encoder/ - encoding subsystems by StdCoder from the command line
+		server/  - static web-server
 
-	sudo dpkg --add-architecture i386
-	sudo apt update
-	sudo apt install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386 gnome-themes-extra:i386
+Prepare BlackBox from repository on Windows:
 
-Linux Mint 20 has no package 'gnome-themes-extra:i386', it can be safly ignored. There will be warning in console.
+	copy _Windows_, _Windows_GUI and __GUI content to the BlackBox directory
+	remove other directories starting with "_"
+	run build.bat
 
-#### Ubuntu 16.04 LTS (i386)
 
-	sudo apt-get install libgtk2.0-0 gtk2-engines gtk2-engines-murrine libcanberra-gtk-module gnome-icon-theme-full
+Installation of required packages in Debian-based systems:
 
-#### Ubuntu 16.04 LTS (amd64)
+	For Alt Education 9.1
 
-	sudo dpkg --add-architecture i386
-	sudo apt-get update
-	sudo apt-get install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386 gnome-icon-theme-full
+		apt-get install i586-libgtk+2-devel.32bit
 
-#### Debian 9 (amd64)
+	Ubuntu 18.04 LTS Bionic Beaver / Linux Mint 19.X:
 
-	sudo dpkg --add-architecture i386
-	sudo apt update
-	sudo apt install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386 gtk2-engines-pixbuf:i386 libatk-adaptor:i386 libgail-common:i386 gnome-themes-standard:i386
+		sudo dpkg --add-architecture i386
+		sudo apt update
+		sudo apt install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386 gnome-themes-extra:i386
 
-#### Arch-based systems (amd64)
+	Linux Mint 20 has no package 'gnome-themes-extra:i386', it can be safly ignored. There will be warning in console.
 
-	sudo pacman -S multilib/lib32-gtk2
+	Debian 9.X GNOME/Xfce/KDE
 
-#### Alt Education 9 (amd64)
+		sudo dpkg --add-architecture i386
+		sudo apt update
+		sudo apt install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386 gtk2-engines-pixbuf:i386 libatk-adaptor:i386 libgail-common:i386 gnome-themes-standard:i386
 
-	apt-get install i586-libgtk+2-devel.32bit
+	Ubuntu 16.04 LTS i386:
 
-#### OpenBSD (i386)
+		sudo apt-get install libgtk2.0-0 gtk2-engines gtk2-engines-murrine libcanberra-gtk-module gnome-icon-theme-full
 
-Use 'wxallowed' flag in mount options for the partition to build or start BlackBox from.
+	Ubuntu 16.04 LTS amd64:
 
-### Build
+		sudo dpkg --add-architecture i386
+		sudo apt-get update
+		sudo apt-get install libgtk2.0-0:i386 gtk2-engines:i386 gtk2-engines-murrine:i386 libcanberra-gtk-module:i386 gnome-icon-theme-full
 
-#### Build GNU/Linux version
 
-	./build-linux
+	Arch-based systems amd64:
 
-#### Build OpenBSD version
+		sudo pacman -S multilib/lib32-gtk2
 
-	./build-openbsd
+In OpenBSD use 'wxallowed' flag in mount options for the partition to start BlackBox from.
 
-#### Build FreeBSD version
 
-	./build-freebsd
 
-#### Build Windows version
+To build BlackBox:
 
-	./build-windows
+	cd BlackBox
+	./switch-target `uname -s` GUI
+	./build
 
-On Windows, these commands can be run from [MSYS2](https://www.msys2.org/)
+To run BlackBox (after build):
 
-There is also a *build-windows.bat* script that can be used to build the Windows version from Windows or Wine
+	./run-BlackBox
 
-## Install
+for Linux version also you can run
 
-	./export <outputDirectory>
+	./blackbox
 
-## Run
+To create BlackBox framework assembly (after build):
 
-### BlackBox Component Builder
+	./export <outputDirectory>
 
-On Windows:
+To clean the BlackBox folder:
 
-	BlackBox.exe
+	./switch-target none
+	./clean
 
-On other operating systems:
+Example: build, create framework assembly and run BlackBox from it:
 
+	cd BlackBox
+	./switch-target `uname -s` GUI
+	./build
+	./export ../`uname -s`_GUI
+	./switch-target none
+	./clean
+	cd ../`uname -s`_GUI
 	./run-BlackBox
 
-### BlackBox Component Builder interpreter
-
-On Windows:
-
-	BlackBoxInterp.exe
-
-On other operating systems:
-
-	./run-BlackBoxInterp
-
-## Authors
-
+Authors:
 * Oberon microsystems AG
 * BlackBox Framework Center
-* Ivan Denisov
-* Igor Dehtyarenko
-* Anton Dmitriev
-* Boris Rumshin
-* Alexander Shiryaev
+* Alexander V. Shiryaev
+* Igor A. Dehtyarenko
+* Ivan A. Denisov
+* Anton A. Dmitriev
+* Boris V. Rumshin