Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

manpage downloads 404 #1036

Closed
CouldBeThis opened this issue Feb 25, 2022 · 4 comments
Closed

manpage downloads 404 #1036

CouldBeThis opened this issue Feb 25, 2022 · 4 comments
Assignees
Labels
community › website exa’s public face

Comments

@CouldBeThis
Copy link

On the linux and mac install pages, all the links to manpages and shell completion are 404.

I see the manpages are located here as .md only: https://github.com/ogham/exa/tree/master/man

It would be really nice to have a copy/paste install line for these if that's possible for the lazy. :) I also noticed that I already have a manpage at exa(4) so if there is some special way to call the page for this exa given a conflict that would be something to mention. If it'll default to (1) then that's good for me.

I was looking around for the manpage but all I could find is the same as is obtained by exa --help.

Whenever the manpages are found, I'd like to submit them to https://github.com/jacksonp/ManKier-extra because mankier is the nicest formatted manpage website. :)

@ariasuni
Copy link
Collaborator

On the linux and mac install pages, all the links to manpages and shell completion are 404.

We already have an issue for this, see #757. They are in the downloads, e.g. https://github.com/ogham/exa/releases/download/v0.10.1/exa-accoutrements-v0.10.1.zip.

I see the manpages are located here as .md only: https://github.com/ogham/exa/tree/master/man

They are generated by pandoc from these files, see here:

exa/Justfile

Lines 99 to 102 in 42659f9

@man:
mkdir -p "${CARGO_TARGET_DIR:-target}/man"
pandoc --standalone -f markdown -t man man/exa.1.md > "${CARGO_TARGET_DIR:-target}/man/exa.1"
pandoc --standalone -f markdown -t man man/exa_colors.5.md > "${CARGO_TARGET_DIR:-target}/man/exa_colors.5"

I also noticed that I already have a manpage at exa(4) so if there is some special way to call the page for this exa given a conflict that would be something to mention. If it'll default to (1) then that's good for me.

Didn’t know about exa acceleration architecture, but I’m not sure if it’s used or even in development anymore. If you want to access exa(1), just use man 1 exa.

Whenever the manpages are found, I'd like to submit them to https://github.com/jacksonp/ManKier-extra because mankier is the nicest formatted manpage website. :)

I guess that could be nice, but I’m not sure what the policy is regarding package version. We have people use different versions of exa, especially because of Ubuntu and Debian providing an older version of exa. At least we already have it, for the version available in Arch Linux, anyway: https://man.archlinux.org/man/community/exa/exa.1.en

@CouldBeThis
Copy link
Author

thanks @ariasuni I didn't find that issue when I searched. and thanks for the other useful info.

Is fixing it just a matter of nobody having the time? because I can make a PR based on the above. I can't locate a repo, branch or anything for the website though so perhaps it is not possible.

@ariasuni ariasuni added the community › website exa’s public face label Mar 17, 2022
@ariasuni
Copy link
Collaborator

There’s no repository, the original author @ogham is managing the website but he has been unresponsive for a few months, and didn’t answer to my last e-mail. I guess at some point I’ll fork the repo and create a new website, but with my day job, I don’t have that much time to dedicate to exa, I already struggle a lot with reviewing and merge PRs.

@ariasuni
Copy link
Collaborator

ariasuni commented Sep 6, 2023

Closed in favor of #757

exa is unmaintained, use the active fork eza instead (see #1243).

@ariasuni ariasuni closed this as completed Sep 6, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
community › website exa’s public face
Projects
None yet
Development

No branches or pull requests

3 participants