Was ist [1] in der GIT-Dokumentation?

Question

Ich fange gerade an, GIT zu lernen, und die Syntax der Dokumentation ist verwirrend. Was bedeutet [1] in Anwendungsfällen wie „git-add[1]“ oder „git-commit[1]“?

Es steht überall in der Dokumentation. Auf manchen Webseiten erscheint es in Klammern – „git-init(1)“

Was stellt es dar?

Answer 1

Es ist die Abschnittsnummer des Handbuchs. Diese Konvention ist allgemein und nicht auf Git beschränkt. Sieheman 1 man:

[…] Ein Abschnitt, sofern vorhanden, weist darauf hin, mannur in diesem Abschnitt des Handbuchs zu suchen. Die Standardaktion besteht darin, in allen verfügbaren Abschnitten in einer vordefinierten Reihenfolge zu suchen und nur die erste gefundene Seite anzuzeigen, selbst wenn die Seite in mehreren Abschnitten vorhanden ist.

In der folgenden Tabelle sind die Abschnittsnummern des Handbuchs gefolgt von den darin enthaltenen Seitentypen aufgeführt.

1. Ausführbare Programme oder Shell-Befehle
2. Systemaufrufe (vom Kernel bereitgestellte Funktionen)
3. Bibliotheksaufrufe (Funktionen innerhalb von Programmbibliotheken)
4. Spezielle Dateien (normalerweise zu finden in /dev)
5. Dateiformate und Konventionen zB/etc/passwd
6. Spiele
7. Verschiedenes (einschließlich Makropakete und Konventionen), zB man(7),groff(7)
8. Systemadministrationsbefehle (normalerweise nur für Root)
9. Kernelroutinen [Nicht standardmäßig]

Der Befehl zum Anzeigen des Handbuchs git-init(1)lautet daher man 1 git-init. In diesem Fall man git-initfunktioniert einfach, aber manchmal müssen Sie die gewünschte Abschnittsnummer explizit angeben. Beispielsweise gibt es man(1)und man(7); man manzeigt Ihnen Ersteres, um Letzteres anzuzeigen, benötigen Sie man 7 man.