grepc: Improve regexes

- Use the same ammount of spaces for the closing brace as for the
  opening brace.
- Fix position of attributes.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: bugfix

SC2068: Double quote array expansions to avoid re-splitting elements.

Reported-by: shellcheck(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: srcfix

SC2124: Use $* instead of $@ to concatenate.

Reported-by: shellcheck(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: srcfix

SC2004: $/${} is unnecessary on arithmetic variables.

Reported-by: shellcheck(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: Add -i flag as in grep(1)

Also, add some symmetry between ${iflag} and ${lflag}.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: Remove -tu from the defaults

Normally, one either wants to see a declaration/definition, or its
uses, but not both at the same time.  Also, there are usually many
more use sites than than definitions, and therefore definitions
are shadowed between all the noise.  Restrict the default to
declarations and definitions, which in my experience seems to be
the most common use case.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: -tu: Allow searching special characters

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Fix grepc_type_typedef_underlying_struct_union_enum

When it calls grepc_type_struct_union_enum(), it needs to use a
different file list, since it's searching for an identifier
different from the one passed in the command line.

Also, while at it, improve the quoting of the pattern passed to
pcregrep(1).

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: -tt: Find typedefs to function pointers

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: tfix

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: srcfix

Sort alphabetically the optstring.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Allow a pattern to start with '-'

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: -t...: Allow more granularity

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc.1: wfix

grepc, grepc.1: wfix

Rename functions to have different starting letters.  Also rename
the macro functions to more closely match ISO C nomenclature.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: -tu: Search also within enum and type definitions

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_enum_constant: Fix edge cases

Most importantly, typedef enum.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: Add -l flag as in grep(1)

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_use_macro: tfix

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc.1: ffix

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: Add -tu to search for uses

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_macro_*: Remove a few false positives

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: srcfix

Use alphabetic order.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: Add -k option for a more compact output

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: Add -t option to restrict the search to a type of code.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: srcfix

Improve grouping so that adding flags for running the different
functions is simple.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: Don't print leading blank lines.

Also, update the manual page EXAMPLES regarding blank lines.

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc.1: SYNOPSIS: ffix

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: Add optional FILE trailing arguments

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: -g: Add option to restrict search to files tracked by git

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: -x: Add option to edit file extension

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc, grepc.1: -h: Add option to print the usage message.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Usage: ffix

Using caps instead of <> will be nicer when we add options and
optional arguments for the files/directories:

  Usage: grepc [OPTION]... IDENTIFIER [FILE]...

vs

  Usage: grepc [<option>]... IDENTIFIER [<file>]...

Also, it's what pcregrep(1) and GNU grep(1) use, so it's good to
use the same syntax here.

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc.1: wfix

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Simplify escaping \

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Use -r option to read(1)

Let's fall on the safe side.

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Make it portable to sh(1)

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Use a portable shebang

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Remove spurious blank lines

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Remove blank line between header and code

Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_linux_syscall_def: Improve readability of regex

This improves the readability of the regex, and also the
robustness, at the cost of just a few ms.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_find_files: Get a reduced list of files once

Instead of running find and grep -l for every function, store the
result in a temporary file for reuse in all functions.

This is a considerable speedup, between 3x and 10x in some tests
within the Linux kernel source code.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Fix some corner cases

Those two spaces are for handling some insane GNU style.  Those
are always spaces, so let's use '  ' instead of '\s\s' to make
sure we don't match two tabs, or things like that.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc.1: ffix

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc.1: Add break points in URI

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc.1: EXAMPLES: Add example with nxt_sprintf

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc.1: Add manual page

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Use '' when possible

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Fix some corner cases

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_type_*: Fix some typedef corner cases

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_macro_simple: Fix regex for empty macro

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Optimize

Use 2 grep(1) filters instead of 1, to be able to filter better
before the multiline pcregrep(1) filter, which is considerably
slower.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_enum_constant, grepc_type_typedef_simple: Remove a few false positives

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_linux*, grepc_syscall*: Rename functions to clearly refer to linux

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_type_struct_union_enum: Don't duplicate output

In definitions of the form

typedef struct foo {...} foo;

grepc_type_typedef_struct_union_enum() is already finding it.
Remove the duplicate here.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_glibc_math: Support glibc math functions

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_helper: Add helper function to remove repeated code

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_func_decl: Optimize

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_enum_constant: Fix pattern

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_type_struct_union_enum: Optimize

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_type_struct_union_enum: Allow attributes before struct|union|enum keyword

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_type_typedef_underlying_struct_union_enum: Don't duplicate output

In typedefs of the form 'typedef struct foo foo;', don't print the
structure twice.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Allow tabs

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_type*: Simplify finding typedefs

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Consistently use Perl regex

If we use different regex types within the program, then users
can't use regex patterns in the identifier due to
incompatibilities.  Let's use Perl regex everywhere we can, so
that users can consistently use Perl regex patterns in the
identifier.  Example:

$ grepc (vf|as)printf;

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_enum_constant: Find enumeration constant definitions

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_syscall_decl: Optimize

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grep_macro_*: Allow tabs

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_func_def: Find kernel function definitions

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_syscall: Find kernel syscalls (both declaration and definition)

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_func_def: Increase robustness of regex

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_type_struct_union_enum: Increase robustness of regex

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_type_typedef_underlying_struct_union_enum: Fix corner cases

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: Fix parsing of arguments

Allow one single argument only.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grepc_type_struct_union_enum: Support glibc

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

grepc: grep_func_decl: Support glibc

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

bin/grepc: Add program

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

SPONSORS: Two sponsors didn't renew this year

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Start of man-pages-NEXT: Move Changes to Changes.old

Signed-off-by: Alejandro Colomar <alx@kernel.org>

lsm: Released 6.16

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes: Ready for 6.16

Signed-off-by: Alejandro Colomar <alx@kernel.org>

RELEASE: Sort tags using sort(1) -V

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes[.old]: Move Changes to Changes.old

I forgot to do it right after releasing man-pages-6.15.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/bpf-helpers.7: Refresh page from Linux v6.17

Scripted change:

$ ~/src/linux/linux/v6.17/scripts/bpf_doc.py \
| rst2man \
>man7/bpf-helpers.7;

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: Update some APIs for POSIX.1-2024

This work is incomplete, but waiting until all pages have been updated
would unnecessarily delay publishing these changes, which are already
useful.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/ftime.3: SYNOPSIS: Declare ftime with [[deprecated]]

This function was marked as legacy in POSIX.1-2001 and has been removed
from many systems, including glibc.

Signed-off-by: Collin Funk <collin.funk1@gmail.com>
Message-ID: <5924c3b09d8e373be6ac1b5ca663b8ad7d106d93.1750306917.git.collin.funk1@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/gettimeofday.2: Declare functions with [[deprecated]]

As documented in the STANDARDS section, gettimeofday(2) was deprecated
in POSIX.1-2008 and removed in POSIX.1-2024.  Mark it and
settimeofday(2) with [[deprecated]], and mention clock_settime(2) as a
modern and standardized alternative to settimeofday(2).

Signed-off-by: Collin Funk <collin.funk1@gmail.com>
Message-ID: <2d37d5a9251af3c1d25cf8e73e3585a9955d5772.1750373011.git.collin.funk1@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/ptsname.3: VERSIONS: Document ptsname_r(3) incompatibility on FreeBSD

The FreeBSD implementation of ptsname_r(2) returns -1 on error and sets
errno, instead of just returning the errno.  Document this issue for
programs written with portability in mind.

Signed-off-by: Collin Funk <collin.funk1@gmail.com>
Message-ID: <37f138bc5c5e6604f0a0afcc531694387d2cc424.1749792527.git.collin.funk1@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3*/: STANDARDS: Update APIs for POSIX.1-2024

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3type/time_t.3type: STANDARDS, HISTORY: POSIX.1-2008 removed useconds_t

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3type/time_t.3type: STANDARDS, HISTORY: Update time_t for POSIX.1-2024

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/getenv.3: Mention secure_getenv() was standardized in POSIX-1.2024

Signed-off-by: Collin Funk <collin.funk1@gmail.com>
Message-ID: <2d55b75480ae862a622ac46e7e6c7628f6efc45d.1747519811.git.collin.funk1@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/signal.7: Mention SIGWINCH was standardized in POSIX-1.2024

Signed-off-by: Collin Funk <collin.funk1@gmail.com>
Message-ID: <bae6bc16f9ab6bd3e5c30dc8e11bd83566b06a6f.1747519811.git.collin.funk1@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/ptsname.3: Mention ptsname_r() was standardized in POSIX-1.2024

Signed-off-by: Collin Funk <collin.funk1@gmail.com>
Message-ID: <883d4a9b8cfb757a080710cf0133be5d0e12adce.1747515178.git.collin.funk1@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/: STANDARDS: Update system calls for POSIX.1-2024

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/open.2: Simplify STANDARDS, and move part of it to HISTORY

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: Update fork(2) for POSIX.1-2024, and add references to _Fork(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/_Fork.3: Document _Fork()

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/pathname.7: VERSIONS: Linux doesn't disallow new-line characters

POSIX.1-2024 encourages implementations to disallow new-line characters,
but Linux doesn't follow that.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/close.2: CAVEATS: Document divergence from POSIX.1-2024

POSIX.1-2024 now mandates a behavior different from what Linux (and many
other implementations) does.  It requires that we report EINPROGRESS for
what now is EINTR.

There are no plans to conform to POSIX.1-2024 within the Linux kernel,
so document this divergence.  Keep POSIX.1-2008 as the standard to
which we conform in STANDARDS.

Link: <https://sourceware.org/bugzilla/show_bug.cgi?id=14627>
Link: <https://pubs.opengroup.org/onlinepubs/9799919799/functions/close.html>
Cc: Jan Kara <jack@suse.cz>
Cc: Alexander Viro <viro@zeniv.linux.org.uk>
Cc: Christian Brauner <brauner@kernel.org>
Cc: Rich Felker <dalias@libc.org>
Cc: <linux-fsdevel@vger.kernel.org>
Cc: <linux-api@vger.kernel.org>
Cc: <libc-alpha@sourceware.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>