Bug 270335 - devel/ccache4: ccache(1) manual page representation issues
Summary: devel/ccache4: ccache(1) manual page representation issues
Status: Open
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Bryan Drewery
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-03-19 07:12 UTC by Graham Perrin
Modified: 2023-03-21 06:32 UTC (History)
1 user (show)

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


Attachments
man -P more 1 ccache (119.82 KB, image/png)
2023-03-19 07:12 UTC, Graham Perrin
no flags Details
man -P more 1 ccache in a different environment (210.80 KB, image/png)
2023-03-19 07:25 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 freebsd_committer freebsd_triage 2023-03-19 07:12:15 UTC
Created attachment 240968 [details]
man -P more 1 ccache

Upstream, maybe? 

At a glance, I can't find a match at <https://github.com/ccache/ccache/issues>. 

----

Issue 1: excessive underlining in parts of the page. 

Screenshot attached. 

----

root@mowa219-gjp4-8570p-freebsd:~ # pkg iinfo ccache4
ccache4-4.8
root@mowa219-gjp4-8570p-freebsd:~ # env
TERM=xterm-256color
BLOCKSIZE=K
MAIL=/var/mail/root
MM_CHARSET=UTF-8
LANG=C.UTF-8
PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin:/root/bin
SHELL=/bin/csh
HOME=/root
USER=root
HOSTTYPE=FreeBSD
VENDOR=amd
OSTYPE=FreeBSD
MACHTYPE=x86_64
SHLVL=1
PWD=/root
LOGNAME=root
GROUP=wheel
HOST=mowa219-gjp4-8570p-freebsd
CCACHE_PATH=/usr/bin:/usr/local/bin
CCACHE_DIR=/usr/.ccache
EDITOR=/usr/local/bin/nano
VISUAL=/usr/local/bin/nano
PAGER=less
root@mowa219-gjp4-8570p-freebsd:~ # uname -aKU
FreeBSD mowa219-gjp4-8570p-freebsd 14.0-CURRENT FreeBSD 14.0-CURRENT #35 main-n261613-2b4b3789f877: Sun Mar 19 04:09:06 GMT 2023     grahamperrin@mowa219-gjp4-8570p-freebsd:/usr/obj/usr/src/amd64.amd64/sys/GENERIC-NODEBUG amd64 1400083 1400083
root@mowa219-gjp4-8570p-freebsd:~ #
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2023-03-19 07:25:20 UTC
Created attachment 240970 [details]
man -P more 1 ccache in a different environment

Issue 2: ESC visible in various places.

Screenshot attached. The same command in a different environment on the same computer. 

I'm fairly certain that I have seen this symptom long ago, with a different manual page, but I can't recall the explanation. 

----

% env
BLOCKSIZE=M
CCACHE_DIR=/usr/.ccache
CCACHE_PATH=/usr/bin:/usr/local/bin
COLORFGBG=15;0
COLORTERM=truecolor
DBUS_SESSION_BUS_ADDRESS=unix:path=/tmp/dbus-curDpGu7Gc,guid=d1056e5a02f8ef149dcb00266416a517
DESKTOP_SESSION=/usr/local/share/xsessions/plasma
DISPLAY=:0
EDITOR=/usr/local/bin/nano
GROUP=grahamperrin
GTK2_RC_FILES=/etc/gtk-2.0/gtkrc:/home/grahamperrin/.gtkrc-2.0:/home/grahamperrin/.config/gtkrc-2.0
GTK3_MODULES=xapp-gtk3-module
GTK_IM_MODULE=ibus
GTK_RC_FILES=/etc/gtk/gtkrc:/home/grahamperrin/.gtkrc:/home/grahamperrin/.config/gtkrc
HOME=/home/grahamperrin
HOST=mowa219-gjp4-8570p-freebsd
HOSTTYPE=FreeBSD
JAVA_HOME=/usr/local/openjdk16/bin/java
KDE_APPLICATIONS_AS_SCOPE=1
KDE_FULL_SESSION=true
KDE_SESSION_UID=1002
KDE_SESSION_VERSION=5
KONSOLE_DBUS_SERVICE=:1.72
KONSOLE_DBUS_SESSION=/Sessions/6
KONSOLE_DBUS_WINDOW=/Windows/1
KONSOLE_VERSION=221203
LANG=en_GB.UTF-8
LANGUAGE=
LOGNAME=grahamperrin
MACHTYPE=x86_64
MAIL=/var/mail/grahamperrin
MANCOLOR=1
MANWIDTH=tty
MM_CHARSET=UTF-8
OSTYPE=FreeBSD
PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin:/home/grahamperrin/bin:/home/grahamperrin/.local/bin
PROFILEHOME=
PWD=/home/grahamperrin
QT_AUTO_SCREEN_SCALE_FACTOR=0
QT_IM_MODULE=ibus
QT_SCREEN_SCALE_FACTORS=LVDS-1=1;DP-1=1;DP-2=1;DP-3=1;VGA-1=1;
SESSION_MANAGER=local/mowa219-gjp4-8570p-freebsd:/tmp/.ICE-unix/53549
SHELL=/bin/tcsh
SHELL_SESSION_ID=bf9bb5583fe442d6aca73ed5e0c6b6a1
SHLVL=1
TERM=xterm-256color
USER=grahamperrin
VENDOR=amd
VISUAL=/usr/local/bin/nano
WINDOWID=50331655
XAUTHORITY=/home/grahamperrin/.Xauthority
XCURSOR_PATH=/usr/local/share/icons::~/.icons:/usr/share/icons:/usr/share/pixmaps:/usr/X11R6/lib/X11/icons
XCURSOR_SIZE=32
XCURSOR_THEME=breeze_cursors
XDG_CONFIG_DIRS=/home/grahamperrin/.config/kdedefaults:/usr/local/etc/xdg:/etc/xdg:/usr/local/etc/xdg
XDG_CURRENT_DESKTOP=KDE
XDG_RUNTIME_DIR=/var/run/user/1002
XDG_SEAT=seat0
XDG_SEAT_PATH=/org/freedesktop/DisplayManager/Seat0
XDG_SESSION_CLASS=user
XDG_SESSION_COOKIE=mowa219-gjp4-8570p-freebsd-1679205654.522952-1145897072
XDG_SESSION_DESKTOP=KDE
XDG_SESSION_PATH=/org/freedesktop/DisplayManager/Session0
XDG_SESSION_TYPE=x11
XDG_VTNR=9
XIM=ibus
XIM_ARGS=--daemonize --xim
XIM_PROGRAM=ibus-daemon
XMODIFIERS=@im=ibus
%
Comment 2 Oleg Sidorkin 2023-03-19 20:08:52 UTC
man page is built with asciidoctor and then edited with perl script (here:
https://github.com/ccache/ccache/blob/master/doc/CMakeLists.txt#L44 )
Comment 3 Oleg Sidorkin 2023-03-20 09:59:05 UTC
(In reply to Oleg Sidorkin from comment #2)
I've checked manpage building on linux and it has the same underlining issue. And .tmp file before perl processing also has it. So I think the bug is somewhere in asciidoctor. This: https://github.com/asciidoctor/asciidoctor/issues/4401 looks the most relevant
Comment 4 Graham Perrin freebsd_committer freebsd_triage 2023-03-21 06:32:40 UTC
(In reply to Graham Perrin from comment #1)

In this environment, the ESC effect: 

* does occur with        man -P more 1 ccache

* does not occur with    man 1 ccache