kèo bóng đá pháp trang tham chiếu phải tuân theo bố cục tiêu chuẩn. Điều này cho phép người dùng tìm thấy thông tin mong muốn nhanh chóng hơn và nó cũng khuyến khích kèo bóng đá pháp nhà văn ghi lại tất cả kèo bóng đá pháp khía cạnh liên quan của một lệnh.PostgreSQLCác trang tham chiếu, nhưng cũng với các trang tham chiếu được cung cấp bởi hệ điều hành và các gói khác. Do đó các hướng kèo bóng đá pháp sau đây đã được phát triển.
kèo bóng đá pháp trang tham chiếu mô tả kèo bóng đá pháp lệnh thực thi phải chứa kèo bóng đá pháp phần sau, theo thứ tự này. kèo bóng đá pháp phần không áp dụng có thể được bỏ qua.Hồisử dụngHồiPhần.
Phần này được tạo tự động. Nó chứa tên lệnh và tóm tắt nửa câu của chức năng của nó.
Phần này chứa sơ đồ cú pháp của lệnh. Tóm tắt thường không liệt kê từng tùy chọn dòng lệnh;
Một số đoạn giải thích lệnh làm gì.
Một danh sách mô tả từng tùy chọn dòng lệnh. Nếu có nhiều tùy chọn, kèo bóng đá pháp tiểu mục có thể được sử dụng.
Nếu chương trình sử dụng 0 để thành công và không phải cho thất bại, thì bạn không cần phải ghi lại nó. Nếu có một ý nghĩa đằng sau kèo bóng đá pháp mã thoát khác không khác nhau, hãy liệt kê chúng ở đây.
Mô tả bất kỳ giao diện phụ hoặc thời gian chạy của chương trình. Nếu chương trình không tương tác, phần này thường có thể được bỏ qua.
Liệt kê tất cả kèo bóng đá pháp biến môi trường mà chương trình có thể sử dụng. Cố gắng hoàn thành;shellCó thể được người dùng quan tâm.
Liệt kê bất kỳ tệp nào mà chương trình có thể truy cập ngầm. Nghĩa là, không liệt kê kèo bóng đá pháp tệp đầu vào và đầu ra được chỉ định trên dòng lệnh, nhưng liệt kê kèo bóng đá pháp tệp cấu hình, v.v.
Giải thích bất kỳ đầu ra bất thường nào mà chương trình có thể tạo. Tránh liệt kê mọi thông báo lỗi có thể.
Bất cứ điều gì không phù hợp ở nơi khác, nhưng cụ thể là kèo bóng đá pháp lỗi, lỗ hổng thực hiện, cân nhắc bảo mật, kèo bóng đá pháp vấn đề tương thích.
ví dụ
Nếu có một số cột mốc chính trong lịch sử của chương trình, chúng có thể được liệt kê ở đây. Thông thường, phần này có thể được bỏ qua.
Tác giả (chỉ được sử dụng trong phần đóng góp)
Tham khảo chéo, được liệt kê theo thứ tự sau: KhácPostgreSQLTrang tham chiếu lệnh,PostgreSQLTrang tham chiếu lệnh SQL, trích kèo bóng đá phápPostgreSQLHướng kèo bóng đá pháp sử dụng, các trang tham chiếu khác (ví dụ: hệ điều hành, các gói khác), tài liệu khác. Các mục trong cùng một nhóm được liệt kê theo thứ tự bảng chữ cái.
kèo bóng đá pháp trang tham chiếu mô tả kèo bóng đá pháp lệnh SQL phải chứa kèo bóng đá pháp phần sau: Tên, Tóm tắt, Mô tả, Tham số, Đầu ra, Ghi chú, Ví dụ, Tương thích, Lịch sử, Xem thêm. Phần tham số giống như phần Tùy chọn, nhưng có nhiều sự tự do hơn về kèo bóng đá pháp mệnh đề của lệnh có thể được liệt kê.
Nếu bạn thấy bất cứ điều gì trong tài liệu không chính xác, không phù hợpMẫu nàyĐể báo cáo vấn đề tài liệu.