Apa perbedaan antara dokumentasi “man” dan “info”?


92

Mengenai dokumentasi manual dan info bantuan:

Mengapa ada dua sumber dokumentasi yang serupa?
Kadang-kadang halaman manual tersedia dan info tidak; atau sebaliknya.
Saya belum menempel pada sajak dan alasan di baliknya.

Mungkin ada perbedaan yang signifikan di antara mereka, tetapi bahkan jika ada, mengapa mereka berdua ada? Sepertinya tidak perlu menggandakan.


1
GNU-Info Bad, Man (1) Bagus dari tahun 2003 lucu dibaca. Flat is better than nested.
n611x007

Coba lakukan info infodan man info. man infomenunjukkan contoh warna-warni. Saya orang yang lebih visual, menggunakan warna yang sama membuat saya mengantuk. Sintaks pria dengan sedikit warna membuatnya dimengerti dengan cepat.
randominstanceOfLivingThing

Jawaban:


80

Halaman manual adalah cara tradisional UNIX dalam mendistribusikan dokumentasi tentang program. Istilah "halaman manual" sendiri adalah kependekan dari "halaman manual", karena mereka sesuai dengan halaman-halaman manual yang dicetak; halaman manual "bagian" (1 untuk perintah, 2 untuk panggilan sistem, dll.) sesuai dengan bagian dalam manual UNIX lengkap. Dukungan masih ada jika Anda ingin mencetak halaman manual ke kertas, meskipun ini jarang dilakukan hari ini, dan banyaknya halaman manual membuatnya tidak mungkin untuk mengikat mereka semua menjadi satu buku.

Pada awal 90-an, proyek GNU memutuskan bahwa sistem dokumentasi "man" sudah ketinggalan zaman, dan menulis perintah info untuk menggantikannya: info memiliki fitur hyperlink dasar dan bahasa markup yang lebih sederhana untuk digunakan (dibandingkan dengan sistem "troff" yang digunakan untuk halaman manual). Selain itu, GNU mendukung penggunaan halaman manual sama sekali dan berpendapat bahwa sistem perangkat lunak yang kompleks harus memiliki dokumentasi yang lengkap dan komprehensif daripada hanya satu set halaman manual pendek.

Sebenarnya ada sistem dokumentasi lain yang digunakan, selain manusia dan info : GNOME dan KDE memiliki sistem mereka sendiri, berbasis HTML, dll.

Pada akhirnya, bentuk di mana Anda mendapatkan dokumentasi tergantung pada kebijakan internal proyek yang menyediakan perangkat lunak di tempat pertama - tidak ada standar yang diterima secara global.


14
infotidak pernah benar-benar lepas landas, bukan?
UncleZeiv

9
@UncleZeiv: jalankan infotanpa parameter untuk mendapatkan gambaran tentang berapa banyak aplikasi yang menggunakan dokumentasi format-info.
JanC

24

Info adalah format default untuk dokumentasi di dalam proyek GNU, man adalah format tradisional yang jauh lebih tua untuk UNIX.

Info menggunakan Texinfo sebagai format sumbernya, yang merupakan kumpulan makro untuk TeX, dan itu membuatnya lebih mudah untuk juga membuat versi cetak atau PDF yang "tampan".

Secara umum, halaman manual adalah lebih dari 1 topik spesifik (perintah, file konfigurasi, fungsi sistem, ...) sementara info biasanya memiliki lebih banyak struktur manual gabungan, lebih seperti buku.


14

man menggunakan lebih sedikit untuk menampilkan halaman manual yang pada gilirannya menggunakan vim keybindings sementara info menggunakan emacs keybindings dan perintah standar emacs untuk pencarian, berhenti, dll.


3
Keybindings masalah adalah menarik (jadi saya googled) ... Tampaknya infomemiliki VI keybindings pilihan: --vi-kunci (Gunakan vi-seperti dan kurang seperti key binding) ... info $ alias = info - vi-keys '... mungkin?
Peter.O
Dengan menggunakan situs kami, Anda mengakui telah membaca dan memahami Kebijakan Cookie dan Kebijakan Privasi kami.
Licensed under cc by-sa 3.0 with attribution required.