{
  "name": "touch",
  "section": 1,
  "title": "change file timestamps or create files",
  "synopsis": ["touch [OPTION]... FILE..."],
  "description": "Creates missing files (empty) or updates timestamps via **`vfs.writeFile`** with explicit **`mtimeMs`** / **`ctimeMs`** in metadata. Bare has no separate atime; **`-a`** updates **ctime** only and leaves **mtime** unchanged unless a time is given; **`-m`** updates **mtime** only and leaves **ctime** unchanged unless a time is given. Default (neither **`-a`** nor **`-m`**) updates both to the chosen time or now.",
  "options": [
    { "flag": "-a", "meaning": "Change access time only (approximated: **ctime** only; **mtime** unchanged)." },
    { "flag": "-m", "meaning": "Change modification time only (**mtime**; **ctime** unchanged unless a time is given)." },
    { "flag": "-d, --date", "meaning": "Use parsed time (**`Date.parse`**; **`@seconds`** for Unix seconds)." },
    { "flag": "-r, --reference", "meaning": "Use **mtime** of **FILE** (last **`-d`** / **`-r`** wins)." }
  ],
  "keywords": ["touch", "bare-os", "coreutils"],
  "examples": [
    { "caption": "create empty", "code": "touch newfile" },
    { "caption": "set time", "code": "touch -d '@315532800' old.txt" },
    { "caption": "match another file", "code": "touch -r template.txt copy.txt" }
  ]
}