Was ist der Unterschied zwischen der Dokumentation "Mann" und "Info"?

92

In Bezug auf Man-Pages und Info-Hilfedokumentation:

Warum gibt es zwei ähnliche Dokumentationsquellen?
Manchmal ist eine Manpage verfügbar und die Info nicht; oder umgekehrt.
Ich habe mich noch nicht an den Reim und die Vernunft dahinter gehalten.

Vielleicht gibt es einen signifikanten Unterschied zwischen ihnen, aber selbst wenn, warum existieren sie beide? Es scheint unnötig, sich zu verdoppeln.

Peter.O
quelle
1
GNU-Info Bad, Man (1) Gut aus 2003 witzig gelesen. Flat is better than nested.
n611x007
Versuchen Sie es info infound man info. man infozeigt farbenfrohe Beispiele. Ich bin mehr visuelle Person, mit der gleichen Farbe über macht mich schläfrig. Die Man-Syntax mit ein wenig Farbe macht es schnell verständlich.
randominstanceOfLivingThing

Antworten:

80

Manpages sind die traditionelle UNIX-Methode zum Verteilen von Dokumentation zu Programmen. Der Begriff "Manpage" selbst ist die Abkürzung für "Manualpage", da sie den Seiten des gedruckten Manuals entspricht. Die Man Pages "Abschnitte" (1 für Befehle, 2 für Systemaufrufe usw.) entsprechen den Abschnitten im vollständigen UNIX-Handbuch. Es gibt immer noch Unterstützung, wenn Sie eine Manpage auf Papier drucken möchten, obwohl dies heutzutage nur noch selten der Fall ist. Die schiere Anzahl der Manpages macht es einfach unmöglich, alle zu einem einzigen Buch zusammenzufassen.

In den frühen 90er Jahren entschied das GNU-Projekt , dass das Dokumentationssystem "man" veraltet ist, und schrieb den Befehl info , um es zu ersetzen: info verfügt über grundlegende Hyperlinking-Funktionen und eine einfachere Auszeichnungssprache (im Vergleich zum für "troff" verwendeten System) Manpages). Darüber hinaus plädiert GNU dafür, überhaupt keine Manpages zu verwenden, und ist der Ansicht, dass komplexe Softwaresysteme eine vollständige und umfassende Dokumentation haben sollten und nicht nur eine Reihe kurzer Manpages.

Neben man und info gibt es noch andere Dokumentationssysteme : GNOME und KDE haben ein eigenes, HTML-basiertes System usw.

Letztendlich hängt die Form, in der Sie Dokumentation erhalten, von den internen Richtlinien des Projekts ab, in dem die Software bereitgestellt wurde - es gibt keinen global akzeptierten Standard.

Riccardo Murri
quelle
14
infoist nie wirklich gestartet, oder?
UncleZeiv
9
@UncleZeiv: infoOhne Parameter ausführen , um eine Vorstellung davon zu erhalten, wie viele Anwendungen die Dokumentation im Info-Format verwenden.
26.
24

Info ist das Standardformat für die Dokumentation innerhalb des GNU-Projekts, man ist das viel ältere traditionelle Format für UNIX.

Info verwendet Texinfo als Quellformat, das eine Reihe von Makros für TeX darstellt. Dadurch ist es viel einfacher, auch "gut aussehende" gedruckte Versionen oder PDFs zu erstellen.

In der Regel handelt es sich bei Manpages eher um ein bestimmtes Thema (einen Befehl, eine Konfigurationsdatei, eine Systemfunktion usw.), während info normalerweise eher die Struktur eines kombinierten Handbuchs als eine Art Buch aufweist.

JanC
quelle
14

man verwendet weniger, um die man-Seite anzuzeigen, die wiederum vim-Tastenkombinationen verwendet, während info emacs-Tastenkombinationen und Standard-emacs-Befehle zum Suchen, Beenden usw. verwendet.


quelle
3
Das Problem mit den Tastenkombinationen ist interessant (also habe ich gegoogelt) ... Es scheint, dass infoes eine VI-Tastenkombination gibt: --vi-keys (Verwenden Sie vi-ähnliche und weniger-ähnliche Tastenkombinationen) ... $ alias info = 'info - vi-keys '... vielleicht?
Peter.O