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

Add vcpkg installation instructions #116

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

NancyLi1013
Copy link

enet is available as a port in vcpkg, a C++ library manager that simplifies installation for enet and other project dependencies. Documenting the install process here will help users get started by providing a single set of commands to build enet, ready to be included in their projects.

We also test whether our library ports build in various configurations (dynamic, static) on various platforms (OSX, Linux, Windows: x86, x64) to keep a wide coverage for users.

I'm a maintainer for vcpkg, and here is what the port script looks like. We try to keep the library maintained as close as possible to the original library.

README Outdated
@@ -12,4 +12,17 @@ autoreconf -vfi

./configure && make && make install

Building enet -use vcpkg

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This feels like it should be a headline. The wording is also weird: -use vcpkg?
I also feel like this should be "Installing enet (vcpkg)" because it doesn't just build it - it also sort-of adds it to an index / central location.

README Outdated
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
vcpkg install enet

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The existing command line above is not indented. This file currently isn't real markdown.
I feel like it should be renamed to README.md and the other issues should be fixed first, OR, you should keep changes to plain text.

README Outdated
@@ -12,4 +12,17 @@ autoreconf -vfi

./configure && make && make install

Building enet -use vcpkg

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section should be clearly marked as alternative option. It currently feels like this is a mandatory step after (or part of) compiling and installing the library.

@Croydon
Copy link
Contributor

Croydon commented Feb 12, 2020

I feel like this should be a separate markdown file "How to Install ENet" or something like this.

Vcpkg is not the only way and when one gets promoted it is only natural that others want to get added to it too.

For example, personally, I would like to see instructions for installing it with Conan

@NancyLi1013
Copy link
Author

Hi JayFoxRox,

Thanks for your review and suggestion.
I updated the changes just now. Could you please help check them again?

Any suggestion is welcome.

Thanks again,
Nancy

@bjorn
Copy link

bjorn commented Feb 12, 2020

There doesn't seem to be anything special about installing Enet through vcpkg, so why it is even worth mentioning at all? Like @Croydon pointed out, when this is worth mentioning then we'd also want to mention how to install ENet on all the different Linux distributions, macOS, etc. But is it really worth it, given that those installation instructions are already documented more generally elsewhere?

I guess that for discoverability a plain list of links to various packages could be maintained, like:

(of course, the list would become rather long if we included Linux distributions...)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants