2017-12-15 96 views
7

Điều gì làm cho các tài liệu trợ giúp [], <>, --- có nghĩa là trong tài liệu trợ giúp?[], <>, - và - có nghĩa là gì trong tài liệu trợ giúp?

Khi tôi sử dụng git, tôi có thể sử dụng git help để hiển thị việc sử dụng một lệnh, nhưng tôi không hoàn toàn chắc là tôi hiểu những biểu tượng:

$ git help 
usage: git [--version] [--help] [-C <path>] [-c name=value] 
      [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path] 
      [-p | --paginate | --no-pager] [--no-replace-objects] [--bare] 
      [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>] 
      <command> [<args>] 

EDIT

Is có bất kỳ sự khác biệt nào giữa --- không?

+1

https://linux.die.net/man/7/man-pages cụ thể mô tả SYNOPSIS. – tripleee

+0

Thông thường, dấu gạch ngang đơn được sử dụng trước đối số tùy chọn ký tự đơn, trong khi dấu gạch ngang kép được sử dụng trước tên tùy chọn được viết đầy đủ. Vì vậy, hãy chú ý sự khác biệt giữa các từ đồng nghĩa '-p' với một dấu gạch ngang và' --paginate' với dấu gạch ngang kép. – tripleee

Trả lời

9

[] có nghĩa là nó không bắt buộc

-- hoặc - là thực sự được viết ở phía trước của tùy chọn. Một số tùy chọn bắt đầu bằng một số -, một số tùy chọn được tăng gấp đôi --, gắn với tùy chọn được viết cho tùy chọn bạn cần.

<> là viết tắt của một số trình giữ chỗ được thay thế bằng những gì bạn cần. (Ví dụ <path> là nghĩa vụ phải được thay thế bằng con đường thực tế của một số tập tin có liên quan cho các tùy chọn)

[A | B] có nghĩa là bạn có thể lựa chọn giữa A hoặc B


NB: Người ta rất giống với cú pháp của nhiều Tiện ích dòng lệnh Unix/Linux "trợ giúp sử dụng". Bạn có thể xem https://linux.die.net/man/7/man-pages, cảm ơn @tripleee về liên kết.


Trước đây, có một số lý do tại sao có một số tùy chọn chỉ có một dấu gạch ngang - và một số có hai dấu gạch ngang. Thông thường, "Một dấu gạch ngang" là tùy chọn mà bạn chỉ sử dụng một chữ cái. Nhưng đôi khi nó phức tạp hơn một chút.

+0

Loại cú pháp nào? – evolutionxbox

+2

Tôi nghĩ nó có nghĩa là "quy ước cú pháp trong các trang thủ công". – tripleee