| 1 | Published Docs
|
| 2 | ==============
|
| 3 |
|
| 4 | This page links to docs that are ready to read.
|
| 5 |
|
| 6 | See [All Docs](index.html) for links to drafts.
|
| 7 |
|
| 8 | ## Good Places to Start
|
| 9 |
|
| 10 | - [Getting Started](getting-started.html)
|
| 11 | - [YSH Editor Support]($wiki) on the wiki.
|
| 12 | - [A Tour of YSH](ysh-tour.html)
|
| 13 | - [YSH vs. Shell Idioms](idioms.html)
|
| 14 | - [**Oils Reference**](ref/index.html) - underlies the [help][] builtin
|
| 15 | - [FAQ on Docs](faq-doc.html). **Look here if you can't find
|
| 16 | something**.
|
| 17 |
|
| 18 | Build/packaging:
|
| 19 |
|
| 20 | - [INSTALL](INSTALL.html). How do I install Oils? This text file is also in
|
| 21 | the `oils-for-unix` tarball.
|
| 22 | - [Oils Build `--help` Mirror](help-mirror.html)
|
| 23 | - [Portability](portability.html)
|
| 24 |
|
| 25 | [help]: ref/chap-builtin-cmd.html#help
|
| 26 |
|
| 27 | ## More
|
| 28 |
|
| 29 | OSH:
|
| 30 |
|
| 31 | - [Known Differences Between OSH and Other Shells](known-differences.html) |
|
| 32 | [Quirks](quirks.html) | [Headless Mode](headless.html) | [Shell
|
| 33 | Idioms](shell-idioms.html)
|
| 34 |
|
| 35 | YSH:
|
| 36 |
|
| 37 | - [A Feel For YSH Syntax](syntax-feelings.html) | [YSH Style
|
| 38 | Guide](style-guide.html) | [What Breaks When You Upgrade to
|
| 39 | YSH](upgrade-breakage.html) | [YSH Language FAQ](ysh-faq.html)
|
| 40 |
|
| 41 | - Comparisons: [YSH vs. Shell](ysh-vs-shell.html) | [YSH Expressions vs.
|
| 42 | Python](ysh-vs-python.html)
|
| 43 |
|
| 44 | - Features: [Egg Expressions (YSH Regexes)](eggex.html)
|
| 45 | | [YSH Regex API](ysh-regex-api.html)
|
| 46 | | [Guide to YSH Error Handling](ysh-error.html)
|
| 47 | | [Guide to Procs and Funcs](proc-func.html)
|
| 48 | | [YSH Fixes Shell's Error Handling](error-handling.html)
|
| 49 | | [Simple Word Evaluation](simple-word-eval.html)
|
| 50 | | [Variable Declaration, Mutation, and Scope](variables.html)
|
| 51 | | [Hay - Custom Languages for Unix Systems](hay.html)
|
| 52 | | [YSH Input/Output](ysh-io.html)
|
| 53 | | [Unicode in Oils](unicode.html)
|
| 54 |
|
| 55 | Data Languages:
|
| 56 |
|
| 57 | - [JSON](json.html) | [J8 Notation](j8-notation.html) | [BYO
|
| 58 | Protocols](byo.html)
|
| 59 |
|
| 60 | Language Design:
|
| 61 |
|
| 62 | - [Syntactic Concepts](syntactic-concepts.html)
|
| 63 | | [Command vs. Expression Mode](command-vs-expression-mode.html)
|
| 64 | | [Language Influences](language-influences.html)
|
| 65 | - Notes: [Novelties in OSH and YSH](novelties.html) | [Warts](warts.html)
|
| 66 |
|
| 67 | The Shared Oils Runtime
|
| 68 |
|
| 69 | - [Types in the Oils Runtime](types.html) | [Tracing Execution](xtrace.html)
|
| 70 |
|
| 71 | Reference:
|
| 72 |
|
| 73 | - [Oils Error Catalog, With Hints](error-catalog.html)
|
| 74 |
|
| 75 | For contributors:
|
| 76 |
|
| 77 | - [README.md](oils-repo/README.html). If you want to modify Oils, start here.
|
| 78 | We welcome contributions!
|
| 79 | - [Oils Repo Overview](repo-overview.html)
|
| 80 | - [mycpp/README](oils-repo/mycpp/README.html) - How we translate typed Python to
|
| 81 | C++.
|
| 82 | - [ul-table: Markdown Tables Without New Syntax](ul-table.html)
|