themes

packages/bare-os-coreutils/scripts/seed-man-pages.mjs

@@ -451,15 +451,39 @@ EXTRA.awk = {
   ],
   bareOsNotes: 'See handbook ch.9 for divergence from Issue 7.'
 }
-EXTRA.ls = {
-  synopsis: ['ls [-1al] [FILE...]'],
+EXTRA.dircolors = {
+  synopsis: ['dircolors [-b] [FILE]', 'dircolors -p'],
   description:
-    'Lists directory contents. Long format shows mode, links, owner, group, size, mtime, and symlink targets.',
+    'Print LS_COLORS from a dircolors database (GNU subset: TERM blocks, key/value pairs). -p prints the default Bare OS database.',
+  options: [
+    { flag: '-b, --sh', meaning: 'Bourne-shell export LS_COLORS' },
+    { flag: '-p, --print-database', meaning: 'Print default database' }
+  ],
+  keywords: ['dircolors', 'LS_COLORS', 'color'],
+  bareOsNotes: 'FILE read via VFS.'
+}
+EXTRA.theme = {
+  synopsis: ['theme [list|current|set <name>|apply]'],
+  description:
+    'Switch Bare OS UI preset: updates ~/.barerc theme line, sets BARE_OS_THEME, calls bareOsApplyTheme when available.',
+  keywords: ['theme', 'colors', 'prompt'],
+  bareOsNotes: 'list/current work without booter hooks; set/apply need ctx.bareOsApplyTheme.'
+}
+EXTRA.ls = {
+  synopsis: ['ls [-1al] [--color[=never|auto|always]] [FILE...]'],
+  description:
+    'Lists directory contents. Long format shows mode, links, owner, group, size, mtime, and symlink targets. With color (default auto on a TTY), directories, symlinks, executables, and permission bits are highlighted.',
   options: [
     { flag: '-a', meaning: 'Include names starting with .' },
     { flag: '-l', meaning: 'Long listing' },
-    { flag: '-1', meaning: 'One name per line (short format)' }
+    { flag: '-1', meaning: 'One name per line (short format)' },
+    {
+      flag: '--color[=never|auto|always]',
+      meaning:
+        'ANSI colors: never, auto (TTY only), or always; plain --color is auto'
+    }
   ],
+  environment: ['NO_COLOR — disable color even when a TTY or --color=always'],
   keywords: ['ls', 'list', 'directory', 'dir'],
   bareOsNotes: 'Hides .bareos_empty marker like other tools.'
 }