Home

Welcome to the oil wiki!

For Users

• How To Test OSH
• Shell Programs That Run Under OSH
• Oil Deployments
• Migration Guide
• Where To Send Feedback

For Developers

• Contributing / Spec Tests
  • Developing Oil With Nix
• Git Tips -- Patterns for using Git on this project.
• Testing the Interactive Shell -- a bunch of manual test cases
• Debugging Completion Scripts -- the useful --debug-file flag!
• Using Zephyr ASDL
• Implementing the Oil Expression Language

Other:

• Project Goals / Carrots

Implementation Details

• Signal Handling in Oil
• OSH Word Evaluation Algorithm

Reference

External Resources -- External Resources on Unix shells, programming language design, and implementation

Protocol Designs

• Coprocess Protocol Proposal
• Shellac Protocol Proposal -- for shell-independent command-line completion.
• TSV2 Proposal
• CSTR Proposal

Other Designs

• Language Design Principles
• Documentation Strategy
• Structured Data in Oil
  • Structured Data Over Pipes

• Interactive Shell -- Ideas about the interactive shell and possibly graphical shell.
  • Shell Autocompletion

Analysis of Unix Shell

• Shell Security Problems
• Shell WTFs
• Unix Tools -- notes on the things that a shell interacts with. The shell "standard library".
• Little Languages

Programming Language Implementation

Parsing Case Studies -- What algorithms and tools do production-quality languages use for parsing?

Bootstrapping Case Studies -- How are languages bootstrapped?

Lossless Syntax Tree Pattern

Language Subsets -- an abstract but practical way of specifying a language

Compact AST Representation

Architecture of Various Interpreters

Programming Language Design

• Language Data Models

• Language Design and Theory of Computation

• Metaprogramming

• Metaprogramming Use Cases

• Partial Evaluation

Programming Patterns

• Feature Detection Is Better than Version Detection
• Language Composition Bestiary
• Exhaustive Test Suite

Blog Themes / Post Ideas

• Oil Blog Planning
• Parsing is Difficult

Old

• OSH Parser (mostly obsolete)
• OSH Optimization Log (already blogged about stuff after this