Bug 273324 - Stem apropos results at man.freebsd.org
Summary: Stem apropos results at man.freebsd.org
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL: https://man.freebsd.org/
Keywords: feature
Depends on:
Blocks:
 
Reported: 2023-08-24 09:14 UTC by Graham Perrin
Modified: 2023-08-24 09:30 UTC (History)
1 user (show)

See Also:


Attachments
apropos glob (153.40 KB, application/pdf)
2023-08-24 09:21 UTC, Graham Perrin
no flags Details
apropos sort (140.30 KB, application/pdf)
2023-08-24 09:30 UTC, Graham Perrin
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin 2023-08-24 09:14:42 UTC
A few weeks ago at <https://man.freebsd.org/cgi/man.cgi?query=glob&apropos=1> I noticed that for some ports, manual pages do not have suitably formed NAME sections. 

Bug 273248 intends to fix this for kitty.conf(5). 

From the apropos results above, I have a shortlist of other ports that might be improved e.g. upstream. 

I experimented with a different search. <https://man.freebsd.org/cgi/man.cgi?query=sort&apropos=1> reveals more misfits, such as certbot(1). 

----

To work around affected ports that will not (or can not) be enhanced, is it possible for man.freebsd.org representations to be somehow stemmed? 

Stemming after the first two _perceptible_ paragraphs might be enough. Food for thought: 

<https://man.freebsd.org/cgi/man.cgi?query=samba-dcerpcd&sektion=8&manpath=freebsd-ports>

<https://man.freebsd.org/cgi/man.cgi?query=virtualenv&sektion=1&manpath=freebsd-ports>

Thanks
Comment 1 Graham Perrin 2023-08-24 09:21:16 UTC
Created attachment 244310 [details]
apropos glob
Comment 3 Graham Perrin 2023-08-24 09:30:23 UTC
Created attachment 244311 [details]
apropos sort