Sự khác biệt giữa tài liệu của người đàn ông và người khác là gì?

92

Về trang hướng dẫn và tài liệu trợ giúp thông tin:

Tại sao hai nguồn tài liệu tương tự như vậy tồn tại?
Đôi khi một trang man có sẵn và thông tin thì không; hoặc ngược lại.
Tôi chưa nắm bắt được vần điệu và lý do đằng sau nó.

Có thể có một sự khác biệt đáng kể giữa chúng, nhưng ngay cả khi có, tại sao cả hai đều tồn tại? Có vẻ như không cần thiết tăng gấp đôi.

documentation info manpage

— Peter.O
nguồn

1

GNU-Info Bad, Man (1) Tốt từ năm 2003 vui đọc. Flat is better than nested.

— n611x007

Hãy thử làm info infovà man info. man infocho thấy các ví dụ đầy màu sắc. Tôi là người trực quan hơn, sử dụng cùng màu khiến tôi buồn ngủ. Cú pháp người đàn ông với một chút màu sắc làm cho nó dễ hiểu một cách nhanh chóng.

— randominstanceOfLivingT Breath 17/12/17

80

Các trang man là cách truyền thống UNIX để phân phối tài liệu về các chương trình. Bản thân thuật ngữ "trang man" là viết tắt của "trang thủ công", vì chúng tương ứng với các trang của hướng dẫn in; các trang man "phần" (1 cho các lệnh, 2 cho các cuộc gọi hệ thống, v.v.) tương ứng với các phần trong hướng dẫn UNIX đầy đủ. Hỗ trợ vẫn còn đó nếu bạn muốn in một trang man ra giấy, mặc dù điều này hiếm khi được thực hiện trong những ngày này, và số lượng trang man tuyệt đối khiến bạn không thể liên kết tất cả chúng vào một cuốn sách.

Đầu những năm 90, dự án GNU đã quyết định rằng hệ thống tài liệu "con người" đã lỗi thời và đã viết lệnh thông tin để thay thế nó: thông tin có các tính năng siêu liên kết cơ bản và sử dụng ngôn ngữ đánh dấu đơn giản hơn (so với hệ thống "troff" được sử dụng cho trang người đàn ông). Ngoài ra, GNU chủ trương chống lại việc sử dụng các trang man và cho rằng các hệ thống phần mềm phức tạp nên có tài liệu đầy đủ và toàn diện thay vì chỉ một tập hợp các trang man ngắn.

Thực tế, có những hệ thống tài liệu khác đang được sử dụng, bên cạnh con người và thông tin : Gnome và KDE có hệ thống dựa trên HTML, v.v.

Cuối cùng, hình thức mà bạn nhận được tài liệu phụ thuộc vào các chính sách nội bộ của dự án đã cung cấp phần mềm ở nơi đầu tiên - không có tiêu chuẩn được chấp nhận trên toàn cầu.

— Riccardo Murri
nguồn

14

infokhông bao giờ thực sự cất cánh, phải không?

— ChúZeiv

9

@UncleZeiv: chạy infokhông có tham số để có ý tưởng về số lượng ứng dụng sử dụng tài liệu định dạng thông tin.

— JanC

24

Thông tin là định dạng mặc định cho tài liệu bên trong dự án GNU, con người là định dạng truyền thống cũ hơn nhiều cho UNIX.

Thông tin sử dụng Texinfo làm định dạng nguồn của nó, đó là một loạt các macro cho TeX và điều đó giúp dễ dàng hơn trong việc tạo các phiên bản in hoặc tệp PDF "đẹp mắt".

Nói chung, các trang web có nhiều hơn 1 chủ đề cụ thể (một lệnh, tệp cấu hình, chức năng hệ thống, ...) trong khi thông tin thường có cấu trúc của một hướng dẫn kết hợp, giống như một cuốn sách.

— Tháng 1
nguồn

14

con người sử dụng ít hơn để hiển thị trang thủ công, lần lượt sử dụng các phím bấm vim trong khi thông tin sử dụng các phím bấm và các lệnh emacs tiêu chuẩn để tìm kiếm, thoát, v.v.

3

Vấn đề về keybindings rất thú vị (vì vậy tôi đã hiểu) ... Có vẻ như infocó tùy chọn keybindings VI: --vi-key (Sử dụng các ràng buộc khóa giống như vi và ít giống như ) vi-phím '... có thể?

— Peter.O