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

Installation issue feedback #1294

Open
0pcom opened this issue Nov 10, 2024 · 3 comments
Open

Installation issue feedback #1294

0pcom opened this issue Nov 10, 2024 · 3 comments
Labels
bug Something isn't working correctly

Comments

@0pcom
Copy link

0pcom commented Nov 10, 2024

Describe the bug

Two main points:

https://www.cogentcore.org/core/setup/install

The <code> </code> blocks are not directly highlight-able (with brave browser on amd64 linux) which makes it basically impossible to copy only the installation command itself for cogentcore.

The only easy way to do it to highlight the whole line and do ctrl + C ; paste into an editor, and then copy the command to the terminal. Or manually type the whole thing.

it would be preferable if the installation command (or generally code blocks) had the behavior of single click copy

Additionally, the setup documentation assumes that you have GOPATH set correctly and that your GOBIN was already added to your PATH ; but this should be made explicit and not just assumed as it might confuse people.

core setup may be easy enough to remember or run, but it actually did not work for me on archlinux with my specific hardware, to install all the correct dependencies (#1223).

I recommend that the cogentcore/core runtime dependencies (installed by core setup) be listed somewhere in the installation documentation - even if this information is not useful to most people.

If cogentcore was packaged and installed as a package by the package manager on linux, installing it's runtime dependencies should be handled by the package manager. And it's deps should be installed as dependencies of cogentcore and not explicitly.

However, I assume the exact dependencies vary based on the hardware & os ; and core setup is supposed to detect this. That might be challenging to handle by the package manager automatically. It might work best with different flavors (so to speak) of the package which are intended for specific hardware and which include the specific runtime deps used by cogentcore for that hardware.

Still, i suggest informing the user of the dependencies for different hardware and operating systems, even if this is on a different page of documentation from the setup installation page.

How to reproduce

  1. attempt to copy the installation command from here
    https://www.cogentcore.org/core/setup/install

  2. N/A

Example code

No response

Relevant output

No response

Platform

Web

@0pcom 0pcom added the bug Something isn't working correctly label Nov 10, 2024
@kkoreilly
Copy link
Member

Thank you for the feedback. We are aware of both of those issues and are working on fixing them. The first issue will be resolved by #1051, and we may restructure the install documentation in the meantime such that it is easier to copy. For the second point, I am currently working on #1292 to fix that after receiving similar feedback in #1275 and #1260. I will also add documentation regarding Vulkan on other distros such as Arch Linux as part of that.

@0pcom
Copy link
Author

0pcom commented Nov 11, 2024

Is it possible to statically compile core itself? If I'm not mistaken it uses CGO, so it should actually make it more distribute-able if i'm not mistaken.

Is it possible to create statically compiled (with musl) apps built with core? Non web-apps of course.

@kkoreilly
Copy link
Member

Are you asking about using Cogent Core as a static library / building static libraries with core? That might be theoretically possible, but I'm not sure that it would make sense relative to direct linking using Go. We are planning to improve cross-compiling support soon, but if there is any other reason using Cogent Core as a static library would be helpful, I can consider it.

@kkoreilly kkoreilly added this to Bugs Nov 18, 2024
@github-project-automation github-project-automation bot moved this to Todo in Bugs Nov 18, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working correctly
Projects
Status: Todo
Development

No branches or pull requests

2 participants