Unhelpful manual page(s)

Abierto Apto para principiantes
#16,165 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
Medio día
Aptitud para principiantes
62/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
rust

Línea de trabajo

La carga útil apunta a la página del manual de chmod y a su línea de sintaxis MODE, que es inexacta. Empieza por localizar dónde se definen en el repositorio los textos de ayuda y de man de chmod, y compáralos con la página de GNU chmod que cita el issue. Está terminado cuando la sintaxis de MODE se explique correcta y claramente, se haya eliminado el patrón incorrecto y se conserven los ejemplos; verifica el resultado con la salida de ayuda o de man de chmod.

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

Descripción

The manual pages are less helpful than the GNU counterparts.

For example, the chmod manual page explains virtually nothing at all, apart from some examples.

The only explanation of the syntax is:

Each MODE is of the form [ugoa]*([-+=]([rwxXst]*|[ugo]))+|[-+=]?[0-7]+.

which is, as stated, not helpful as an explanation and on top of that, wrong (it would mean that chmod 0473216572 foo is a valid way to call chmod).

Having good documentation with the code is an important part of UNIX, please do not ditch that while replacing core utilities!

Lenguaje dominante
Rust
Estrellas
24.3k
Forks
2.1k
Merge medio
2 d 7 h
PR fusionados (30 d)
397

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

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.

Más de uutils/coreutils

Todos los issues de uutils/coreutils

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.