nushell / nushell/nushell.github.io

Status of dependencies unclear

Abierto
#823 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
TypeScript
Estrellas
258
Forks
561
Merge medio
3 h 20 min
PR fusionados (30 d)
15

Descripción

I think the dependencies section of the docs needs some help. Somebody recently pointed out that "libx11 is no longer required" with a link to some commit where it was dropped, but the docs are not clear on this subject.

https://github.com/nushell/nushell.github.io/blob/343ee0ad909630ca1cf87dc20a24f8fc75b21d9e/book/installation.md?plain=1#L51-L69

This section leaves me (as a distro packager for Arch Linuk) with more questions than answers. Why are X11 and XCB libs required on RedHat based distros but not Debian based? Is pkg-config a run time dependency or a build time dependencies? Why does some packaging list curl and bzip2 as dependencies, were these once dependencies now removed, or just undocumented, or just packaging mistakes? Why does macOS need cmake but not other platforms? Experimentally nushell seems to build without XCB or X11 libs, and searching the code base suggests nothing about XCB is used any more.

Can somebody that actually knows clarify what is actually needed at build & run times now and document these as generic dependencies, then comment in the per-distro sections on why those lists vary (e.g. perhaps one was assuming Ubuntu has X11 installed, something that may be true for most workstations but not necessarily servers).

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Comienza con book/installation.md alrededor de las líneas 51-69 e inspecciona el commit referenciado. Compara las listas de dependencias documentadas por distribución y para macOS, distinguiendo entre los requisitos de compilación y de ejecución, y comprueba las preguntas del issue sobre X11, XCB, pkg-config, curl, bzip2 y cmake. Se considerará terminado cuando la documentación de las dependencias genéricas y específicas de cada plataforma explique claramente las diferencias.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
cmake, linux, macos
Área
build-system, documentation
Tipo de issue
Documentación
Dificultad
4/5
Tiempo estimado
3-5 días
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
35/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.