{
  "name": "find",
  "section": 1,
  "title": "find files",
  "synopsis": [
    "find [PATH...] [EXPRESSION]"
  ],
  "description": "Walks directories and applies expressions (-name, -type, -print, -maxdepth, logical -and/-or/-not).",
  "options": [
    { "flag": "-name", "meaning": "[Issue 7 find] Glob pattern on basename." },
    { "flag": "-type", "meaning": "[Issue 7 find] Filter f, d, or l." },
    { "flag": "-maxdepth", "meaning": "[Issue 7 find] Limit walk depth." }
  ],
  "keywords": [
    "find",
    "directory",
    "walk",
    "search"
  ],
  "bareOsNotes": "Expression syntax is a simplified subset.",
  "examples": [
    {
      "caption": "files by name glob",
      "code": "find . -name \"*.js\""
    },
    {
      "caption": "directories only",
      "code": "find . -type d"
    },
    {
      "caption": "max depth",
      "code": "find . -maxdepth 2 -type f"
    },
    {
      "caption": "OR names",
      "code": "find . \\( -name \"*.c\" -o -name \"*.h\" \\)"
    }
  ]
}