{
  "name": "ls",
  "section": 1,
  "title": "list directory contents",
  "synopsis": [
    "ls [-1al] [FILE...]"
  ],
  "description": "Lists directory contents. Long format shows mode, links, owner, group, size, mtime, and symlink targets.",
  "options": [
    {
      "flag": "-a",
      "meaning": "Include names starting with ."
    },
    {
      "flag": "-l",
      "meaning": "Long listing"
    },
    {
      "flag": "-1",
      "meaning": "One name per line (short format)"
    }
  ],
  "keywords": [
    "ls",
    "list",
    "directory",
    "dir"
  ],
  "bareOsNotes": "Hides .bareos_empty marker like other tools.",
  "examples": [
    {
      "caption": "long + hidden",
      "code": "ls -la ~"
    },
    {
      "caption": "one per line",
      "code": "ls -1 /bin | head"
    },
    {
      "caption": "multiple paths",
      "code": "ls /bin /etc"
    }
  ]
}