From 26084b910a37efac43faeca703456178efd81934 Mon Sep 17 00:00:00 2001 From: Dominic Reich Date: Sun, 28 Apr 2024 11:30:28 +0200 Subject: [PATCH] adds manpage descriptions to archlinux and openbsd notes pages --- content/notes/archlinux/index.md | 14 +++++++++++++- content/notes/openbsd/index.md | 17 ++++++++++++++++- 2 files changed, 29 insertions(+), 2 deletions(-) diff --git a/content/notes/archlinux/index.md b/content/notes/archlinux/index.md index d9cb688..9852d6b 100644 --- a/content/notes/archlinux/index.md +++ b/content/notes/archlinux/index.md @@ -1,7 +1,7 @@ --- title: Archlinux date: 2023-11-29T20:33:48+0100 -lastmod: 2024-04-28T09:15:17+0000 +lastmod: 2024-04-28T09:30:28+0000 tags: - archlinux @@ -187,3 +187,15 @@ Possible settings are: More details can be found in {{< man loader.conf 5 >}}. +### Manual sections + +| Section | Description | +| :--- | :--- | +| 1 | Section 1 of the manual describes **user commands** and tools, for example, file manipulation tools, shells, compilers, web browsers, file and image viewers and editors, and so on | +| 2 | Section 2 of the manual describes the Linux **system calls**. A system call is an entry point into the Linux kernel. Usually, system calls are not invoked directly: instead, most system calls have corresponding C library wrapper functions which perform the steps required (e.g., trapping to kernel mode) in order to invoke the system call. Thus, making a system call looks the same as invoking a normal library function. | +| 3 | Section 3 of the manual describes all **library functions** excluding the library functions (system call wrappers) described in Section 2, which implement system calls. | +| 4 | Section 4 of the manual describes **special files (devices)**. | +| 5 | Section 5 of the manual describes various **file formats**, as well as the **corresponding C structures**, if any. | +| 6 | Section 6 of the manual describes the **games** and funny little programs available on the system. | +| 7 | Section 7 of the manual provides **overviews on various topics**, and describes conventions and protocols, character set standards, the standard filesystem layout, and miscellaneous other things. | + diff --git a/content/notes/openbsd/index.md b/content/notes/openbsd/index.md index d1e91a3..d2f0836 100644 --- a/content/notes/openbsd/index.md +++ b/content/notes/openbsd/index.md @@ -1,7 +1,7 @@ --- title: OpenBSD date: 2023-11-29T20:33:48+0100 -lastmod: 2024-04-25T18:57:43+0000 +lastmod: 2024-04-28T09:30:28+0000 tags: - openbsd - python @@ -427,3 +427,18 @@ $ sox *.wav one-big-soundfile.wav audio files into separate streams at the output file whereas `sox` appends one file after another in the big output file. +## Manual page sections + +| Section | Description | +| :--- | :--- | +| 1 | General Commands | +| 2 | System Calls | +| 3 | Library Functions | +| 3p | Perl Library | +| 4 | Device Drivers | +| 5 | File Formats | +| 6 | Games | +| 7 | Miscallaneous Information | +| 8 | System Manager's Manual | +| 9 | Kernel Developer's Manual | +