-
Notifications
You must be signed in to change notification settings - Fork 25
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
fix README.TXT #177
base: master
Are you sure you want to change the base?
fix README.TXT #177
Conversation
Did you want to add (1) and (2) to the readme as well? Also, it's not clear why we need to compile readline from source here, I thought we were just recommending to use a preinstalled binary, in which case |
(1) Adding a known issues / best practices paragraph makes sense if it is not just me who spent extra time to find the final solution- This PR fixes just errors in README.TXT. The rest is for information only |
The readme is for people trying to set it up, so it makes sense that if you had trouble following the directions then you should add enough information so that the next person won't. I think it is a good idea to mention required prerequisite debian packages in the readme. |
This is a can of worms. Debian packages are only available on Debian installations. The autoconf process addresses a wider range of OS including main frames and exotic Linux variants, and of all machines only Intel processor types seem to need the gcc extension. This is just the beginning. |
I'd say let's be as complete as possible and add the instructions for Debian, marked as such. |
For Debian users the easiest way to get metamath-exe is to follow one of the gcc commands listed in README.TXT. The 'alternative approach' with autoreconf is for those having no gcc available or installed. Then the configure script might find a solution. But you MUST not enter the src folder for this. The instruction in README.TXT is faulty. |
I agree that we shouldn't let perfect be the enemy of the good. I am not suggesting that you or anyone else overhauls the README, although I wouldn't be opposed to that, only that we write down all the information that we have confirmed through user reports. No one has every OS and linux distro installed, so install instructions are necessarily crowd-sourced to some extent. Let's just put in all the information we learned from your experience, and if someone else has a bad experience on another distro we'll add that too, later. |
I updated the PR. |
@tirix Nice bonmot, by the way ! |
After recovering from my accident, and buying a replacement for my broken notebook, I started installing Metamath on it. One need is to have a metamath exe available, and I compiled it from scratch.
I use an Linux/Ubuntu OS, and not everything went according to plan. Besides the corrections in this PR, I stumbled over following issues:
sudo apt-get install gcc-multilib
sudo apt-get install libreadline-dev
sudo apt-get install libncurses5-dev libncursesw5-dev