100 Commits
Author SHA1 Message Date
Wolfram Schneider 13d222bd83 manpages: Fix unusual Xr order 2026-10-26 10:53:02 +00:00
Wolfram Schneider 029466808f manpages: Fix unusual Xr order 2026-10-26 10:46:28 +00:00
Wolfram Schneider fb4f233466 manpages: Fix unusual Xr order 2026-10-26 10:44:08 +00:00
Wolfram Schneider 2ba2623414 manpages: Fix unusual Xr order 2026-10-26 10:41:28 +00:00
Wolfram Schneider f5b6c8f5c2 manpages: Fix unusual Xr order 2026-10-26 10:35:42 +00:00
Wolfram Schneider 3208a17f96 manpages: Fix unusual Xr order 2026-10-26 10:32:42 +00:00
Wolfram Schneider afe20e82f9 manpages: Fix unusual Xr order 2026-10-26 10:29:10 +00:00
Wolfram Schneider 4560b19ff4 manpages: Fix unusual Xr order 2026-10-26 10:27:43 +00:00
Wolfram Schneider f7114dc7b7 manpages: Fix unusual Xr order 2026-10-25 12:06:08 +00:00
Wolfram Schneider 44a5cf1372 manpages: Fix unusual Xr order 2026-10-25 12:02:00 +00:00
Wolfram Schneider 3f4743d657 manpages: Fix unusual Xr order 2026-10-25 11:57:18 +00:00
Wolfram Schneider 741197267e manpages: Fix unusual Xr order 2026-10-25 11:51:42 +00:00
Wolfram Schneider 14680d205c ps.1: Fix unusual Xr order 2026-10-25 11:36:15 +00:00
Wolfram Schneider 51a531151a df.1: Fix unusual Xr order 2026-10-25 11:32:12 +00:00
Wolfram Schneider a03b051f23 locate.1: clarify bytes vs. characters
The database stores bytes, not characters. Remove the historical
note about 7-bit storage. Also document that -i ignores case only
for ASCII letters.

Reviewed by: ziaee
MFC after: 3 days
2026-10-24 10:12:05 +00:00
Wolfram Schneider ad0f866941 find.1: rewrite the -s flag section for clarity
Restructure the description of -s flag:
1. what the option does
2. why it is useful (deterministic order, streaming output)
3. how its results can differ from `find | sort'

Reviewed by: ziaee
MFC after: 3 days
2026-10-22 08:50:56 +00:00
Wolfram Schneider d3bad289df bsd-family-tree: polish grammar and style
Reviewed by:	ziaee
2026-10-20 07:41:17 +00:00
Wolfram Schneider 629c7cf72d bsd-family-tree: add macOS 27 2026-09-29 19:32:56 +00:00
Wolfram Schneider 32cf24b725 ctfmerge.1: Import ENVIRONMENT from NetBSD
Import the ENVIRONMENT section from NetBSD, minus the variable that our
ctfmerge does not have. Alphabetize them, polish grammar and alignment,
and add the variables to the man database. While here, remove whitespace
from the end of some lines to quiet linter.

MFC after:	3 days
PR:		291186
Co-authored-by:	Alexander Ziaee <[email protected]>
Obtained from:  NetBSD (christos <[email protected]>, 8a0c0d8)
Differential Revision:	https://reviews.freebsd.org/D54054
2026-06-30 09:42:59 -04:00
Wolfram Schneider a2c87d4f88 symlink.7: add a new section "mount options"
Add a new section "mount options" to explain
the mount option nosymfollow in more details.

Differential Revision:	https://reviews.freebsd.org/D54530
2026-01-19 10:47:53 +00:00
Wolfram Schneider a067eb525e mount.8: document nosymfollow option
Document the nosymfollow mount option in more details.
Forgotten in 5ddc8ded1d
2025-11-24 08:33:07 +00:00
Wolfram Schneider 385796001c utx.8: protect first name "Ed"
For some people "Ed" is a first name, but for mandoc it is a
macro (end of display block) and needs to be escaped.
2025-11-08 08:04:33 +00:00
Wolfram Schneider 3eed21505f bsd-family-tree: add FreeBSD 16 -current 2025-09-13 05:29:09 +00:00
Wolfram Schneider c8cf8d851c bsd-family-tree: improve EOL section with FreeBSD references
Reported by:	Herbert J. Skuhra <[email protected]>
2025-08-10 14:57:42 +00:00
Wolfram Schneider 5bffa1d206 bsd-family-tree: add End-of-Life (EOL) section 2025-08-10 05:39:36 +00:00
Wolfram Schneider 71d65d2595 bsd-family-tree: add End-of-life (EOL) section 2025-08-10 05:38:15 +00:00
Wolfram Schneider 479b9db526 release: make symlink creation for src.tgz more robust
PR: 288256
Approved by:	emaste
Differential Revision:	https://reviews.freebsd.org/D51335
2025-07-22 05:22:39 +00:00
Wolfram Schneider f8b632fb04 man.sh: avoid endless loop
limit the number of .so includes to a value of 32 instead of infinity.

PR: 287037
Differential Revision: https://reviews.freebsd.org/D51412
2025-07-21 07:23:45 +00:00
Wolfram Schneider afa70490ee src/Makefile: log real/user/system time for build targets
For some of our build targets such as buildworld, buildkernel etc. we log
the real time in seconds how long the build runs. Now we log the user and
system time as well in milliseconds for most build targets.

Example output:

make buildworld
[....]
>>> Time spent on target buildworld: real 2286.42 user 62870.84 sys 2294.22

PR:  287274
2025-06-29 10:48:55 +00:00
Wolfram Schneider 27aec148ea mididumpl.1: update link to Standard MIDI-File Format Spec. 1.1, updated
PR:		287588
MFC after:	1 week
2025-06-23 05:36:51 +00:00
Wolfram Schneider fb4cdd5160 fhreadlink.2: fix old typo in the manpage
PR: 282967
Approved by: kib
2024-11-25 18:38:20 +00:00
Wolfram Schneider aebac84982 manpage: cross link fhreadlink(2) <-> readlink(2) 2024-11-25 09:02:34 +00:00
Wolfram Schneider 95b17d3b1c mktemp(3): bring the documentation up to date with best practice
Using short temp filenames as /tmp/temp.XXXX (4 or 6 X) was probably ok
20 years ago, but not anymore. Best practice is to use 10 X. Given that our
users often copy & paste examples from our manual pages we need to
update the documentation.

PR: 261437
2024-10-27 16:41:01 +00:00
Wolfram Schneider 93181e3834 mktemp(1): bring the documentation up to date with best practice
Using short temp filenames as /tmp/temp.XXXX (4 or 6 X) was probably ok
20 years ago, but not anymore. Best practice is to use 10 X. Given that our
users often copy & paste examples from our manual pages we need to
update the documentation.

PR: 261437
2024-10-27 16:36:31 +00:00
Wolfram Schneider 9d585fc395 absolute-symlink.sh: check for absolute symlinks on a FreeBSD system
The purpose of this script is to detect absolute symlinks on
a machine, e.g.:

    /etc/localtime -> /usr/share/zoneinfo/UTC

Some of these absolute symbolic links can be created intentionally,
but it is usually better to use relative symlinks.

You can run the script after `make installworld', or any other
make targets thats installs files.

