summaryrefslogtreecommitdiffstats
Commit message (Collapse)AuthorAgeLines
* lib/pkg/debian/...: Add debian packagingdebianAlejandro Colomar2022-08-01-0/+116
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* Makefile: Disable builtin rules and variablesAlejandro Colomar2022-08-01-0/+2
| | | | | | | We don't use them at all, so by disabling them, the debug output of make(1) will be smaller. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* append_COLOPHON.sh, remove_COLOPHON.sh: Remove the COLOPHONAlejandro Colomar2022-08-01-66/+0
| | | | | | | | | | | | Distributions already provide that information (and they are even more precise). In Debian, for example, one should use dpkg(1) to read the version information about a package or to know which package provides an installed file. apt-cache(8) gives information about the upstream project, and how to report bugs. reportbug(1) is used to report a bug. Reported-by: Ingo Schwarze <schwarze@openbsd.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* Makefile, src.mk, *.mk: Move some definitions to a helper MakefileAlejandro Colomar2022-08-01-11/+33
| | | | | | | To be able to explicitly include the file with the definitions, wherever it is needed. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* Makefile, cmd.mk, *.mk: Allow using different names for basic commandsAlejandro Colomar2022-08-01-28/+68
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* dist.mk: Create tarballs with a top-level directoryAlejandro Colomar2022-08-01-1/+2
| | | | | | | Need to use a trick with sed(1) to avoid tar(1) modifying the symlinks. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* README: man0 is not used anymoreAlejandro Colomar2022-08-01-1/+1
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* sa_family_t.3type, sockaddr.3type: Document sa_family_tAlejandro Colomar2022-07-30-0/+12
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* sockaddr.3type, timer_t.3type, void.3type: wfixAlejandro Colomar2022-07-30-11/+6
| | | | | | | | | | | | | | | | | Replace "shall" wordings by simpler text, to not resemble a standards document. When saying something like "According to POSIX/ISO C, ...", if the mentioned standard is the same one described in STANDARDS, remove that text (it is redundant). However, if ISO C is the main standard that describes a type, but POSIX applies further restrictions, keep that text. Remove pedantic notes that may only be interesting to compiler writers. Reported-by: Ingo Schwarze <schwarze@openbsd.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* ptrdiff_t.3type, size_t.3type, time_t.3type, va_list.3type, void.3type: ffixAlejandro Colomar2022-07-30-8/+6
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* Various pages: wfixAlejandro Colomar2022-07-29-71/+28
| | | | | | | | | | | | | | | | | Replace "shall" wordings by simpler text, to not resemble a standards document. When saying something like "According to POSIX/ISO C, ...", if the mentioned standard is the same one described in STANDARDS, remove that text (it is redundant). However, if ISO C is the main standard that describes a type, but POSIX applies further restrictions, keep that text. Remove pedantic notes that may only be interesting to compiler writers. Reported-by: Ingo Schwarze <schwarze@openbsd.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* sysexits.h.3head: Add LIBRARY sectionAlejandro Colomar2022-07-29-0/+3
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* Makefile, install-man.mk: Support man3head, and remove support for man0Alejandro Colomar2022-07-29-9/+9
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* sysexits.h.3head: Move header page to a new man3head sectionAlejandro Colomar2022-07-29-17/+79
| | | | | | | | | | | | | | | Use man3head, as other Unix systems already use. As Ingo said, man0 is not the right place for header files. Also, this patch does some changes to the page itself: Expand the SYNOPSIS to have together all of the values. Also, add a small comment about the constant (taken from the header file). Link: <https://lore.kernel.org/linux-man/11110a04-f96b-0d32-53e3-adcce618c543@gmail.com/> Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com> Cc: Ingo Schwarze <schwarze@openbsd.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* getrlimit.2: RLIMIT_NPROC also ignored for ruid 0Robert Schneider2022-07-29-1/+2
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* Many pages: Use STANDARDS instead of CONFORMING TOAlejandro Colomar2022-07-29-903/+903
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | STANDARDS seems to be much more extended than CONFORMING TO. For consistency across the whole manual pages corpus, let's try to unify, by following the most commonly used section name. On 7/27/22 12:49, Ingo Schwarze wrote: > Alejandro Colomar wrote on Tue, Jul 26, 2022 at 02:02:56PM +0200: > > We use CONFORMING TO in Linux. Don't know why; just history, I guess. > > See man-pages(7). > > Weird. > > I failed to find a single instance of "CONFORMING TO" in AT&T UNIX > (including v6, PWB, v7, 32v, v8, v10, System III, SVR1, SVR2) nor in > any version of UCB CSRG BSD. So considering that System V and BSD are > widely considered the two main original branches of the development > of Unix-like operating systems and Linux is often considered to have > drawn inspiration from both, the section name "CONFORMING TO" does > not appear to be a UNIX thing. For example, Aeleen Frisch, "Essential > System Administration", O'Reilly, Cambridge 1995, considers Linux > as slightly more influenced by 4.3BSD than by System V Release 3. > > STANDARDS, on the other hand, is present since 4.3BSD-Reno (June 1990). > > 4.3BSD-Reno predates the first version of the Linux kernel by more than > a year, and the first Linux manual pages probably for longer than that. > > So i have no idea where "CONFORMING TO" may have come from. Scripted change: $ find man* -type f | xargs sed -i 's/CONFORMING TO/STANDARDS/' plus a few manual fixes to the following files: - man2/getrlimit.2 - man3/syslog.3 - scripts/bash_aliases Reported-by: Ingo Schwarze <schwarze@openbsd.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* getsid.2: deduplicate getsid(0) caseнаб2022-07-29-2/+0
| | | | | | | | | | | | The first sentence in getsid(0) returns the session ID of the calling process. getsid() returns the session ID of the process with process ID pid. If pid is 0, getsid() returns the session ID of the calling process. blames to beginning of git, duplicates the third one, and doesn't stylistically match current formatting Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* man-pages.7: Document CAVEATS sectionAlejandro Colomar2022-07-26-0/+5
| | | | | | | | | | | | | | | | CAVEATS is an interesting section. There's a slight difference between CAVEATS and BUGS. We usually have a hard time fitting what would go into CAVEATS into other sections (usually BUGS and NOTES); it would be easier if we had the section. Let's add it. This section has been used in manual pages by authors from a wide range of projects including AT&T, Korn shell, Perl, GNU and BSD since the early 1980s. Using the section was first officially recommended in 2002 by the file </usr/share/misc/mdoc.template> in NetBSD and OpenBSD. Reported-by: Ingo Schwarze <schwarze@usta.de> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* strsignal.3: fix str(d)abbrev typoнаб2022-07-26-2/+2
| | | | | Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* man-pages.7: The linker flag is not always necessaryAlejandro Colomar2022-07-22-2/+2
| | | | | | See for example pages for types Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* man-pages.7: Document LIBRARY sectionAlejandro Colomar2022-07-22-0/+9
| | | | | Reported-by: "Theodore Ts'o" <tytso@mit.edu> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* size_t.3type: tfixAlejandro Colomar2022-07-22-1/+1
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* regex_t.3type, regmatch_t.3type, regoff_t.3type, system_data_types.7: Move ↵Alejandro Colomar2022-07-22-82/+64
| | | | | | regex_t, regmatch_t, and regoff_t to a separate page Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* stat.3type, system_data_types.7: Move stat to a separate pageAlejandro Colomar2022-07-22-141/+160
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* bash_aliases: man_gitstaged(): Never show dirsAlejandro Colomar2022-07-22-3/+3
| | | | | | | Directories are obvious also for scripts, or other non-man(7) files. Also, this adds support for man3type and man2type pages. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* timer_t.3type, system_data_types.7: Move timer_t to a separate pageAlejandro Colomar2022-07-22-23/+34
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* Makefile: Remove unused variablesAlejandro Colomar2022-07-21-13/+2
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* Many pages: Use man3type/ and man2type/ for type pagesAlejandro Colomar2022-07-21-121/+135
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Quoting Ingo: [ The mandoc(1) program is also able to handle paths like "man3/id_t.3type". It will consider that page to be *both* in section "3" (as specified by the directory name) and in section "3type" (as specified by the file name and by the .TH macro). I would consider it better style to keep section names consistent, i.e. to use either "man3/id_t.3" .TH id_t 3 or "man3type/id_t.3type" .TH id_t 3type, but it's not a big deal: since many systems (in particular various Linux distros) suffer from such inconsistencies, handling such inconsistencies gracefully is an important feature that certainly won't get removed. ] Let's be nice, and do things right here, in the hope that others may follow the example. === Most of this patch has been scripted: $ mkdir man2type man3type $ find man2 | grep type$ | while read f; do mv -t man2type $f; done $ find man3 | grep type$ | while read f; do mv -t man3type $f; done $ grep -rl man3/.*type man* | xargs sed -i 's,man3/,man3type/,' Apart from that, I adapted the Makefiles, and moved va_list into the man3type subsection (it was accidentally placed in the main 3 section). Link: <https://lore.kernel.org/linux-man/YrB66rgFZqryrmpt@asta-kit.de/T/#u> Reported-by: Ingo Schwarze <schwarze@usta.de> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* timespec.3type, system_data_types.7: Move timespec to a separate pageAlejandro Colomar2022-07-21-65/+74
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* timeval.3type, system_data_types.7: Move timeval to a separate pageAlejandro Colomar2022-07-21-32/+41
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* va_list.3, system_data_types.7: Move va_list to a separate pageAlejandro Colomar2022-07-21-31/+43
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* MAINTAINER_NOTES: Update references about generation of bpf-helpers.7Alejandro Colomar2022-07-21-2/+1
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* bpf-helpers.7: Refresh pageAlejandro Colomar2022-07-21-44/+1146
| | | | | | | | | | | | | The script for generating this page is hosted in the Linux kernel repository, as <scripts/bpf_doc.py>. Run it as: $ /path/to/linux//scripts/bpf_doc.py | rst2man > man7/bpf-helpers.7 Link: <https://lore.kernel.org/linux-man/CA+FoirA-FeYeA5ZPgCvo55Hg_dfe7dT54Co8CkU9wW8yemFcJA@mail.gmail.com/T/> Cc: Daniel Borkmann <daniel@iogearbox.net> Cc: Quentin Monnet <quentin.monnet@netronome.com> Cc: Rumen Telbizov <rumen.telbizov@menlosecurity.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* void.3, void.3type, system_data_types.7: Move void* to a separate pageAlejandro Colomar2022-07-21-74/+76
| | | | | | Also fix the page to be in man3type, not in man3. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* suseconds_t.3type, time_t.3type, useconds_t.3type, system_data_types.7: Move ↵Alejandro Colomar2022-07-21-98/+115
| | | | | | time_t, suseconds_t, and useconds_t to a separate page Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* ptrdiff_t.3type, size_t.3type, ssize_t.3type: Merge size_t and ssize_t into ↵Alejandro Colomar2022-07-20-93/+90
| | | | | | | | | a single page Since ssize_t is just the signed version of size_t, it makes sense to document them together. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* ptrdiff_t.3type, system_data_types.7: Move ptrdiff_t to a separate pageAlejandro Colomar2022-07-20-40/+50
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* size_t.3type, system_data_types.7: Move size_t to a separate pageAlejandro Colomar2022-07-20-103/+107
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* id_t.3type: wfixAlejandro Colomar2022-07-20-1/+1
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* loff_t.3type, off64_t.3type, off_t.3type, system_data_types.7: Move off_t ↵Alejandro Colomar2022-07-20-88/+93
| | | | | | and off64_t to separate page, and document loff_t Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* strftime.3, strftime_l.3: mention strftime_l() with .so linkнаб2022-07-20-1/+26
| | | | | | | | | | | | | POSIX.1-2008 TC2: > [CX] The strftime_l() function shall be equivalent to the strftime() function, except that the locale data used is from the locale represented by locale. > [CX] The behavior is undefined if the locale argument to strftime_l() is the special locale object LC_GLOBAL_LOCALE or is not a valid locale object handle. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* ctime.3: remove struct tm vestigiaнаб2022-07-20-15/+0
| | | | | | | | struct tm now lives in tm.3type, and we describe both of these fields, in detail and correctly, therein Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* tm.3type: describe tm_zone, tm_gmtoffнаб2022-07-20-0/+51
| | | | | | | | | | | | | | | | | | | FreeBSD timezone(3) is V7 char *timezone(int zone, int dst), our documentation would imply it's impossible to service this type of system portably Indeed, glibc defines them both, and they make more sense for most use-cases than trying to use the globals glibc cited for __USE_MISC, tm_zone invalidation is Debian 2.33-7 POSIX cited for XSI marking is Issue 7 TC2 CSRG CD #2 contains 4.3BSD-Tahoe with both members We currently ship an outdated (and factually misleading) version of this description in ctime.3 Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* tm.3type: srcfixAlejandro Colomar2022-07-19-1/+2
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* tm.3type: widen member alignment to take up to const char *наб2022-07-19-9/+9
| | | | | | | This lets us take const char *tm_zone. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* tm.3type: align rangesнаб2022-07-19-6/+6
| | | | | | | This, to me, makes these much more readable Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* printf.3: Note about thousands grouping and the C localeDr. Jürgen Sauermann2022-07-19-0/+5
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* tm.3type: tm_year is year minus 1900, not sinceнаб2022-07-19-1/+1
| | | | | | | | | | Since only makes sense if the year represented is after 1900: how many years have passed since 1900 in... 1410? Also \fB the constant like elsewhere in the hunk Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* tm.3type: tfixнаб2022-07-19-1/+1
| | | | | Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* bind.2: EXAMPLES: Add cleanup codeAlejandro Colomar2022-07-18-2/+5
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
generated by cgit v1.2.3 (git 2.39.1) at 2024-06-01 13:42:10 +0000