izaya
/
OC-PsychOS2
mirror of https://git.shadowkat.net/izaya/OC-PsychOS2.git
1
1
Fork 0
Code Issues 0 Releases 0 Wiki Activity
Operating system for OpenComputers
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
252 Commits
1 Branch
1.1MB
Tree: 8e84eb0c67
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '8e84eb0c67'
${ noResults }
XeonSquared 8e84eb0c67 switched to using string.(un)pack in libmtar and liblz16, meaning it works on both big and little endian machines, and should be smaller and faster 3 years ago
cfg cleaner default source list 4 years ago
lib switched to using string.(un)pack in libmtar and liblz16, meaning it works on both big and little endian machines, and should be smaller and faster 3 years ago
module added some more keyboard shortcuts to io.read linemode 3 years ago
service modify the two services people actually use to work with the new service semantics 3 years ago
.editorconfig clipboard: Make the clipboard service work under the new service sys 4 years ago
.gitignore clipboard: Make the clipboard service work under the new service sys 4 years ago
LICENSE Initial commit 5 years ago
README.md updated the README to represent the current state of the system 4 years ago
build.lua added the preproc library, meaning PsychOS is nominally self-hosting 4 years ago
build.sh bumped the version number because we selfhosting now 4 years ago
docs-metadata.yml added a title for PDF generation 4 years ago
finddesc.lua Fix document generation on Windows (using Git Bash) 4 years ago
gendoc.lua added doc() support for pre-compiled API documentation, wrote a generator for it, and included that in the build script 4 years ago
luapreproc.lua added type annotations and descriptions for functions where appropriate 4 years ago
package.sh added minitel to the default init, updated the package script 4 years ago
preproc.lua move actual preproc lib into folder rather than symlinking to the version in lib/, a better solution will be considered later 4 years ago
template.tex updated finddesc to use the new doc library, allowing type annotations and building a directory of documentation 4 years ago

README.md

OC-PsychOS2

A lightweight, multi-user operating system for OpenComputers

Building

The kernel

The kernel is composed of a number of modules, found in the module/ directory. Which modules are included can be customised by changing the include statements in module/init.lua; copying it and customizing that is recommended, so you can git pull later without having to stash or reset your changes.

Unix-like systems

The kernel can be built using the preproc library and provided scripts:

lua build.lua module/init.lua kernel.lua

PsychOS

The kernel can be built from inside PsychOS using the preproc library, assuming you have the kernel source available:

preproc("module/init.lua","kernel.lua")

The boot filesystem

A boot filesystem contains several things:

  • The kernel, as init.lua
  • The lib/ directory, containing libraries
  • The service/ directory, containing system services

This has been automated in the form of build.sh, pending a real makefile.

Documentation

Documentation is generated as the system is built with build.sh; a set of markdown files will be placed into doc/, as well as an all-in-one apidoc.md. If pandoc is installed, an apidoc.pdf will also be generated.