April 6, 2026

Paging all drama: section numbers!

Number in man page titles e.g. sleep(3)

Those weird numbers on “man” pages explained, and the comments go wild

TLDR: A dev learned the numbers on Linux help pages (1=commands, 2=kernel calls, 3=libraries) after a code review correction. Comments erupted into manuals-vs-chatbots, with snarky “read the manual,” confessions of forgetting sections, a reminder about section 5 for file formats, and an ABBA Easter egg for comic relief.

A developer confessed they finally learned what the little numbers in commands like sleep(3) and read(2) mean—after a code review clapback: basename isn’t a kernel call, it’s a library call, so it’s (3), not (2). Translation for non-nerds: those numbers are manual sections—1 = programs, 2 = kernel system calls, 3 = library functions. There are even letter suffixes like p for POSIX standards and x for X docs. Cute trivia… until the comments turned it into a gladiator arena.

Snark squad struck first. LtWorf deadpanned, “Read ‘man man’, write an article,” implying this is day-one stuff. Confession camp followed: amelius said they haven’t read manuals since Stack Overflow—and especially since AI chatbots—pitching a talking manual. Memory-challenged folks like kykat admitted they learn the sections, then instantly forget. The hall monitors added a PSA: don’t ignore section 5 for file formats—think “how to write crontab.”

Then came trivia: mjlee dropped the ABBA Easter egg where at 00:30 the tool once printed “Gimme! Gimme! Gimme!” Yes, really. Beneath the memes lies a split: manuals vs. machines. Old-schoolers chant “read the manual,” while AI-first devs want searchable, chatty help. Either way, knowing the numbers means faster answers—and fewer spicy code reviews.

Key Points

  • Manual section numbers categorize man pages: 1 (commands), 2 (system calls), 3 (library calls).
  • A code review highlighted that basename is not a system call; it belongs in section 3 as a libc library function.
  • The “man man” (man(1)) page documents the meaning of section numbers.
  • Letter suffixes can follow section numbers, such as “p” for POSIX pages (e.g., free(3p)).
  • Another suffix example is “x,” used for X-related documentation (e.g., ncurses(3x)).

Hottest takes

“Step 1: Read ‘man man’. Step 2: write an article” — LtWorf
“I haven’t read manpages since LLMs” — amelius
“Looked it up twice, immediately forgot both times” — kykat
Made with <3 by @siedrix and @shesho from CDMX. Powered by Forge&Hive.