Why Sponsor Oils? | source | all docs for version 0.22.0 | all versions | oilshell.org

This reference has three tables of contents. They link to topics within 15 chapters.

(in progress)

1. Types and Methods
2. Builtin Functions
3. Builtin Commands
4. Front End
5. Command Language
6. OSH Assignment
7. YSH Command Language Keywords
8. Word Language
9. YSH Expression Language
10. Mini Languages
11. Global Shell Options
12. Special Variables
13. Plugins and Hooks

14. JSON / J8 Notation
15. Errors

help command

When you type help in OSH or YSH, it shows a URL to this reference, or text extracted from it.

About

The source files for this reference are in Markdown:

REPO/
  doc/
    release-index.md     # /release/$VERSION/

    index.md             # All Docs on Oils, /release/$VERSION/doc/
    getting-started.md
    ...

    ref/
      index.md           # this page, the Oils Reference
      toc-osh.md         # OSH topics
      toc-ysh.md         # YSH topics
      toc-data.md        # Data language topics

      chap-cmd-lang.md   # chapter on the command language
      chap-front-end.md
      ...

The URLs mirror the source, with minor differences:

/release/$VERSION/
  index.html
  doc/
    index.html
    getting-started.html
    ...

    ref/
      index.html
      toc-osh.html
      toc-ysh.html
      toc-data.html

      chap-cmd-lang.html
      chap-front-end.html
      ...

You can link to topics with internal anchors:

• chap-cmd-lang.html#simple-command
• chap-builtin-cmd.html#compgen

Terminology

This reference has a 3-level structure:

1. Chapter - A big HTML page.
   • A chapter may apply to OSH, YSH, or both.
2. Section - An <h2> heading in a chapter
3. Topic - An <h3> heading in a chapter.
   • It has a globally unique name like doc-comment, which is used in the help builtin.
   • A topic may apply to OSH, YSH, or both.

More terminology:

• Table of Contents - a doc with a dense list of topic links.
• Card - Some topics are exported as help builtin "cards". They can be inline text, or a URL pointer. A card may also link to POSIX or bash docs.