public inbox for cygwin-announce@cygwin.com
 help / color / mirror / Atom feed
* Updated: man-pages-linux 6.00
@ 2022-10-15 19:09 Cygwin Linux Man Pages Maintainer
  0 siblings, 0 replies; only message in thread
From: Cygwin Linux Man Pages Maintainer @ 2022-10-15 19:09 UTC (permalink / raw)
  To: Cygwin Announcements

The following package has been upgraded in the Cygwin distribution:

* man-pages-linux	6.00

Documents the Linux kernel system calls and C library interfaces used
by programs, plus system and administrative utilities, devices, file
system, file, and data formats, and related information.

For more information, see the project home page:

	https://kernel.org/doc/man-pages/

You may also search and read the pages online:

	https://man7.org/linux/man-pages/

although the latest release may not yet be available. 

This major release adds some section 2 and 3 pages suffixed by
const, head, or type installed in the base section directory.

As Cygwin has its own man pages with some conflicts, these man pages
are installed under /usr/share/man/linux/, so by default searching
or viewing these pages requires the option:

	$ apropos -m|--systems linux ...
	$ man -m|--systems linux ...

Cygwin man pages are under the default system "man", so for convenience
both systems may be specified separated by comma e.g.

	$ man -m man,linux ...

The path or option may also be added explicitly to a users MANPATH or
alias e.g.

	$ export MANPATH=$MANPATH:/usr/share/man/linux

	$ alias apropos='apropos -m man,linux'
	$ alias man='man -m man,linux'

Add -a to show both Cygwin and Linux manual pages if present, or swap
the order to prioritize Linux.

For recent changes, please see below, or after installation read
/usr/share/doc/man-pages-linux/CHANGES:


Version 6.00	2022-10-09

Global changes

* Man dirs:

  - Move definitions of types to separate pages in man2type/ and
    man3type/. Previously, they were spread (and duplicated) in other
    pages, or in system_data_types.7 (with links in man3/).

  - Add man3head/ for pages that document header files.

  - Add man3const/ for pages that document constants.

* Licenses:

  - Use SPDX-License-Identifier for licenses specified by SPDX
    (including the newly-added Linux-man-pages-copyleft). This reduces
    the overhead text at the top of most manual page source files.
    License texts have been moved to LICENSES/.

* Build system:

  - Add several make(1) targets to lint the manual pages, and also lint
    and build the C programs contained in them. Use of these targets
    requires unreleased versions of software, such as groff-1.23.0, so
    it's not yet intended to be used by the public.

  - Add targets to build tarballs of the repository.

* man(7) source:

  - Improve consistency of man(7) source. Also, reduce the number of
    warnings that groff(1) and mandoc(7) emit when parsing the pages
    with the highest warning level. Most of these fixes were found
    thanks to the new `make lint-man` target.

* Manual pages sections:

  - Title (.TH):

    - Remove 5th argument to TH (middle-header).

    - Specify "Linux man-pages" and the version in the 4th argument
      (left-footer).

  - Add the LIBRARY section.  This section standardizes a way to
    document the library that provides a given interface.

  - Add the CAVEATS section.  BUGS and NOTES were serving that purpose
    before, but CAVEATS is more appropriate.

  - Rename the CONFORMING TO section to STANDARDS for consistency with
    other projects, such as the BSDs.

  - SYNOPSIS:  Add the ISO C2X [[deprecated]] attribute for functions
    that have been deprecated or removed.

  - EXAMPLES:  Improve consistency of C source code.  Also, reduce the
    number of warnings that several linting tools emit.

  - COLOPHON:  Remove section (its purpose is now served by the title).

* Repository:

  - CONTRIBUTING, README, INSTALL:  Document important changes in the
    project organization.

Changes to individual pages

The manual pages (and other files in the repository) have been improved
beyond what this changelog covers.

New and rewritten pages

* man2/
  landlock_add_rule.2
  landlock_create_ruleset.2
  landlock_restrict_self.2
  memfd_secret.2

* man2type/
  open_how.2type

* man3/
  _Generic.3

* man3const/
  NULL.3const

* man3head/
  sysexits.h.3head

* man3type/
  aiocb.3type
  blkcnt_t.3type
  blksize_t.3type
  cc_t.3type
  clock_t.3type
  clockid_t.3type
  dev_t.3type
  div_t.3type
  double_t.3type
  epoll_event.3type
  fenv_t.3type
  id_t.3type
  intN_t.3type
  intmax_t.3type
  intptr_t.3type
  iovec.3type
  itimerspec.3type
  lconv.3type
  mode_t.3type
  off_t.3type
  ptrdiff_t.3type
  regex_t.3type
  size_t.3type
  sockaddr.3type
  stat.3type
  time_t.3type
  timer_t.3type
  timespec.3type
  timeval.3type
  tm.3type
  va_list.3type
  void.3type

* man7/
  landlock.7

Newly documented interfaces in existing pages

* epoll_wait.2
  epoll_pwait2(2)

* fanotify_init.2
  FAN_REPORT_PIDFD

* fanotify_mark.2
  FAN_FS_ERROR
  FAN_MARK_EVICTABLE
  FAN_RENAME
  FAN_REPORT_TARGET_FID

* madvise.2
  MADV_POPULATE_READ
  MADV_POPULATE_WRITE

* pipe.2
  O_NOTIFICATION_PIPE

* process_madvise.2
  MADV_WILLNEED

* send.2
  MSG_FASTOPEN

* userfaultfd.2
  UFFD_USER_MODE_ONLY

* proc.5
  /proc/[pid]/pagemap    bit 57

* fanotify.7
  /proc/sys/fs/fanotify/max_queued_events
  /proc/sys/fs/fanotify/max_user_group
  /proc/sys/fs/fanotify/max_user_marks

* tcp.7
  TCP_FASTOPEN
  TCP_FASTOPEN_CONNECT

New and changed links

* man3/
  strftime_l.3

* man3type/
  epoll_data.3type
  epoll_data_t.3type
  fexcept_t.3type
  float_t.3type
  gid_t.3type
  imaxdiv_t.3type
  in6_addr.3type
  in_addr.3type
  in_addr_t.3type
  in_port_t.3type
  int16_t.3type
  int32_t.3type
  int64_t.3type
  int8_t.3type
  ldiv_t.3type
  lldiv_t.3type
  loff_t.3type
  off64_t.3type
  pid_t.3type
  regmatch_t.3type
  regoff_t.3type
  sa_family_t.3type
  sockaddr_in.3type
  sockaddr_in6.3type
  sockaddr_storage.3type
  sockaddr_un.3type
  socklen_t.3type
  speed_t.3type
  ssize_t.3type
  suseconds_t.3type
  tcflag_t.3type
  uid_t.3type
  uint16_t.3type
  uint32_t.3type
  uint64_t.3type
  uint8_t.3type
  uintN_t.3type
  uintmax_t.3type
  uintptr_t.3type
  useconds_t.3type


^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2022-10-15 19:11 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-10-15 19:09 Updated: man-pages-linux 6.00 Cygwin Linux Man Pages Maintainer

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).