index 8bc9c167ad8d345311a0e61fa162e37e482e16b5..fbde840fc2f60a4b4d5f05feeb203fe8c68916b3 100644 (file)
--- a/README
+++ b/README
-** Ducumentation (Russian): **
+Ducumentation (Russian):
- http://gitlab.molpit.com/idenisov/blackbox-linux/wikis/home
+ http://gitlab.molpit.com/oberon/blackbox-freenix/wikis/home
+Directories structure:
-** Folders structure: **
+ BlackBox/
+ universal development environment
+ synchronized with original BlackBox 1.6
-./new/
- universal development environment
- synchronized with original BlackBox 1.6
+ examples/
+ some outdated examples
+ console/
+ simple console application
+ fpstest/
+ loop test
+ server/
+ static web-server as the example of an application for Linux OS
-./examples/ (all axamples are not tested on `new` version yet)
- /server/
- static web-server as the example of an application for Linux OS
- /console/
- simple console application
- /fpstest/
- loop test
-
-** Installation **
+Installation of required packages in Ubuntu 14.04 (should work also with other Debian-based OS):
-1. For creating links in development directory run:
+ 32-bit version:
+ sudo apt-get install libgtk2.0-0 gtk2-engines gtk2-engines-murrine libcanberra-gtk-module
+ sudo apt-get install libgnomeui-0
- cd ./new
- ./README
+ 64-bit version:
+ sudo apt-get install libc6-dev-i386
+ 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
+ sudo apt-get install libgnomeui-0:i386
- To start:
+ Comments:
+ 'libc6-dev-i386' is required for compilation of 'loader', after build it can be replaced by 'libc6-i386'
+ 'libgnomeui-0:i386' is required only for run blackbox by 'run-BlackBox-2' starter
- ./run-BlackBox
-2. For creating assembly for target OS in development directory run:
+To build BlackBox:
+ cd BlackBox
+ ./switch-target `uname -s` GUI
+ ./build
- cd ./new
- ./export (Linux|OpenBSD|FreeBSD) (GUI|)
+To run BlackBox (after build):
- Example for Linux:
+ ./run-BlackBox
+ or
+ ./run-BlackBox-2
- ./export Linux GUI
-
- Then:
+To create BlackBox assembly (after build):
- cd ../Linux_GUI
- ./build
+ ./export <outputDirectory>
- To start with .so loader:
+To clean the BlackBox folder:
+ ./switch-target none
+ ./clean
- ./run-BlackBox
+Example: build, create assembly in /tmp, run BlackBox from assembly:
+ cd BlackBox
+ ./switch-target `uname -s` GUI
+ ./build
+ ./export /tmp/BlackBox-`uname -s`
+ ./switch-target none
+ ./clean
+ cd /tmp/BlackBox-`uname -s`
+ ./run-BlackBox
- To start with .ELF loader
-
- ./run-BlackBox-2