opnsense-src/usr.bin/man
Alexander Ziaee 46a9fb7287
man.1: Improve search + spdx
People are often stunned by robust manual search functionality on
the community discord, so improve introductory doc regarding search by:

+ explain what search related flags do instead of using similies
+ consolidate and standardize search options in synopsis and usage
+ mention that a page or file can be specified in synopsis and example
+ call regular expressions `expression`, which searches to re_format(7)
+ crossreference the regular expression manual instead of egrep(1)
+ improve MANPATH xref flow and explanation, matching MAILPATH in sh(1)
+ mark up aditional semantics for their inclusion in apropos

While here:
+ use consistent spacing and form (Ql) for quoted literals
+ clean a few linter errors regarding self xref and nospace
+ reset a list width to indent for consistency with style.mdoc
+ tidy examples + align files + tag spdx

Outstanding:
- example 3 shows no results on a typical bsdinstall'd system

MFC after:	3 days
Reviewed by:	elliejs, emaste, imp, Jessica Hawkwell, jlduran
Approved by:	imp
2025-01-24 19:07:01 -05:00
..
Makefile Remove residual blank line at start of Makefile 2024-07-15 16:43:39 -06:00
Makefile.depend
man.1 man.1: Improve search + spdx 2025-01-24 19:07:01 -05:00
man.conf.5 switch groff parameter -man to -mandoc for new groff release 1.23.0 2023-09-07 14:59:12 +00:00
man.sh man.1: Improve search + spdx 2025-01-24 19:07:01 -05:00
manpath.1 manpath.1: align lists + tag spdx 2024-10-10 13:27:10 -03:00