you are viewing a single comment's thread
view the rest of the comments
[–] 8 points 8 months ago* (3 children)

that's why any manual worth their salt has a "quick start" section at the beginning (I say this knowing most man pages fail at this or put it at the end which is super unhelpful)

Just give me common uses and flags, you can have your more indepth stuff at the end

  • source
  • parent
  • hideshow 3 child comments
  • [–] 2 points 1 week ago (2 children)

    man man-pages tells writers to only include examples if it is complicated to piece together, otherwise just explain what man page you need to read before, e.g. understanding open(3) before read(3).

  • source
  • parent
  • hideshow 2 child comments