Crystal github release page, what is the downloadable bundled assets name stand for?

What i mean is, our crystal release page.

As we can see, we have following several assets can download.

crystal-1.4.1-1-darwin-universal.tar.gz 44 MB Apr 23, 2022
crystal-1.4.1-1-linux-x86_64-bundled.tar.gz 28.6 MB Apr 23, 2022
crystal-1.4.1-1-linux-x86_64.tar.gz 28.3 MB Apr 23, 2022
crystal-1.4.1-1.universal.pkg 44 MB Apr 23, 2022
crystal-1.4.1-docs.tar.gz 12.2 MB Apr 23, 2022

First, i guess darwin-universal.tar.gz is for macOS, that okay.

But, others is not so clear.

  1. What is the different linux-x86_64-bundled with linux-x86_64.tar.gz ?
  2. What crystal-1.4.1-1.universal.pkg stand for?
  3. How to use crystal-1.4.1-docs.tar.gz?
  4. What is the unsupported means of windows-x86_64-msvc-unsupported?

Is anywhere documet for this? maybe, we can use more long, more reasonable name instead document.

In fact, the only i used binary since today is linux-x86_64.tar.gz , i know it is alpine static compiled X86_64 linux binary, and until today, i compile from source, i know i can compile dynamic linked REPL enabled Crystal use glibc, from my laptop (arch linux).

Crystal seem like no tools like rustup in rust, which can be used install/upgrade rust and toolchains with only one line, so, i consider we should offer more details github download info, And, more details compile guide to distro package manager in document, for those packager, e.g. when i try to install crystal use offcial package manger(pacman), this crystal is dynamic compiled, but not enable REPL by default, this give user a signal, REPL feature is still not useable, which maybe hurt crystal, make people leave.


-bundled includes static versions of libevent and pcre libraries.

 ā”œā”€ā”€ bin
 ā”‚   ā”œā”€ā”€ crystal
 ā”‚   ā””ā”€ā”€ shards
 ā”œā”€ā”€ lib
 ā”‚   ā””ā”€ā”€ crystal
 ā”‚       ā”œā”€ā”€ bin -> ../../bin
-ā”‚       ā”œā”€ā”€ lib -> ..
+ā”‚       ā”œā”€ā”€ lib
+ā”‚       ā”‚   ā”œā”€ā”€ libevent.a
+ā”‚       ā”‚   ā”œā”€ā”€ libevent_pthreads.a
+ā”‚       ā”‚   ā””ā”€ā”€ libpcre.a
 ā”‚       ā””ā”€ā”€ libgc.a
 ā””ā”€ā”€ share
     ā”œā”€ā”€ bash-completion
@@ -1545,4 +1548,4 @@
         ā””ā”€ā”€ site-functions
             ā””ā”€ā”€ _crystal
-217 directories, 1328 files
+217 directories, 1331 files

Most of the time universal refers to Darwin too, so perhaps a package naming issue and should be -darwin-universal.pkg

Extract and then open index.html to get the same experience as the online docs found here: Crystal 1.4.1

I think because the package for that platform is not officially supported by the team (yet).

Hope that helps.