man-pages-6.10 released

man-pages-6.10 released

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 6478 bytes --]

Gidday!

I'm proud to announce:

	man-pages-6.10 - manual pages for GNU/Linux

I'm also very happy to announce that I'm back to maintaining this
project.  My work on this project, this release, and many more to come,
have been possible thanks to our sponsors.  Thank you very much!

	-  Adfinis		<https://adfinis.com/>
	-  Google		<https://opensource.google/>
	-  Hudson River Trading	<https://www.hudsonrivertrading.com/>
	-  Meta			<https://www.meta.com/>
	-  Red Hat		<https://www.redhat.com/>

Tarball download:
<https://www.kernel.org/pub/linux/docs/man-pages/>
Git repository:
<https://git.kernel.org/cgit/docs/man-pages/man-pages.git/>
Online PDF book:
<https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/book/>


Have a lovely day!
Alex


You are receiving this message either because:

        a)  (BCC) You contributed to this release.

        b)  You are subscribed to <linux-man@vger.kernel.org>,
            <linux-kernel@vger.kernel.org>, or
            <libc-alpha@sourceware.org>.

        c)  (BCC) I have information (possibly inaccurate) that you are
            the maintainer of a translation of the manual pages, or are
            the maintainer of the manual pages set in a particular
            distribution, or have expressed interest in helping with
            man-pages maintenance, or have otherwise expressed interest
            in being notified about man-pages releases.
            If you don't want to receive such messages from me, or you
            know of some other translator or maintainer who may want to
            receive such notifications, send me a message.


==================== Changes in man-pages-6.10 ====================

Released: 2024-01-22, Aldaya


New and rewritten pages
-----------------------

man1/
	diffman-git.1
	mansect.1
	pdfman.1
	sortman.1

man2/
	keyctl.2				(split into many pages)
	listmount.2
	statmount.2
	uretprobe.2

man2const/
	KEYCTL_ASSUME_AUTHORITY.2const		(previously, keyctl.2)
	KEYCTL_CHOWN.2cons			(previously, keyctl.2)t
	KEYCTL_CLEAR.2cons			(previously, keyctl.2)t
	KEYCTL_DESCRIBE.2cons			(previously, keyctl.2)t
	KEYCTL_DH_COMPUTE.2cons			(previously, keyctl.2)t
	KEYCTL_GET_KEYRING_ID.2cons		(previously, keyctl.2)t
	KEYCTL_GET_PERSISTENT.2cons		(previously, keyctl.2)t
	KEYCTL_GET_SECURITY.2cons		(previously, keyctl.2)t
	KEYCTL_INSTANTIATE.2cons		(previously, keyctl.2)t
	KEYCTL_INVALIDATE.2cons			(previously, keyctl.2)t
	KEYCTL_JOIN_SESSION_KEYRING.2cons	(previously, keyctl.2)t
	KEYCTL_LINK.2cons			(previously, keyctl.2)t
	KEYCTL_READ.2cons			(previously, keyctl.2)t
	KEYCTL_RESTRICT_KEYRING.2cons		(previously, keyctl.2)t
	KEYCTL_REVOKE.2cons			(previously, keyctl.2)t
	KEYCTL_SEARCH.2cons			(previously, keyctl.2)t
	KEYCTL_SESSION_TO_PARENT.2cons		(previously, keyctl.2)t
	KEYCTL_SETPERM.2cons			(previously, keyctl.2)t
	KEYCTL_SET_REQKEY_KEYRING.2cons		(previously, keyctl.2)t
	KEYCTL_SET_TIMEOUT.2cons		(previously, keyctl.2)t
	KEYCTL_UNLINK.2cons			(previously, keyctl.2)t
	KEYCTL_UPDATE.2cons			(previously, keyctl.2)t
	PR_RISCV_SET_ICACHE_FLUSH_CTX.2const

man3/
	__riscv_flush_icache.3
	timespec_get.3
	wcscasecmp.3				(merged wcsncasecmp.3 with it)
	wcsncasecmp.3				(merged into wcsncasecmp.3)


Newly documented interfaces in existing pages
---------------------------------------------

