Jaka jest różnica między dokumentacją „człowiek” a „informacją”?


92

W odniesieniu do stron podręcznika i dokumentacji pomocy informacyjnej:

Dlaczego istnieją dwa takie podobne źródła dokumentacji?
Czasami strona podręcznika jest dostępna, a informacje nie; lub odwrotnie.
Nie trzymałem się jeszcze rymu i uzasadnienia.

Może istnieje między nimi znacząca różnica, ale nawet jeśli tak, to dlaczego oboje istnieją? Wydaje się, że niepotrzebne dublowanie.


1
GNU-Info Bad, Man (1) Dobry z 2003 zabawny czytać. Flat is better than nested.
n611x007

Spróbuj zrobić info infoi man info. man infopokazuje kolorowe przykłady. Jestem bardziej wizualną osobą, używanie tego samego koloru sprawia, że ​​jestem śpiący. Składnia człowieka z niewielkim kolorem sprawia, że ​​jest ona zrozumiała szybko.
randominstanceOfLivingThing

Odpowiedzi:


80

Strony podręcznika są tradycyjnym sposobem UNIX rozpowszechniania dokumentacji o programach. Sam termin „strona podręcznika” jest skrótem od „strony podręcznika”, ponieważ odpowiadają one stronom drukowanego podręcznika; „sekcje” stron podręcznika (1 dla poleceń, 2 dla wywołań systemowych itp.) odpowiadają sekcjom w pełnej instrukcji systemu UNIX. Wsparcie jest nadal dostępne, jeśli chcesz wydrukować stronę podręcznika na papierze, chociaż w dzisiejszych czasach jest to rzadko wykonywane, a sama liczba stron podręcznika sprawia, że ​​niemożliwe jest powiązanie ich wszystkich w jedną książkę.

Na początku lat 90. projekt GNU uznał, że system dokumentacji „man” jest przestarzały, i napisał polecenie info, aby go zastąpić: info ma podstawowe funkcje hiperłącza i prostszy język znaczników (w porównaniu do systemu „troff” używanego do strony podręcznika). Ponadto GNU odradza w ogóle używanie stron podręcznika i twierdzi, że złożone systemy oprogramowania powinny mieć pełną i kompleksową dokumentację, a nie tylko zestaw krótkich stron podręcznika.

W rzeczywistości używane są inne systemy dokumentacji, oprócz man i info : GNOME i KDE mają swój własny system oparty na HTML itp.

Ostatecznie forma otrzymania dokumentacji zależy przede wszystkim od wewnętrznych zasad projektu, które dostarczyły oprogramowanie - nie ma globalnie akceptowanego standardu.


14
infotak naprawdę nigdy nie wystartował, prawda?
UncleZeiv,

9
@UncleZeiv: uruchom infobez parametrów, aby dowiedzieć się, ile aplikacji korzysta z dokumentacji w formacie informacyjnym.
JanC

24

Info jest domyślnym formatem dokumentacji w projekcie GNU, man jest znacznie starszym tradycyjnym formatem dla UNIX.

Info używa Texinfo jako formatu źródłowego, który jest zbiorem makr dla TeXa, co znacznie ułatwia tworzenie „dobrze wyglądających” drukowanych wersji lub plików PDF.

Ogólnie strony podręcznika odnoszą się bardziej do 1 określonego tematu (polecenie, plik konfiguracyjny, funkcja systemowa, ...), podczas gdy informacje zwykle mają bardziej strukturę połączonego podręcznika, bardziej jak książkę.


14

man używa less do wyświetlenia strony podręcznika, która z kolei używa skrótów klawiszowych vim, podczas gdy info używa skrótów klawiszowych emacs i standardowych poleceń emacs do wyszukiwania, wychodzenia itp.


3
Kwestia skrótów klawiszowych jest interesująca (więc przejrzałem go) ... Wygląda na to, że infoma opcję skrótów VI: - vi-keys (Użyj klawiszy podobnych do vi i mniej podobnych ) ... $ alias info = 'info - vi-klucze ... może?
Peter.O,
Korzystając z naszej strony potwierdzasz, że przeczytałeś(-aś) i rozumiesz nasze zasady używania plików cookie i zasady ochrony prywatności.
Licensed under cc by-sa 3.0 with attribution required.