search

ZOSOpenTools / treeport

0 stars 1 forks source link

man pages #2

Open gngrossi opened 9 months ago

gngrossi commented 9 months ago

After installing the pax file and sourcing .env, MANPATH doesn't have the path for the man pages. I checked .env and didn't see the variable being set.

I manually added the path and man pages are available. export MANPATH=/hewitt/zopentools/guild/tree-master/man:$MANPATH

thanks

IgorTodorovskiIBM commented 9 months ago

This is because the man pages are not in the standard location, share/man, but rather in man/. I wonder if tree project has a knob to change this?

gngrossi commented 9 months ago

/hewitt/zopentools/guild/tree-master bash-5.2$ ls -l -rw-r--r-- 1 @02858 @ISCICS1 1251 Nov 17 09:50 README.md drwxr-xr-x 2 @02858 @ISCICS1 8192 Nov 17 09:50 bin -rwxr-xr-x 1 @02858 @ISCICS1 18 Nov 17 09:50 install_test.sh drwxr-xr-x 3 @02858 @ISCICS1 8192 Nov 17 09:50 man -rw-r--r-- 1 @02858 @ISCICS1 1306 Nov 17 09:50 metadata.json -rwxr-xr-x 1 @02858 @ISCICS1 125 Nov 17 09:50 setup.sh -rw-r--r-- 1 @02858 @ISCICS1 24 Nov 17 09:50 test.status

mfsysprog commented 9 months ago

Will have a look, it is in the Makefile

mfsysprog commented 9 months ago

The man page should be available now with the latest release. It also has the z/os specific options

gngrossi commented 9 months ago

pax file installed and man pages are available.

Using PuTTY, seeing some some non-displayable characters...is this my SSH client? thanks

image

mfsysprog commented 9 months ago

The issue is that your using a font in putty that doesn't properly display all characters. If you copy and paste in notepad for example you will see that it displays correctly. When I set the font under Window>Appearance to Consolas for example it all displays ok.

gngrossi commented 9 months ago

Here's are snippets for git and tree. Looks like a single dash (hyphen).

image

image

mfsysprog commented 9 months ago

Did you change your font in putty? That should fix your issue

gngrossi commented 9 months ago

I didn't make a change. The git man page displays fine as well as other tools. The man pages for tree aren't displaying similar. thanks

mfsysprog commented 9 months ago

That could be, but it is an issue caused by using a font that does not have all Unicode characters. It is a putty specific issue.

mfsysprog commented 9 months ago

And to fix it you should change your font in putty as I explained a couple of comments ago

gngrossi commented 9 months ago

I changed PuTTY to a few different fonts...no luck. Still using Lucinda Console, 10-point. I confirmed PuTTY is using character set UTF-8.

This looks to be the character sequence which should be a single dash. \342\200\220

Example, for -a image

I logged in to a RHEL 8.8 server…here’s the output...looks good. image

mfsysprog commented 9 months ago

Actually, man is generating a E28090 sequence, which is the Unicode character for a hyphen. I'm not sure why it is different on a Linux machine. Can you try the Consolas font, that seems to support it. I would have to look into the man code to see if I can explain it, but for now my only solution is that you change the font.

gngrossi commented 9 months ago

Using Consolas worked....much appreciated. I will leave the issue open until investigated further. thanks

mfsysprog commented 9 months ago

Issue seems to stem from groff, which will do the rendering of the page. In a manpage a - will be rendered by groff to a hyphen, while a \- will be rendered to a minus sign. However, since many man pages mistakenly used - where they actually should have used \- the issue has long been bypassed in groff, but some time ago this bypass was removed and this introduced this issue. In groff 1.23.0-3 the original bypass was put back again, so I guess that when groff is build with that release the issue should be solved. see https://bugs.archlinux.org/task/79094 Will see if I can build groffport locally to see if it will solve the issue