search

eza-community / eza

A modern alternative to ls
https://eza.rocks
European Union Public License 1.2
11.41k stars 205 forks source link

bug: Problems with man pages #981

Open j-xella opened 4 months ago

j-xella commented 4 months ago

Those are the ones I spotted right away, if there are more, please add in comments.

  1. There is no documentation for --absolute option
  2. Man pages contain $version string, which I think should be replaced with an actual eza version number
  3. in "SEE ALSO" section, man pages still point to markdown files, for example eza_colors.5.md . The .md suffix should be removed in man pages.
cafkafk commented 4 months ago

Thanks for noting these down, those should definitely be fixed :D

gierens commented 4 months ago

About the version thingy, I believe the problem is somewhere in the nix code because the Justfile which I'm using to generate the man pages for the deb packages seems to work.

tartley commented 4 months ago

The man page currently contains:

-w, --width=COLS : Set screen width in columns.

Valid options are none, absolute or relative. The default value is none

absolute mode highlights based on file modification time relative to the past year. relative mode highlights based on file modification time in relation to other files. none disables highlighting.

I don't think the 2nd and 3rd paragraphs are relevant to the 1st, and I don't think they make any sense (to me) on their own. Perhaps they are meant to occur elsewhere? Or did something get deleted from after the 1st para?