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

Revamp usage instructions #297

Merged
merged 2 commits into from
May 20, 2024

Conversation

Jayman2000
Copy link
Contributor

@Jayman2000 Jayman2000 commented May 6, 2024

Pull Request Type

  • GitHub Workflow changes
  • Documentation or Wiki changes
  • Build and Dependency changes
  • Runtime changes
    • Render changes
    • Audio changes
    • Input changes
    • Network changes
    • Other changes

Description

This commit revamps the usage instructions in order to accomplish two goals:

  1. Make the instructions easier to follow by turning them into a numbered list.
  2. Make sure that macOS and Linux users install all of the built libraries for their platforms.

In order to accomplish goal number 2, this PR makes it so that the online/ and netgames/ directories are automatically generated for macOS and Linux users.

Related Issues

Resolves #120. Fixes #369.

Checklist

  • I have tested my changes locally and verified that they work as intended.
  • I have documented any new or modified functionality.
  • I have reviewed the changes to ensure they do not introduce any unnecessary complexity or duplicate code.
  • I understand that by submitting this pull request, I am agreeing to license my contributions under the project's license.

Additional Comments

Here are some things that I wasn’t sure about:

  • One of the commits creates a new CMake target named NetgamesDir. I wasn’t sure if I should call it NetgamesDir or NetGamesDir. I went with NetgamesDir because the folder itself doesn’t do anything to separate the two words.
  • One of the commits adds text that tells users to copy “All .hog files, except for d3-linux.hog”. This is done to make sure that an old version of d3-linux.hog doesn’t get used. Is there a macOS equivalent of that file? The Steam version of Descent 3 for macOS uses d3-linux.hog. Does the GraphSim version of Descent 3 have something similar to d3-linux.hog?

Descent3/CMakeLists.txt Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
@Lgt2x Lgt2x self-requested a review May 6, 2024 21:54
Copy link
Collaborator

@Lgt2x Lgt2x left a comment

Choose a reason for hiding this comment

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

Way better instructions than dumping the executable in the game dir, thanks. I'll try the full procedure for Linux step by step to make sure we don't miss anything

@JeodC JeodC added the documentation Improvements or additions to documentation label May 8, 2024
@Jayman2000 Jayman2000 force-pushed the revamp-usage-instructions branch 2 times, most recently from 01eaf59 to f26732f Compare May 19, 2024 18:35
@pzychotic pzychotic mentioned this pull request May 20, 2024
13 tasks
Copy link
Collaborator

@JeodC JeodC left a comment

Choose a reason for hiding this comment

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

I spotted a few minor changes that could be made. I intend to merge this today.

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
Before this change, users would have to jump through hoops in order to
make sure that they’re using the .d3m files from this repo (as opposed
to the .d3m files that came with their version of Descent 3).
Specifically, users would have to remove or backup Descent 3’s original
netgames/ directory, create a new one, hunt down TCP_IP.d3c and copy it
to the new netgames/ directory.

This change makes it easier for users to use the latest version of
working by creating a netgames/ directory for them. All they have to do
is replace the old one with the new one.

Fixes DescentDevelopers#369.
This commit revamps the usage instructions in order to accomplish two
goals:

1. Make the instructions easier to follow by turning them into a
   numbered list.
2. Make sure that macOS and Linux users install all of the built
   libraries for their platforms.
@JeodC JeodC merged commit 23868a7 into DescentDevelopers:main May 20, 2024
10 checks passed
@Jayman2000 Jayman2000 deleted the revamp-usage-instructions branch May 20, 2024 19:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Runtime Issue]: Multiplayer through Direct TCP/IP failing to load module
3 participants