Bug 235567 - man physio(9) html page hyphen render break
Summary: man physio(9) html page hyphen render break
Status: In Progress
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Wolfram Schneider
URL: https://www.freebsd.org/cgi/man.cgi?q...
Keywords:
Depends on:
Blocks:
 
Reported: 2019-02-07 04:56 UTC by Michael Buch
Modified: 2023-10-12 05:52 UTC (History)
4 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Michael Buch 2019-02-07 04:56:09 UTC
In the description section for physio(9) the html page renders a misleading:
"dev-_si_iosize_max" instead of "dev->si_iosize_max". This happens in firefox and chrome.

Link: https://www.freebsd.org/cgi/man.cgi?query=physio&sektion=9&manpath=FreeBSD+13-current

I have seen this happen on occasional other man pages such as in the description of VFS_MOUNT(9): "mp-_mnt_flag".

https://www.freebsd.org/cgi/man.cgi?query=VFS_MOUNT&sektion=9&manpath=FreeBSD+13-current
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-12-27 15:22:48 UTC
Is the source code suitably written? 

(I see mdoc(7) and <https://mandoc.bsd.lv/mdoc/>, too much for me to take in, sorry.)

----

<https://github.com/freebsd/freebsd-src/commit/b6acc60d911d863b8bc49cac80a8b23fa2dd14e9?diff=split#diff-9874627201b54bde5b5662880bdc070add9ebc5e7d40686fc900067e76b6e964R60-R62>

The maximum amount of data to transfer with each call
is determined by
.Fa dev->si_iosize_max .

<https://www.freebsd.org/cgi/man.cgi?query=physio&sektion=9&manpath=FreeBSD#DESCRIPTION>

----

<https://github.com/freebsd/freebsd-src/blob/c1c03d4944f7cecd02d9a96a41d4e0c3c6c26b3d/share/man/man9/VFS_MOUNT.9#L66-L71>

If the
.Dv MNT_UPDATE
flag is set in
.Fa mp->mnt_flag
then the file system should update its internal state from the value of
.Fa mp->mnt_flag .

<https://www.freebsd.org/cgi/man.cgi?query=VFS_MOUNT&sektion=9&manpath=FreeBSD#DESCRIPTION>
Comment 2 Wolfram Schneider freebsd_committer freebsd_triage 2023-10-12 05:52:06 UTC
I think this is a bug in man.cgi HTML renderer. The ASCII and PDF output looks fine.