☰

¿Qué es [1] en la documentación GIT?

tag-icon • tag-icon git documentation
¿Qué es [1] en la documentación GIT?

Estoy empezando a aprender GIT y la sintaxis de la documentación es confusa. ¿Qué significa [1] en casos de uso como "git-add[1]" o "git-commit[1]"?

Está por toda la documentación. En algunas páginas del sitio web aparece entre paréntesis: "git-init(1)"

¿Que representa?

Respuesta1

Es el número de sección del manual. Esta convención es general y no se limita a Git. Verman 1 man:

[…] Una sección, si se proporciona, le indicará manque busque solo en esa sección del manual. La acción predeterminada es buscar en todas las secciones disponibles, siguiendo un orden predefinido y mostrar solo la primera página encontrada, incluso si la página existe en varias secciones.

La siguiente tabla muestra los números de sección del manual seguidos de los tipos de páginas que contienen.

  1. Programas ejecutables o comandos de shell
  2. Llamadas al sistema (funciones proporcionadas por el kernel)
  3. Llamadas a bibliotecas (funciones dentro de bibliotecas de programas)
  4. Archivos especiales (normalmente se encuentran en /dev)
  5. Formatos de archivos y convenciones, por ejemplo./etc/passwd
  6. Juegos
  7. Varios (incluidos paquetes de macros y convenciones), por ejemplo man(7),groff(7)
  8. Comandos de administración del sistema (generalmente solo para root)
  9. Rutinas del kernel [no estándar]

Por lo tanto , el comando para ver el manual git-init(1)es man 1 git-init. En este caso, lo simple man git-initfunciona, pero a veces es necesario especificar explícitamente el número de sección que busca. Por ejemplo, hay man(1)y man(7); man manle mostrará el primero, para ver el segundo necesita man 7 man.

información relacionada