You can also check your local ports with:

   env ABSOLUTE_SYMLINK_DIRS=/usr/local ./absolute-symlink.sh
2024-10-26 08:31:19 +00:00
Wolfram Schneider c77ca9a72c stale-symlink-buildworld.sh: improve documentation 2024-09-09 14:55:29 +00:00
Wolfram Schneider 9867b4af50 Makefile.inc1: show time for `make installworld'
For years we display the time in seconds how long it takes to
run `make buildworld' (see PR 224433). Now we will display the
time for "installworld" and "installkernel" as well.

e.g.:
--------------------------------------------------------------
>>> Installing everything completed on Sun Jul  7 16:11:37 UTC 2024
>>> Install world completed in 110 seconds, ncpu: 2, make -j2
--------------------------------------------------------------

This is an improved version of commit e5a0202f96

PR: 280187
Differential Revision: https://reviews.freebsd.org/D45912
2024-09-02 09:55:10 +00:00
Wolfram Schneider b49aec04f0 bsd-family-tree: fix macOS 11 release date 2024-08-20 14:36:20 +00:00
Wolfram Schneider d4a4d1e742 bsd-family-tree: shorter URLs 2024-08-20 13:29:18 +00:00
Wolfram Schneider d1e78fbd4a bsd-family-tree: add NetBSD 9.4 2024-08-20 13:26:46 +00:00
Wolfram Schneider 4132c4be4c bsd-family-tree: add FreeBSD Documentation Archive 2024-08-19 19:40:34 +00:00
Wolfram Schneider 2a91649947 bsd-family-tree: shorter URL for FreeBSD manual pages 2024-08-19 19:32:51 +00:00
Wolfram Schneider c9e8a2cdba ports(7): searchable index of all ports is at ports.freebsd.org
PR: 280816
2024-08-14 14:53:38 +00:00
Wolfram Schneider ccb0365643 stale symlinks: configurable obj dir prefix
Use $MAKEOBJDIRPREFIX if set, otherwise /usr/obj
2024-08-12 19:34:43 +00:00
Wolfram Schneider e5a0202f96 Makefile.inc1: show time for `make installworld'
For years we display the time in seconds how long it takes to
run `make buildworld' (see PR 224433). Now we will display the
time for "installworld" and "installkernel" as well.