man2/
	io_submit.2
		RWF_ATOMIC
		RWF_NOAPPEND
	landlock_add_rule.2
		Landlock ABI v4
	landlock_create_ruleset.2
		Landlock ABI v4
	madvise.2
		MADV_GUARD_INSTALL
		MADV_GUARD_REMOVE
	perf_event_open.2
		struct perf_event_attr::inherit && cpus=-1
	posix_fadvise.2
		POSIX_FADV_NOREUSE
	prctl.2
		PR_RISCV_SET_ICACHE_FLUSH_CTX
	process_madvise.2
		All flags permitted for calling process
	readv.2
		RWF_ATOMIC
		RWF_NOAPPEND
	stat.2
		AT_EMPTY_PATH && NULL
	statx.2
		AT_EMPTY_PATH && NULL
		STATX_DIO_READ_ALIGN
		STATX_MNT_ID_UNIQUE
		STATX_SUBVOL
		STATX_WRITE_ATOMIC

man3/
	dlinfo.3
		RTLD_DI_PHDR
	fnmatch.3
		FNM_IGNORECASE

man7/
	landlock.7
		Landlock ABI v4
		Landlock ABI v5
	rtnetlink.7
		struct ifa_cacheinfo


New and changed links
---------------------

man2/
	riscv_flush_icache.2			(__riscv_flush_icache(3))

man2const/
	KEYCTL_INSTANTIATE_IOV.2const		(KEYCTL_INSTANTIATE(2const))
	KEYCTL_NEGATE.2const			(KEYCTL_INSTANTIATE(2const))
	KEYCTL_REJECT.2const			(KEYCTL_INSTANTIATE(2const))

man3/
	timespec_getres.3			(timespec_get(3))
	wcsncasecmp.3				(wcscasecmp(3))


Removed pages
-------------


Removed links
-------------


Global changes
--------------

-  src/bin/
   -  Add a few programs that are useful for maintaining manual pages:
      diffman-git(1), mansect(1), pdfman(1), sortman(1)

-  SPONSORS
   -  Add file listing the sponsors of this project.

-  CONTRIBUTING*
   -  Expand documentation for contributing to the project.  Especially,
      regarding help using git(1).

-  man/
   -  Split keyctl.2
   -  man2/, man3/: SYNOPSIS: Rename function parameters for consistency
      and correctness.
   -  man2/, man3/: SYNOPSIS: Use typeof() to improve readability of
      function pointers.
   -  man1/: SYNOPSIS: Use .SY/.YS for formatting commands.

-  share/mk/
   -  Refactor *FLAGS and LDLIBS variables, as requested by some
      distros.

-  LICENSES/
   -  Add GPL-3.0-or-later.


Changes to individual files
---------------------------

The manual pages and other files in the repository have been improved
beyond what this changelog covers.  To learn more about changes applied
to individual pages, or the authors of changes, use git(1).


==================== Linux Software Map ===========================

Begin4
Title:          Linux man-pages
Version:        6.10
Entered-date:   2025-01-22
Description:    Manual pages for GNU/Linux.  This package contains
                manual pages for sections 2, 3, 4, 5, and 7, and
                subsections of those.  Only a few pages are provided in
                sections 1, 6, and 8, and none in 9.
Keywords:       man pages
Maintained-by:  Alejandro Colomar <alx@kernel.org>
Primary-site:   http://www.kernel.org/pub/linux/docs/man-pages
                2.7M  man-pages-6.10.tar.gz
Copying-policy: several; the pages are all freely distributable as long as
                nroff source is provided
End

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: man-pages-6.10 released

[Deri]

On Wednesday, 22 January 2025 22:26:48 GMT Alejandro Colomar wrote:
> Gidday!
> 
> I'm proud to announce:
> 
>         man-pages-6.10 - manual pages for GNU/Linux

Hi Alex,

I have noticed in recent releases using a newer version of groff, the overview 
panel was getting double entries. Here's a patch to fix it. 

================================================================================

diff --git a/share/mk/build/pdf/book/prepare.pl b/share/mk/build/pdf/book/
prepare.pl
index ef8c17b18..4620072ca 100755
--- a/share/mk/build/pdf/book/prepare.pl
+++ b/share/mk/build/pdf/book/prepare.pl
@@ -184,7 +184,7 @@ sub BuildPage
                                # Add a level two bookmark. We don't set it in 
the TH macro since the name passed
                                # may be different from the filename, i.e. 
file = unimplemented.2, TH = UNIMPLEMENTED 2
 
-                               print ".pdfbookmark -T $bkmark 2 $nm($sec)\n";
+                               print ".pdfhref M -N $bkmark\n";
 
                                next;
                        }

================================================================================

Cheers

Deri

