Bug 274230 - man-dev.freebsd.org unexpected justification (alignment) or off-centring of SYNOPSIS texts
Summary: man-dev.freebsd.org unexpected justification (alignment) or off-centring of S...
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-bugs (Nobody)
URL: https://man-dev.freebsd.org/
Keywords:
Depends on:
Blocks:
 
Reported: 2023-10-03 07:37 UTC by Graham Perrin
Modified: 2023-10-23 06:58 UTC (History)
3 users (show)

See Also:


Attachments
Screenshot of an easily understandable layout (40.25 KB, image/png)
2023-10-06 02:41 UTC, Graham Perrin
no flags Details
Screenshot of a less understandable layout (36.40 KB, image/png)
2023-10-06 02:49 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-10-03 07:37:44 UTC
This page, for example: 

<https://man-dev.freebsd.org/FreeBSD-ports-13.1-RELEASE-quarterly/poudriere-distclean.8>

To me, this man-dev.⋯ case seems somewhat different from man.⋯ bug 274208, at least because <https://man.freebsd.org/cgi/man.cgi?query=poudriere-distclean&sektion=8&manpath=freebsd-ports> for the same poudriere-distclean(8) is not similarly bugged. 

----

<https://man-dev.freebsd.org/FreeBSD-ports-13.1-RELEASE-quarterly/poudriere-bulk.8> for poudriere-bulk(8) is OK, as are (authoritative) <https://github.com/freebsd/poudriere/wiki/poudriere-distclean.8> and <https://github.com/freebsd/poudriere/wiki/poudriere-bulk.8>.
Comment 1 Graham Perrin 2023-10-03 07:55:04 UTC
The example in comment 0 related to justification. 

In this example, lines within the synopsis are unexpectedly centred, but not accurately: 

<https://man-dev.freebsd.org/FreeBSD-13.1-RELEASE/bectl.8#SYNOPSIS>

This report is no longer specific to poudriere-related pages, so I'll remove bapt@ and bdrewery@ from the CC list; and I'll ping Kyle Evans (an FYI) in Discord.
Comment 3 Graham Perrin 2023-10-06 02:45:52 UTC
wosch@ please compare the screenshot at comment 2 with the screenshot that is to follow. 

I guess that this man-dev bug 274230 should be blocked by bug 273903, please confirm.
Comment 4 Graham Perrin 2023-10-06 02:49:41 UTC
Created attachment 245451 [details]
Screenshot of a less understandable layout

Compare this shot of <https://man-dev.freebsd.org/FreeBSD-ports-13.1-RELEASE-quarterly/pkg.8#SYNOPSIS> with the _historic_ shot at comment 2.
Comment 5 Wolfram Schneider freebsd_committer freebsd_triage 2023-10-12 05:20:32 UTC
(In reply to Graham Perrin from comment #3)

man-dev.freebsd.org use mandoc(1) for rendering, not groff. So this issues is not blocked by bug 273903