mu - Soul of a tiny new machine. More thorough tests → More comprehensible and rewrite-friendly software → More resilient society.

	Commit message (Collapse)	Author	Age	Files	Lines
*	5650 - support a second OS: soso	Kartik Agaram	2019-09-14	1	-0/+133
	https://github.com/ozkl/soso + Much smaller than Linux; builds instantly + Supports graphics - No network support - Doesn't work on a cloud server (yet?)

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>~/Desktop/s/mu/000organization.cc.html</title> <meta name="Generator" content="Vim/7.4"> <meta name="plugin-version" content="vim7.4_v1"> <meta name="syntax" content="cpp"> <meta name="settings" content="use_css,pre_wrap,no_foldcolumn,expand_tabs,prevent_copy="> <meta name="colorscheme" content="minimal"> <style type="text/css">  </style> <script type='text/javascript'>  </script> </head> <body> <pre id='vimCodeElement'> //: You guessed right: the '000' prefix means you should start reading here. //: //: This project is setup to load all files with a numeric prefix. Just create //: a new file and start hacking. //: //: The first few files (00*) are independent of what this program does, an //: experimental skeleton that will hopefully make it both easier for others to //: understand and more malleable, easier to rewrite and remould into radically //: different shapes without breaking in subtle corner cases. The premise is //: that understandability and rewrite-friendliness are related in a virtuous //: cycle. Doing one well makes it easier to do the other. //: //: Lower down, this file contains a legal, bare-bones C++ program. It doesn't //: do anything yet; subsequent files will contain :(...) directives to insert //: lines into it. For example: //: :(after "more events") //: This directive means: insert the following lines after a line in the //: program containing the words "more events". //: //: A simple tool is included to 'tangle' all the files together in sequence //: according to their directives into a single source file containing all the //: code for the project, and then feed the source file to the compiler. //: (It'll drop these comments starting with a '//:' prefix that only make //: sense before tangling.) //: //: Directives free up the programmer to order code for others to read rather //: than as forced by the computer or compiler. Each individual feature can be //: organized in a self-contained 'layer' that adds code to many different data //: structures and functions all over the program. The right decomposition into //: layers will let each layer make sense in isolation. //: //: "If I look at any small part of it, I can see what is going on -- I don't //: need to refer to other parts to understand what something is doing. //: //: If I look at any large part in overview, I can see what is going on -- I //: don't need to know all the details to get it. //: //: Every level of detail is as locally coherent and as well thought-out as //: any other level." //: //: -- Richard Gabriel, "The Quality Without A Name" //: (<a href="http://dreamsongs.com/Files/PatternsOfSoftware.pdf">http://dreamsongs.com/Files/PatternsOfSoftware.pdf</a>, page 42) //: //: Directives are powerful; they permit inserting or modifying any point in //: the program. Using them tastefully requires mapping out specific lines as //: waypoints for future layers to hook into. Often such waypoints will be in //: comments, capitalized to hint that other layers rely on their presence. //: //: A single waypoint might have many different code fragments hooking into //: it from all over the codebase. Use 'before' directives to insert //: code at a location in order, top to bottom, and 'after' directives to //: insert code in reverse order. By convention waypoints intended for insertion //: before begin with 'End'. Notice below how the layers line up above the "End //: Foo" waypoint. //: //: File 001 File 002 File 003 //: ============ =================== =================== //: // Foo //: ------------ //: <---- :(before "End Foo") //: .... //: ... //: ------------ //: <---------------------------- :(before "End Foo") //: .... //: ... //: // End Foo //: ============ //: //: Here's part of a layer in color: <a href="http://i.imgur.com/0eONnyX.png">http://i.imgur.com/0eONnyX.png</a>. Directives //: are shaded dark. //: //: Layers do more than just shuffle code around. Their guarantee is that it //: should be possible to stop loading after any file/layer, build and run the //: program, and pass all tests for loaded features. (Relevant is //: <a href="http://youtube.com/watch?v=c8N72t7aScY">http://youtube.com/watch?v=c8N72t7aScY</a>, a scene from "2001: A Space //: Odyssey".) Use the included script called 'test_all_layers' to check the //: guarantee if you make any changes. //: //: This 'subsetting guarantee' ensures that this directory contains a //: cleaned-up narrative of the evolution of this codebase. Organizing //: autobiographically allows a newcomer to rapidly orient himself, reading the //: first few files to understand a simple gestalt of a program's core purpose //: and features, and later gradually working his way through other features as //: the need arises. //: //: Programmers shouldn't need to understand everything about a program to hack //: on it. But they shouldn't be prevented from a thorough understanding of //: each aspect either. The goal of layers is to reward curiosity. // Includes // End Includes // Types // End Types // prototypes are auto-generated; define your functions in any order #include "function_list" // by convention, files ending with '_list' are auto-generated // Globals // End Globals int main(int argc, char* argv[]) { // End One-time Setup // End Commandline Parsing return 0; // End Main } void setup() { // End Setup } void teardown() { // End Teardown } //: Without directives or with the :(code) directive, lines get added at the //: end. </pre> </body> </html>