Bug 278904 - misc/freebsd-doc-en: HTML should be single page
Summary: misc/freebsd-doc-en: HTML should be single page
Status: Closed Not A Bug
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Document Engineering Group (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2024-05-11 02:29 UTC by Henrich Hartzer
Modified: 2024-05-22 00:04 UTC (History)
1 user (show)

See Also:
bugzilla: maintainer-feedback? (doceng)

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Henrich Hartzer 2024-05-11 02:29:27 UTC 
I feel that the misc/freebsd-doc-en port should install the HTML documentation as a single page, or at least have a single page HTML option.

I like that on the single page handbook (online) I can ctrl+f and find whatever I might be looking for. Search options are very limited with the multiple page setup. The multiple page setup is most useful if there are bandwidth limitations, which there should not be if browsing file:///usr/local/share/doc/freebsd/en/books/handbook/index.html

I can of course use the PDF, but it feels clumsy compared to the HTML format. Search is much faster through HTML than PDF in this case.

I know this is simply a matter of opinion, but hopefully someone else feels the same way, or this can be made an option.

Thank you!
Comment 1 Fernando Apesteguía freebsd_committer freebsd_triage 2024-05-15 18:36:01 UTC 
Are you referring to this one?

$ pkg which /usr/local/share/doc/freebsd/en/books/handbook/book/index.html 
/usr/local/share/doc/freebsd/en/books/handbook/book/index.html was installed by package en-freebsd-doc-20240410,1

$ ls -latrh /usr/local/share/doc/freebsd/en/books/handbook/book/index.html 
-rw-r--r--  1 root wheel  2.6M Apr 16 20:20 /usr/local/share/doc/freebsd/en/books/handbook/book/index.html

That is the accumulated, one-single-page handbook for instance.
Comment 2 Henrich Hartzer 2024-05-22 00:04:15 UTC 
You're right! I didn't realize that file was there.

I was using /usr/local/share/doc/freebsd/en/books/handbook/index.html but should have been using /usr/local/share/doc/freebsd/en/books/handbook/book/index.html.

Thank you!