os-k/README.md

42 lines
1.3 KiB
Markdown

# OS/K (OS on Kaleid)
| ![FSF Logo](https://www.os-k.eu/GPLLOGO.PNG) | This program is free software, released under the terms of the [GNU GPL](COPYING) version 3 or later as published by the Free Software Foundation |
|----------------------------------------------|----------------------------------------------------------------------|
### Fully free operating system from scratch (WIP)
For the project plan, see [OS/K Project](https://github.com/orgs/os-k-team/projects/1)
For changelog, see [ChangeLog](ChangeLog)
For structure of the sources, see [ProjectTree](ProjectTree)
For our IRC channel, see `#os.k-devel` on [Freenode](https://webchat.freenode.net)
Note that every file within OS/K is written using spaces for tabulation, with each
tabulation being 4 spaces long.
#### Compile from sources
To compile this project from sources (on Debian), you must first install the dependencies
```
apt update && apt upgrade
apt install grub-pc-bin dosfstools make nasm qemu tree
```
You also need to have one of these x86-64 ELF cross-compiler, depending on your system: [GCC 7 cross-compiler](https://www.os-k.eu/build-tools/cross-cc.tar.xz) or [GCC 8 cross-compiler]()
Place its ``bin`` directory in your PATH.
To compile, simply use at the root of this project :
```
make
```
To compile and test, simply use at the root of this project :
```
make test
```