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.
Izaya 2707ecc155 added significantly larger file support to libmtar, as well as versioning support 3 weeks ago
cfg cleaner default source list 1 year ago
lib added significantly larger file support to libmtar, as well as versioning support 3 weeks ago
module added some more keyboard shortcuts to io.read linemode 10 months ago
service modify the two services people actually use to work with the new service semantics 11 months ago
.editorconfig clipboard: Make the clipboard service work under the new service sys 1 year ago
.gitignore clipboard: Make the clipboard service work under the new service sys 1 year ago
LICENSE Initial commit 2 years ago
README.md updated the README to represent the current state of the system 1 year ago
build.lua added the preproc library, meaning PsychOS is nominally self-hosting 1 year ago
build.sh bumped the version number because we selfhosting now 1 year ago
docs-metadata.yml added a title for PDF generation 1 year ago
finddesc.lua Fix document generation on Windows (using Git Bash) 1 year ago
gendoc.lua added doc() support for pre-compiled API documentation, wrote a generator for it, and included that in the build script 1 year ago
luapreproc.lua added type annotations and descriptions for functions where appropriate 1 year ago
package.sh added minitel to the default init, updated the package script 1 year ago
preproc.lua move actual preproc lib into folder rather than symlinking to the version in lib/, a better solution will be considered later 1 year ago
template.tex updated finddesc to use the new doc library, allowing type annotations and building a directory of documentation 1 year 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.