{
  "name": "diff",
  "section": 1,
  "title": "compare two files",
  "synopsis": ["diff [-q] [-s] [-u] FILE1 FILE2"],
  "description": "Compares two text files on the VFS. **`-q`** prints nothing but sets exit status. **`-s`** reports when files are identical. **`-u`** emits a single unified hunk suitable for **`patch(1)`** (Bare OS subset).",
  "options": [
    { "flag": "-q", "meaning": "Quiet; exit status only" },
    { "flag": "-s", "meaning": "Report when files are the same" },
    { "flag": "-u", "meaning": "Unified diff (one hunk)" }
  ],
  "keywords": ["diff", "compare", "bare-os", "coreutils"],
  "bareOsNotes": "Not full POSIX diff; binary files treated as UTF-8 text. See **`/etc/bare-os/posix_utilities.json`**.",
  "examples": [
    { "caption": "unified diff for patching", "code": "diff -u a.txt b.txt" }
  ]
}