{
  "name": "head",
  "section": 1,
  "title": "copy the first part of files",
  "synopsis": ["head [OPTION]... [OPERAND]..."],
  "description": "Prints the first part of each file. Supports -n for line count and -c for a byte count (UTF-8 byte-oriented).",
  "options": [
    { "flag": "-n, --lines=NUM", "meaning": "Print the first NUM lines (default 10)" },
    { "flag": "-c, --bytes=NUM", "meaning": "Print the first NUM bytes" },
    { "flag": "-NUM", "meaning": "Shorthand for -n NUM (e.g. head -5 file)" }
  ],
  "keywords": ["head", "bare-os", "coreutils"],
  "seeAlso": [{ "name": "tail", "section": 1 }],
  "examples": [
    {
      "caption": "first 10 lines",
      "code": "head /etc/os-release"
    },
    {
      "caption": "first N lines",
      "code": "head -n 50 big.log"
    },
    {
      "caption": "first bytes",
      "code": "head -c 80 data.bin"
    },
    {
      "caption": "stdin",
      "code": "cat long.txt | head"
    }
  ],
  "listCategory": "coreutils"
}