Bug 273324

Summary: Stem apropos results at man.freebsd.org
Product: Documentation Reporter: Graham Perrin <grahamperrin>
Component: Manual PagesAssignee: freebsd-bugs (Nobody) <bugs>
Status: New ---    
Severity: Affects Only Me CC: doc
Priority: --- Keywords: feature
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://man.freebsd.org/
See Also: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=273248
Attachments:
Description Flags
apropos glob
none
apropos sort none

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