e.g.:
--------------------------------------------------------------
>>> Installing everything completed on Sun Jul  7 16:11:37 UTC 2024
>>> Install world completed in 110 seconds, ncpu: 2, make -j2
--------------------------------------------------------------

PR: 280187
Approved by: imp
Differential Revision: https://reviews.freebsd.org/D45912
2024-07-13 10:37:14 +00:00
Wolfram Schneider e880dd644f stale-symlink-buildworld.sh: a script to check for stale symlinks on a FreeBSD system
You can run the script before or after `make installworld'

You may also check your local ports with:

  env STALE_SYMLINK_BUILDWORLD_DIRS=/usr/local ./stale-symlink-buildworld.sh

PR: 276235
2024-07-07 12:59:20 +00:00
Wolfram Schneider 965fff9826 man(1): ignore absolute path for .so include
We want only a relative include, as ".so man1/foobar.1"

MFC after:	1 week
2024-06-03 16:00:42 +00:00
Wolfram Schneider 73eb53813f man(1) needs to check for .so files not only in the first line
PR: 279182

Some manual pages have a copyright notice or commit id before including
other files with the .so macro. We need to skip comments and empty lines
at the beginning of the manpage while checking for the first .so macro.

MFC after:	1 week
2024-05-26 05:48:40 +00:00
Wolfram Schneider 37be4197f7 man: the exists function needs to validate the first parameter
This fixes an issue with the ".so " macro for FreeBSD
ports manual pages.

PR: 275978
Reported by:	Jamie Landeg-Jones <[email protected]>
MFC after:	1 week

Differential Revision:	https://reviews.freebsd.org/D45231 (discussion)
2024-05-20 16:02:21 +00:00
Wolfram Schneider 14a5c1068d man: do not ignore the exit status of roff tools
PR:		223516
Approved by:	emaste, bapt
Differential Revision:	https://reviews.freebsd.org/D44798
2024-04-20 08:30:33 +00:00
Wolfram Schneider b8a484ec34 man: support special characters in filenames
man.sh needs to handle double quotes and sub shell character
as '`' '$' etc.

PR:		275967
Reviewed by:	bapt

MFC after:	1 week
Differential Revision: https://reviews.freebsd.org/D43453
2024-01-25 07:14:06 +00:00
Wolfram Schneider e3c7b76fa8 man(1): support spaces in filenames
The globbing function in exists() needs to handle white spaces.

PR:          275978
Reviewed by: kevans, bapt, emaste
MFC after:   1 week
2024-01-13 16:16:55 +00:00
Wolfram Schneider 1e82d882ed fix using man(1) with multiple pages
PR: 275978
Reported by: Mohamed Akram
Fixes: 789480702e
MFC after: 1 week
2024-01-08 16:05:50 +00:00
Wolfram Schneider 9035bfffed indent: make the URL of the manpage two characters longer so that the test is successful 2023-12-29 09:37:43 +00:00
Wolfram Schneider ffd76b1f30 use long manpage URL (broken in last commit)
Reported by:	pstef
2023-12-28 15:58:56 +00:00
Wolfram Schneider 789480702e support spaces in filenames
PR:		275978
MFC after:	1 week
2023-12-28 10:50:29 +00:00
Wolfram Schneider 271887ec35 update manpage URL 2023-12-28 10:48:04 +00:00
Wolfram Schneider f8952e4ee0 update homepage for FreeBSD Manual Pages (again) 2023-12-28 07:11:38 +00:00
Wolfram Schneider c4368d03e5 improve handling of shell metacharacters in filenames
PR:		275967
MFC after:	1 week
2023-12-27 17:36:51 +00:00
Wolfram Schneider dd0d16cc4d correct FreeBSD release
PR: 273690
2023-09-14 10:10:35 +00:00
Wolfram Schneider e806976349 update homepage for FreeBSD Manual Pages 2023-09-14 08:41:12 +00:00
Wolfram Schneider 6d221ee355 correct FreeBSD release
PR: 273690
2023-09-14 08:03:05 +00:00
Wolfram Schneider e47a47b215 no trailing dot (".") for FreeBSD releases
PR:		273690
2023-09-12 06:42:47 +00:00
Wolfram Schneider cd89fe3923 switch groff parameter -man to -mandoc for new groff release 1.23.0
PR: 273565
2023-09-07 14:59:12 +00:00
Wolfram Schneider 035f7c9a36 switch groff parameter -man to -mandoc
groff 1.23.0 changed the semantics of the -man parameter, and many
manual pages are not rendered. The -mandoc parameter brings back
the old behavior, as in groff 1.22.4 and earlier.

PR: 273565, 273245

