Installation of cargo-generate on Ubuntu fails owing to missing OS packages

[rod-chapman]

I am trying to follow the installation instructions in section 1.4 on a stock Ubuntu Beaver installation.

The "cargo install cargo-generate" command fails owing to missing OS packages "libssl-dev" and "pkg-config".

I had to do "sudo apt install libssl-dev pkg-config" before it would work, so this should probably be mentioned in section 1.4 somewhere.

[eldruin]

Good catch. Could you open a PR adding this information?

[rod-chapman]

I'm not sure... Section 1.4 is supposed to be OS independent, with Linux-specific stuff following in section 1.4.1, so perhaps these sections need to be re-ordered a bit? I'm not confident enough to make such a change. Who has editorial/review control over this section?

[eldruin]

Yeah I understand. You can just put it as a small note right in section 1.4. Something similar to:

We'll use this later to generate a project from a template.

cargo install cargo-generate

Note: on Linux (e.g. on Ubuntu) you may need to install the packages `libssl-dev` and `pkg-config` prior to installing cargo-generate

I think having the instructions for Ubuntu is enough since it represents a majority of users AFAIK and anybody knowledgeable-enough to choose Arch or Fedora instead will probably have no problem in finding the equivalent packages and installing them.

[rod-chapman]

Do I need to fork this repo first, then propose a PR from there?

[eldruin]

Yes

[rod-chapman]

OK.. I will give it a go...

[rod-chapman]

OK... PR#304 open. Can your review and merge?