Re: man-pages-6.10 released

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1844 bytes --]

Hi Deri!

On Thu, Jan 23, 2025 at 10:53:04PM +0000, Deri wrote:
> On Wednesday, 22 January 2025 22:26:48 GMT Alejandro Colomar wrote:
> > Gidday!
> > 
> > I'm proud to announce:
> > 
> >         man-pages-6.10 - manual pages for GNU/Linux
> 
> Hi Alex,
> 
> I have noticed in recent releases using a newer version of groff, the overview 
> panel was getting double entries. Here's a patch to fix it. 

Thanks a lot!  I think I saw them, but then forgot about it.  :)

I've pushed this patch:
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=39591713834b04707baebde59f78e71f1f3f3697>

And the book that I generate from the main branch at my server already
shows nicely:
<https://www.alejandro-colomar.es/share/dist/man-pages/git/HEAD/man-pages-HEAD.pdf>


Have a lovely night!
Alex

> 
> ================================================================================
> 
> diff --git a/share/mk/build/pdf/book/prepare.pl b/share/mk/build/pdf/book/
> prepare.pl
> index ef8c17b18..4620072ca 100755
> --- a/share/mk/build/pdf/book/prepare.pl
> +++ b/share/mk/build/pdf/book/prepare.pl
> @@ -184,7 +184,7 @@ sub BuildPage
>                                 # Add a level two bookmark. We don't set it in 
> the TH macro since the name passed
>                                 # may be different from the filename, i.e. 
> file = unimplemented.2, TH = UNIMPLEMENTED 2
>  
> -                               print ".pdfbookmark -T $bkmark 2 $nm($sec)\n";
> +                               print ".pdfhref M -N $bkmark\n";
>  
>                                 next;
>                         }
> 
> ================================================================================
> 
> Cheers
> 
> Deri
> 
> 

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: man-pages-6.10 released

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 2445 bytes --]

Hi Brian!

On Sun, Jan 26, 2025 at 12:20:08PM -0700, Brian Inglis wrote:
> On 2025-01-22 15:26, Alejandro Colomar wrote:
> > Gidday!
> > 
> > I'm proud to announce:
> > 
> > 	man-pages-6.10 - manual pages for GNU/Linux
> > 
> > I'm also very happy to announce that I'm back to maintaining this
> > project.  My work on this project, this release, and many more to come,
> > have been possible thanks to our sponsors.  Thank you very much!
> > 
> > 	-  Adfinis		<https://adfinis.com/>
> > 	-  Google		<https://opensource.google/>
> > 	-  Hudson River Trading	<https://www.hudsonrivertrading.com/>
> > 	-  Meta			<https://www.meta.com/>
> > 	-  Red Hat		<https://www.redhat.com/>
> 
> Hi Alex,
> 
> Welcome back!
> 
> Thanks for the new release.

:-)

> 
> But *last* year is in your release notice and "Changes" document:

<facepalm>

Thanks!  I've fixed it now:
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=43c1b600933d6c5f64ca0a08a6a848ec19cbdeec>

> 
> > ==================== Changes in man-pages-6.10 ====================
> > 
> > Released: 2024-01-22, Aldaya
> ...
> > ==================== Linux Software Map ===========================
> > 
> > Begin4
> > Title:          Linux man-pages
> > Version:        6.10
> > Entered-date:   2025-01-22
> 
> ```
> $ head -3 /usr/share/doc/man-pages-linux/Changes
> ==================== Changes in man-pages-6.10 ====================
> 
> Released: 2024-01-22, Aldaya
> ```
> 
> Cheers!
> 
> [Since the release of Single UNIX® Specification Version 5, POSIX®.1-2024,
> IEEE Std 1003.1™-2024 Edition, The ®Open Group Base Specifications Issue 8,
> and
> ISO®/IEC DIS 9945 Information technology - Portable Operating System
> Interface (POSIX®) base specifications - Issue 8 (ISO®/IEC 9945:2025 pending
> approval), are you still interested in updating the POSIX man pages, and
> have you heard any more from the Austin Group, or reached out to them?]

Yes, I am very interested.  I heard from them a long time ago, but they
haven't come back to me.  Does anyone have a contact there?

Also, I'll be at FOSDEM next weekend.  If anyone is interested in
meeting me there, please let me know.  It would be a good date to talk
about things like this.

In any case, I'll try to ping some POSIX people.


Have a lovely night!
Alex

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]