Reviewed by:	emaste, bapt
MFC after: 1 week for all supported branches (stable/12, 13, 14)
Differential Revision:	https://reviews.freebsd.org/D41737
2023-09-07 06:28:24 +00:00
Wolfram Schneider b3087b63da remove stale portsinfo script 2023-05-15 06:34:20 +00:00
Wolfram Schneider 1206aa2786 remove stale handbook scripts 2023-05-15 06:30:34 +00:00
Wolfram Schneider 27783115a9 remove stale message-id scripts 2023-05-15 06:29:39 +00:00
Wolfram Schneider 1cf4473fa3 remove stale script epfe.pl
tools/tools/epfe/epfe.pl was a perl script that formerly generated some
printing example files from content in a very old version of the handbook.

Reported by:	wblock
2023-05-15 06:22:41 +00:00
Wolfram Schneider 433c5a8ae4 do not expect mandoc(1) to terminate in finite time
PR:		266868
2022-12-27 17:04:04 +00:00
Wolfram Schneider 047eec4966 improve c style
- BSD KNF: return is a native statement and we use
  a space before the parenthesis
- remove superfluous empty lines

Reported by:    jrtc27
2022-02-14 19:30:09 +00:00
Wolfram Schneider a9a43945d3 grammar
Reported by:	jrtc27
2022-02-14 18:16:43 +00:00
Wolfram Schneider 93885bb041 Better help message if locate database does not exists
PR:		211501
Reported by:	Oliver Peter
Reviewed by:	Pau Amma
Differential Revision:	https://reviews.freebsd.org/D34243
2022-02-13 17:00:22 +00:00
Wolfram Schneider 98839c40c7 better unique file names
Our mktemp(1) implementation uses 8-X for a temp file by default.
That's ok, but we should increase the value from 8 to 10 as
many other OS already did.

PR:		261438
2022-02-12 11:35:51 +00:00
Wolfram Schneider e515b9b44c update external URL 2022-02-05 20:04:00 +00:00
Wolfram Schneider b5a38d1f24 update external URL 2022-02-05 19:54:59 +00:00
Wolfram Schneider b2dfb50f3f update external URL 2022-02-05 19:49:46 +00:00
Wolfram Schneider 4aa85205a5 update external URL 2022-02-05 19:43:03 +00:00
Wolfram Schneider 08915d6ad5 remove defunct Sundance URL 2022-02-05 19:41:28 +00:00
Wolfram Schneider 0e39bc2c14 remove defunct Ralink Technology URL 2022-02-05 19:39:18 +00:00
Wolfram Schneider 1f9aaf18b1 update external URL 2022-02-05 19:23:51 +00:00
Wolfram Schneider 8799e12ebc update external URL 2022-02-05 19:19:43 +00:00
Wolfram Schneider f80a9407e4 update external URL 2022-02-05 19:17:33 +00:00
Wolfram Schneider 7e18e86d8c remove defunct National Semiconductor URL 2022-02-05 18:44:52 +00:00
Wolfram Schneider ec1e597a3c update external URL 2022-02-05 18:32:38 +00:00
Wolfram Schneider a9fd00a8b4 update URL 2022-02-05 18:30:06 +00:00
Wolfram Schneider a0e33bbdc5 update URL 2022-02-05 17:35:24 +00:00
Wolfram Schneider 179a53bb91 update external URL 2022-02-05 17:14:27 +00:00
Wolfram Schneider 83e6667726 update external URL 2022-02-05 17:11:18 +00:00
Wolfram Schneider c918f50f8b update external URL 2022-02-05 17:09:48 +00:00
Wolfram Schneider 610b97ebaa update external URL 2022-02-05 09:13:07 +00:00
Wolfram Schneider 153dd4ba03 fix URL typo 2022-02-05 09:08:45 +00:00
Wolfram Schneider 1c7a40d268 update external URL 2022-02-05 09:00:35 +00:00
Wolfram Schneider c126924c8c update external URL 2022-02-05 08:58:30 +00:00
Wolfram Schneider a6c20ddd4a switch from short to int for lookup table
This simplifies the code, less casting is needed.
2022-02-05 08:44:35 +00:00
Wolfram Schneider 6981ec8bdf update external URLs 2022-02-05 08:19:56 +00:00
Wolfram Schneider d43255b50c remove dead code
A lookup array is faster than a function with linear search.
The old function was not used for years - spring cleaning.
2022-02-03 17:02:37 +00:00
Wolfram Schneider 39a30a8097 better printf(3) format usage
Reported by: jhb
2022-02-03 16:57:25 +00:00
Wolfram Schneider 792df7ced2 improve casting for pointer diffs 2022-02-01 17:26:20 +00:00
Wolfram Schneider 1536d37b20 fix casting issue in error message for 32bit CPUs (e.g. armv7) 2022-01-31 18:30:07 +00:00