Merge branch 'master' of ssh://svjatoslav.eu:10006/home/n0/git/fifth
[fifth.git] / doc / index.org
index 6096aba..fca8640 100644 (file)
@@ -1,4 +1,5 @@
 #+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">
@@ -8,41 +9,37 @@
 #+HTML_HEAD:   footer {background-color: #111 !important;}
 #+HTML_HEAD:   pre {background-color: #111; color: #ccc;}
 #+HTML_HEAD: </style>
-
 * 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
-  - Homepage: http://svjatoslav.eu
+  - Homepage: https://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
-- [[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:
-  : 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
-[[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
-operating system and not updated since.
+operating system.
 * 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.
@@ -62,13 +59,16 @@ inspired created my own system.
 
 * 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
+:PROPERTIES:
+:ID:       0759f3e0-28bb-4901-9e4f-09ef41732173
+:END:
 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
+: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