[ITP not ITA]
On 2025-04-01 08:46, Brian Inglis wrote:
On 2025-04-01 02:37, Corinna Vinschen via Cygwin wrote:
On Mar 31 23:26, Brian Inglis via Cygwin wrote:
On 2025-03-31 12:49, Corinna Vinschen via Cygwin wrote:
On Mar 31 12:35, Brian Inglis via Cygwin wrote:
Has anyone a feel if there are any other projects on that list whose man
pages would be useful under Cygwin even if the package itself is not
available, or even individual man pages where they are not currently
available?
We have quite a few functions which might be only available on BSD systems,
and we have these Solaris ACL functions which don't exist on Linux. We
probably can't use the man pages from Solaris due to copyright constraints,
but the FreeBSD man pages should be ok.
The Solaris man pages were made available under the CDDL or PDL derived
from MPL: we have Solaris 10 and OpenSolaris 2010 available on the
freebsd.org site, a well as most other OSes anyone might want: 520 of
them, from 7th Edition, 2.10BSD, 386BSD, thru 4.4Lite2, etc.
Oh, great.
Space required for FreeBSD man pages is comparable to man-pages-linux -
should we make all FreeBSD 15.0 current man pages available similar to
man-pages-linux - man-pages-freebsd package and directory under
/usr/share/man/ symlinked as freebsd for convenience with man -m|--systems
SYSTEM,...?
Or should we stick to the original idea and package only selected missing
man pages in the other sections of posix.xml as man-pages-extra?
Your call. As long as we don't have dedicated people creating matching
man pages for Cygwin (very unlikely for such a small project), we'll
never have 100% accurate man pages either way. So it might be a bit too
much hassle to tweak the FreeBSD man pages into a form matching Cygwin.
The intent would be select from acl, FreeBSD, Solaris, whatever is needed, and
not do any tweaking.
For comparison, I attach lists of acl man pages from acl project, FreeBSD 15,
OpenSolaris 2010, and Solaris 10 tars of man pages.
The only question is, assuming as a user I have have man-pages-linux
and man-pages-freebsd installed. How do I decide on the command line
which of them I see?
Based on man-pages-linux announcements, for man-pages-freebsd we could say
(TL;DR: look at end):
"As Cygwin has its own man pages with some overlap, these man pages are
installed under /usr/share/man/man-pages-freebsd/, so by default searching
or viewing these pages requires the option:
$ apropos -m|--systems man-pages-freebsd...
$ man -m|--systems man-pages-freebsd ...
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,man-pages-freebsd ...
The path or option may also be added explicitly to a user's MANPATH or
alias e.g.
$ export MANPATH=$MANPATH:/usr/share/man/man-pages-freebsd
$ alias apropos='apropos -m man,man-pages-freebsd'
$ alias man='man -m man,man-pages-freebsd'
Add -a to show both Cygwin and FreeBSD (and Linux and POSIX if companion
packages man-pages-linux and/or man-pages-posix are also installed) manual
pages, for example:
$ alias man='man -m man,man-pages-freebsd,man-pages-linux,man-pages-posix'
where man page display is prioritized by alphabetic directory order of systems,
rather than option order (which is explicitly supported for sections selection).
For convenience and backward compatibility /usr/share/man/freebsd is
provided as a symlink.
If you prefer to see FreeBSD man pages over Cygwin man pages, then use
-m|--systems freebsd in the examples above, or add -m freebsd to a man command."
--
Take care. Thanks, Brian Inglis Calgary, Alberta, Canada
La perfection est atteinte Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter not when there is no more to add
mais lorsqu'il n'y a plus rien à retrancher but when there is no more to cut
-- Antoine de Saint-Exupéry
--
Take care. Thanks, Brian Inglis Calgary, Alberta, Canada
La perfection est atteinte Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter not when there is no more to add
mais lorsqu'il n'y a plus rien à retrancher but when there is no more to cut
-- Antoine de Saint-ExupérySunOS-5.10/man1as/asadmin-create-acl.1as
SunOS-5.10/man1as/asadmin-delete-acl.1as
SunOS-5.10/man1as/asadmin-list-acls.1as
SunOS-5.10/man1as/create-acl.1as
SunOS-5.10/man1as/delete-acl.1as
SunOS-5.10/man1as/list-acls.1as
SunOS-5.10/man1/getfacl.1
SunOS-5.10/man1/setfacl.1
SunOS-5.10/man2/acl.2
SunOS-5.10/man2/facl.2
SunOS-5.10/man3sec/aclcheck.3sec
SunOS-5.10/man3sec/aclfrommode.3sec
SunOS-5.10/man3sec/aclfromtext.3sec
SunOS-5.10/man3sec/aclsort.3sec
SunOS-5.10/man3sec/acltomode.3sec
SunOS-5.10/man3sec/acltotext.3sec
SunOS-5.10/man4/kadm5.acl.4
SunOS-5.10/sman1as/asadmin-create-acl.1as
SunOS-5.10/sman1as/asadmin-delete-acl.1as
SunOS-5.10/sman1as/asadmin-list-acls.1as
SunOS-5.10/sman1as/create-acl.1as
SunOS-5.10/sman1as/delete-acl.1as
SunOS-5.10/sman1as/list-acls.1as
OpenSolaris-2010.03-snv_134/share/man/man1/getfacl.1
OpenSolaris-2010.03-snv_134/share/man/man1/setfacl.1
OpenSolaris-2010.03-snv_134/share/man/man2/acl.2
OpenSolaris-2010.03-snv_134/share/man/man2/facl.2
OpenSolaris-2010.03-snv_134/share/man/man3sec/aclcheck.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/aclfrommode.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/aclfromtext.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/aclsort.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acltomode.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acltotext.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_check.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_free.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_fromtext.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_get.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_set.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_strip.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_totext.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/acl_trivial.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/facl_get.3sec
OpenSolaris-2010.03-snv_134/share/man/man3sec/facl_set.3sec
OpenSolaris-2010.03-snv_134/share/man/man4/kadm5.acl.4
OpenSolaris-2010.03-snv_134/share/man/man5/acl.5
acl-2.3.2/man/man1/chacl.1
acl-2.3.2/man/man1/getfacl.1
acl-2.3.2/man/man1/setfacl.1
acl-2.3.2/man/man3/acl_add_perm.3
acl-2.3.2/man/man3/acl_calc_mask.3
acl-2.3.2/man/man3/acl_check.3
acl-2.3.2/man/man3/acl_clear_perms.3
acl-2.3.2/man/man3/acl_cmp.3
acl-2.3.2/man/man3/acl_copy_entry.3
acl-2.3.2/man/man3/acl_copy_ext.3
acl-2.3.2/man/man3/acl_copy_int.3
acl-2.3.2/man/man3/acl_create_entry.3
acl-2.3.2/man/man3/acl_delete_def_file.3
acl-2.3.2/man/man3/acl_delete_entry.3
acl-2.3.2/man/man3/acl_delete_perm.3
acl-2.3.2/man/man3/acl_dup.3
acl-2.3.2/man/man3/acl_entries.3
acl-2.3.2/man/man3/acl_equiv_mode.3
acl-2.3.2/man/man3/acl_error.3
acl-2.3.2/man/man3/acl_extended_fd.3
acl-2.3.2/man/man3/acl_extended_file.3
acl-2.3.2/man/man3/acl_extended_file_nofollow.3
acl-2.3.2/man/man3/acl_free.3
acl-2.3.2/man/man3/acl_from_mode.3
acl-2.3.2/man/man3/acl_from_text.3
acl-2.3.2/man/man3/acl_get_entry.3
acl-2.3.2/man/man3/acl_get_fd.3
acl-2.3.2/man/man3/acl_get_file.3
acl-2.3.2/man/man3/acl_get_permset.3
acl-2.3.2/man/man3/acl_get_perm.3
acl-2.3.2/man/man3/acl_get_qualifier.3
acl-2.3.2/man/man3/acl_get_tag_type.3
acl-2.3.2/man/man3/acl_init.3
acl-2.3.2/man/man3/acl_set_fd.3
acl-2.3.2/man/man3/acl_set_file.3
acl-2.3.2/man/man3/acl_set_permset.3
acl-2.3.2/man/man3/acl_set_qualifier.3
acl-2.3.2/man/man3/acl_set_tag_type.3
acl-2.3.2/man/man3/acl_size.3
acl-2.3.2/man/man3/acl_to_any_text.3
acl-2.3.2/man/man3/acl_to_text.3
acl-2.3.2/man/man3/acl_valid.3
acl-2.3.2/man/man5/acl.5
FreeBSD-15.0-CURRENT/man/man1/getfacl.1.gz
FreeBSD-15.0-CURRENT/man/man1/setfacl.1.gz
FreeBSD-15.0-CURRENT/man/man3/acl.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_add_flag_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_add_perm.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_calc_mask.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_clear_flags_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_clear_perms.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_cmp.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_cmp_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_copy_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_create_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_create_entry_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_def_file.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_def_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_entry_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_fd_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_file_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_flag_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_delete_perm.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_dup.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_equiv_mode_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_extended_file_nofollow_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_extended_file_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_extended_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_free.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_from_mode_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_from_text.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_brand_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_entry_type_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_fd.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_fd_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_file.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_flagset_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_flag_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_permset.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_perm_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_qualifier.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_get_tag_type.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_init.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_is_trivial_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_entry_type_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_fd.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_fd_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_file.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_flagset_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_permset.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_qualifier.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_set_tag_type.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_strip_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_to_text.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_to_text_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_valid.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_valid_fd_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_valid_file_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/acl_valid_link_np.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_add_entry.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_add_entry_w.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_clear.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_count.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_next.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_next_w.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_reset.3.gz
FreeBSD-15.0-CURRENT/man/man3/archive_entry_acl_text_w.3.gz
FreeBSD-15.0-CURRENT/man/man3/krb5_acl_match_file.3.gz
FreeBSD-15.0-CURRENT/man/man3/krb5_acl_match_string.3.gz
FreeBSD-15.0-CURRENT/man/man3/sysdecode_acltype.3.gz
FreeBSD-15.0-CURRENT/man/man4/mac_ipacl.4.gz
FreeBSD-15.0-CURRENT/man/man4/mac_portacl.4.gz
FreeBSD-15.0-CURRENT/man/man4/wlan_acl.4.gz
FreeBSD-15.0-CURRENT/man/man7/maclabel.7.gz
FreeBSD-15.0-CURRENT/man/man9/acl.9.gz
FreeBSD-15.0-CURRENT/man/man9/vaccess_acl_nfs4.9.gz
FreeBSD-15.0-CURRENT/man/man9/vaccess_acl_posix1e.9.gz
