Merge branch 'master' of ssh://svjatoslav.eu:10006/home/n0/git/fifth

[fifth.git] / doc / index.org

diff --git a/doc/index.org b/doc/index.org
index 6096aba..fca8640 100644 (file)
--- a/doc/index.org
+++ b/doc/index.org
@@ -1,4 +1,5 @@
 #+TITLE: Fifth - virtual machine, operating system, programming language
 #+TITLE: Fifth - virtual machine, operating system, programming language

+

 * (document settings) :noexport:
 ** use dark style for TWBS-HTML exporter
 #+HTML_HEAD: <link href="https://bootswatch.com/3/darkly/bootstrap.min.css" rel="stylesheet">
 * (document settings) :noexport:
 ** use dark style for TWBS-HTML exporter
 #+HTML_HEAD: <link href="https://bootswatch.com/3/darkly/bootstrap.min.css" rel="stylesheet">


@@ -8,41 +9,37 @@
 #+HTML_HEAD:   footer {background-color: #111 !important;}
 #+HTML_HEAD:   pre {background-color: #111; color: #ccc;}
 #+HTML_HEAD: </style>
 #+HTML_HEAD:   footer {background-color: #111 !important;}
 #+HTML_HEAD:   pre {background-color: #111; color: #ccc;}
 #+HTML_HEAD: </style>

-

 * General
 * General

-- This program is free software: you can redistribute it and/or modify
-  it under the terms of the [[https://www.gnu.org/licenses/lgpl.html][GNU Lesser General Public License]] as
-  published by the Free Software Foundation, either version 3 of the
-  License, or (at your option) any later version.
+- This program is free software: released under Creative Commons Zero
+  (CC0) license

 
 - Program author:
   - Svjatoslav Agejenko
 
 - Program author:
   - Svjatoslav Agejenko

-  - Homepage: http://svjatoslav.eu
+  - Homepage: https://svjatoslav.eu

   - Email: mailto://svjatoslav@svjatoslav.eu
 
   - Email: mailto://svjatoslav@svjatoslav.eu
 

-- [[http://www.svjatoslav.eu/projects/][Other software projects hosted at svjatoslav.eu]]
-
+- [[https://www.svjatoslav.eu/projects/][Other software projects hosted at svjatoslav.eu]]

 ** Source code
 ** Source code

-- [[http://www2.svjatoslav.eu/gitweb/?p=fifth.git;a=snapshot;h=HEAD;sf=tgz][Download latest snapshot in TAR GZ format]]
+- [[https://www2.svjatoslav.eu/gitweb/?p=fifth.git;a=snapshot;h=HEAD;sf=tgz][Download latest snapshot in TAR GZ format]]

 
 

-- [[http://www2.svjatoslav.eu/gitweb/?p=fifth.git;a=summary][Browse Git repository online]]
+- [[https://www2.svjatoslav.eu/gitweb/?p=fifth.git;a=summary][Browse Git repository online]]

 
 - Clone Git repository using command:
 
 - Clone Git repository using command:

-  : git clone http://www2.svjatoslav.eu/git/fifth.git
+  : git clone https://www2.svjatoslav.eu/git/fifth.git

 
 

-* Warning
+* !Project deprecated!

 Current implementation does not support object oriented
 programming. While working on Fifth I got lots of cool new ideas that
 require reimplementation of everything.
 
 Currently I try to implement those new ideas in the project called
 Current implementation does not support object oriented
 programming. While working on Fifth I got lots of cool new ideas that
 require reimplementation of everything.
 
 Currently I try to implement those new ideas in the project called

-[[http://www3.svjatoslav.eu/projects/sixth/][Sixth]]
+[[https://www3.svjatoslav.eu/projects/sixth/][Sixth]].

 
 System is built many years ago when I was still using DOS as a primary
 
 System is built many years ago when I was still using DOS as a primary

-operating system and not updated since.
+operating system.

 * Introduction
 * Introduction

-Fifth is programming lanquage & operating system, running on [[emulator.html][virtual
-CPU]], with custom instruction set. It is much like Charles Chunk
+Fifth is programming lanquage & operating system, running on [[id:9b251eb9-aff6-4025-94bf-25e89e26d54a][virtual
+machine]], with custom instruction set. It is much like Charles Chunk

 Moore's Forth, it also uses stack architecture, and many commands are
 similar. Basically I got familiar with concepts of Forth, and being
 inspired created my own system.
 Moore's Forth, it also uses stack architecture, and many commands are
 similar. Basically I got familiar with concepts of Forth, and being
 inspired created my own system.


@@ -62,13 +59,16 @@ inspired created my own system.
 
 * Installation
 Just unpack all files, witout altering original directory structure,
 
 * Installation
 Just unpack all files, witout altering original directory structure,

-somewhere in your hard disk. For example:
-: C:\MISC\FIFTH\....
-To run fifth you need minimally just 2 files.  emulator itself (
-EMULATOR.EXE or EMULATOR.COM ), and virtual disk file ( DISK.RAW ).
+somewhere in your hard disk. For example: C:\MISC\FIFTH\....  To run
+fifth you need minimally just 2 files.  emulator itself ( EMULATOR.EXE
+or EMULATOR.COM ), and virtual disk file ( DISK.RAW ).
+
+Read more about [[id:0759f3e0-28bb-4901-9e4f-09ef41732173][Fifth distribution directory tree description]].

 
 

-Read more about [[files.txt][distribution directory layout]]

 * Fifth distribution directory tree description
 * Fifth distribution directory tree description

+:PROPERTIES:
+:ID:       0759f3e0-28bb-4901-9e4f-09ef41732173
+:END:

 After downloading and unpacking the ZIP file you shoud get directory
 tree similar to this:
 
 After downloading and unpacking the ZIP file you shoud get directory
 tree similar to this:
 


@@ -182,6 +182,9 @@ run through headers backwards and find needed entry.
 | 200000h |        | core startup messages area  |
 | 5200000 |        | end of dynamic memory space |
 * Virtual machine
 | 200000h |        | core startup messages area  |
 | 5200000 |        | end of dynamic memory space |
 * Virtual machine

+:PROPERTIES:
+:ID:       9b251eb9-aff6-4025-94bf-25e89e26d54a
+:END:

 Using CPU emulator slows it down but I shouldn't now think too mutch
 about, and waste my time on batteling with problems whitch results on
 complex design of PC hardware. Also it allows me to use existing DOS
 Using CPU emulator slows it down but I shouldn't now think too mutch
 about, and waste my time on batteling with problems whitch results on
 complex design of PC hardware. Also it allows me to use existing DOS