annotate readme.rst @ 388:e07c2a9abac1

Enabled paging in kernel
author Windel Bouwman
date Fri, 02 May 2014 14:51:46 +0200
parents 6df89163e114
children
rev   line source
187
bf5ab358f43a Renamed readme and added status badge
Windel Bouwman
parents: 43
diff changeset
1
273
6b3a874edd6e Added some docs
Windel Bouwman
parents: 257
diff changeset
2 About
6b3a874edd6e Added some docs
Windel Bouwman
parents: 257
diff changeset
3 =====
6b3a874edd6e Added some docs
Windel Bouwman
parents: 257
diff changeset
4
6b3a874edd6e Added some docs
Windel Bouwman
parents: 257
diff changeset
5 Project goals
6b3a874edd6e Added some docs
Windel Bouwman
parents: 257
diff changeset
6 -------------
6b3a874edd6e Added some docs
Windel Bouwman
parents: 257
diff changeset
7
283
c9781c73e7e2 Added first kernel files
Windel Bouwman
parents: 282
diff changeset
8 * To write a microkernel based OS
c9781c73e7e2 Added first kernel files
Windel Bouwman
parents: 282
diff changeset
9 * Write the kernel in the c3 language
c9781c73e7e2 Added first kernel files
Windel Bouwman
parents: 282
diff changeset
10 * Create a c3 compiler in python
9
92ace1ca50a8 64 bits kernel without interrupts but with printf in C
windel
parents: 1
diff changeset
11
273
6b3a874edd6e Added some docs
Windel Bouwman
parents: 257
diff changeset
12 Directory structure
6b3a874edd6e Added some docs
Windel Bouwman
parents: 257
diff changeset
13 -------------------
188
1113da536872 Used markdown
Windel Bouwman
parents: 187
diff changeset
14
283
c9781c73e7e2 Added first kernel files
Windel Bouwman
parents: 282
diff changeset
15 'kernel' contains the microkernel.
c9781c73e7e2 Added first kernel files
Windel Bouwman
parents: 282
diff changeset
16 'python' contains the python utilities.
9
92ace1ca50a8 64 bits kernel without interrupts but with printf in C
windel
parents: 1
diff changeset
17
376
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
18
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
19 How to run this?
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
20 ----------------
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
21
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
22 Install required software:
283
c9781c73e7e2 Added first kernel files
Windel Bouwman
parents: 282
diff changeset
23
300
Windel Bouwman
parents: 299
diff changeset
24 * python3.3
283
c9781c73e7e2 Added first kernel files
Windel Bouwman
parents: 282
diff changeset
25 * (optional) pyqt5, pyqt4 or pyside
1
92df07bc2081 Initial import of compiler
windel
parents:
diff changeset
26
376
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
27 Checkout the code:
1
92df07bc2081 Initial import of compiler
windel
parents:
diff changeset
28
290
7b38782ed496 File moves
Windel Bouwman
parents: 283
diff changeset
29 .. code:: bash
7b38782ed496 File moves
Windel Bouwman
parents: 283
diff changeset
30
376
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
31 hg clone https://bitbucket.org/windel/lcfos
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
32 cd lcfos
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
33
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
34 Run some unit tests:
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
35
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
36 .. code:: bash
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
37
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
38 cd test
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
39 python3 run_tests.py
256
225f444019b1 Added build and flash menu option
Windel Bouwman
parents: 213
diff changeset
40
298
f7c3d38d0a47 Added reference to read the docs
Windel Bouwman
parents: 290
diff changeset
41
376
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
42 Weblinks
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
43 --------
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
44
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
45 Docs are located here:
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
46 http://lcfos.readthedocs.org/en/latest/
318
e84047f29c78 Add burg and yacc initial attempts
Windel Bouwman
parents: 300
diff changeset
47
e84047f29c78 Add burg and yacc initial attempts
Windel Bouwman
parents: 300
diff changeset
48 Sources are located here:
e84047f29c78 Add burg and yacc initial attempts
Windel Bouwman
parents: 300
diff changeset
49 https://bitbucket.org/windel/lcfos
e84047f29c78 Add burg and yacc initial attempts
Windel Bouwman
parents: 300
diff changeset
50
376
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
51 here:
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
52 http://hg.assembla.com/lcfOS/
298
f7c3d38d0a47 Added reference to read the docs
Windel Bouwman
parents: 290
diff changeset
53
376
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
54 and here:
1e951e71d3f1 Change to readme
Windel Bouwman
parents: 352
diff changeset
55 https://pikacode.com/windel/lcfos/
290
7b38782ed496 File moves
Windel Bouwman
parents: 283
diff changeset
56
298
f7c3d38d0a47 Added reference to read the docs
Windel Bouwman
parents: 290
diff changeset
57
300
Windel Bouwman
parents: 299
diff changeset
58 The project is contains tests which are run continuously at drone.io.
Windel Bouwman
parents: 299
diff changeset
59
273
6b3a874edd6e Added some docs
Windel Bouwman
parents: 257
diff changeset
60 .. image:: https://drone.io/bitbucket.org/windel/lcfos/status.png
283
c9781c73e7e2 Added first kernel files
Windel Bouwman
parents: 282
diff changeset
61
352
899ae3aea803 First kernel run for vexpressA9
Windel Bouwman
parents: 332
diff changeset
62 https://drone.io/bitbucket.org/windel/lcfos
899ae3aea803 First kernel run for vexpressA9
Windel Bouwman
parents: 332
diff changeset
63
899ae3aea803 First kernel run for vexpressA9
Windel Bouwman
parents: 332
diff changeset
64 Repository metrics:
899ae3aea803 First kernel run for vexpressA9
Windel Bouwman
parents: 332
diff changeset
65
290
7b38782ed496 File moves
Windel Bouwman
parents: 283
diff changeset
66 .. image:: https://www.ohloh.net/p/lcfos/widgets/project_thin_badge.gif
43
e47bfef80baf Fixed build by commenting out initrd code
windel
parents: 41
diff changeset
67
352
899ae3aea803 First kernel run for vexpressA9
Windel Bouwman
parents: 332
diff changeset
68 http://www.ohloh.net/p/lcfos
899ae3aea803 First kernel run for vexpressA9
Windel Bouwman
parents: 332
diff changeset
69
41
35cc54e078dd Added memory functions
windel
parents: 9
diff changeset
70
381
6df89163e114 Fix section and ldr pseudo instruction
Windel Bouwman
parents: 377
diff changeset
71 Live demo is at redhat openshift:
6df89163e114 Fix section and ldr pseudo instruction
Windel Bouwman
parents: 377
diff changeset
72
6df89163e114 Fix section and ldr pseudo instruction
Windel Bouwman
parents: 377
diff changeset
73 http://lcfos-windel.rhcloud.com/
6df89163e114 Fix section and ldr pseudo instruction
Windel Bouwman
parents: 377
diff changeset
74
6df89163e114 Fix section and ldr pseudo instruction
Windel Bouwman
parents: 377
diff changeset
75