帶點的十進位數語法圖

以帶點十進位格式提供語法圖,讓使用者可以使用螢幕閱讀器來存取說明文件。

在帶點的十進位數格式中,每一個語法元素編寫在一行。 如果兩個以上的語法元素固定一起顯示 (或固定一起消失), 則可能會在同一行顯示,因為它們被視為單一複合語法元素。

每一行開頭為帶點的十進位數;例如 3、3.1 或 3.1.1。 若要正確聽到這些數字,請確定您的螢幕讀取器設為讀出標 點符號。 具有相同帶點的十進位數的所有語法元素 (例如具有數字 3.1 的所有語法元素) 為互斥替代項。 如果您聽到 3.1 USERID 和 3.1 SYSTEMID 行,表示您的語法可包含 USERID 或 SYSTEMID,但不可同時包含兩者。

帶點的十進位數編號層次表示巢狀層次。 例如,如果有一個具有帶點的十進位數 3 的語法元素,其後跟隨一連串具有帶點的十進位數 3.1 的語法元素,則所有編號 3.1 語法元素為編號 3 語法元素的子層。

帶點的十進位數旁邊使用某些字詞和符號,來提供語法元素的其他資訊。 有時候這些字詞和符號可能出現在語法元素本身開頭。 為方便識別,如果字詞或符號是語法元素的一部分,則在其前面加上反斜線 (\) 字元。 帶點的十進位數旁邊可使用 * 符號來指示語法元素重複。 例如,具有帶點的十進位數 3 的語法元素 *FILE,其格式為 3 \* FILE。 格式 3* FILE 表示語法元素 FILE 重 複。 格式 3* \* FILE 表示語法元素 * FILE 重複。

用來分隔一串語法元素的字元 (例如逗點),其在語法中的顯示位置是在其分隔的項目之前。 這些字元可能與每一個項目顯示在同一行,或與相關項目顯示在具有相同帶點的十進位數的不同行。 行上也可顯示提供語法元素相關資訊的另一個符號。 例如,5.1*、5.1 LASTRUN 及 5.1 DELETE 行表示, 如果您使用一個以上的 LASTRUN 和 DELETE 語法元素,則必須以逗點分隔這些元素。 如果未指定分隔字元, 則假設您使用空格分隔每一個語法元素。

如果語法元素前置 % 符號,這表示已在別處定義了參照。 % 符號後面的字串是語法片段而非文字。 例如,2.1 %OP1 這一行表示您應該參照個別的語法片段 OP1。

帶點的十進位數旁邊使用下列字詞和符號:
  • ? 表示選用的語法元素。 帶點十進位數後面若有 ? 符號,表示所有含對應帶點十進位數的語法元素,以及任何子層語法元素都是選用性的。 如果只有一個語法元素具有帶點的十進位數數字,則 ? 符號就會與語法元素顯示在同一行 (例如 5? NOTIFY)。 如果有多個語法元素具有帶點的十進位數數字,則 ? 符號就會單獨顯示一行,後面跟著選用的語法元素。 例如,如果您聽到第 5 行? , 5 NOTIFY 和 5 UPDATE ,您知道語法元素 NOTIFY 和 UPDATE 是選用的; 也就是說,您可以選擇其中一個,也可以不選擇任何一個。 ? 符號等於鐵路路線圖中的旁路。
  • ! 表示預設語法元素。 帶點十進位數後面若有 ! 符號及語法元素,表示此語法元素是所有共用相同帶點十進位數之語法元素的預設選項。 共用相同帶點的十進位數數字的語法元素中,只有一個可以指定 ! 符號。 比方說,如果聽到 2? FILE、2.1! (KEEP) 及 2.1 (DELETE) 等行,則表示 (KEEP) 是 FILE 關鍵字的預設選項。 在此範例中,如果您加入 FILE 關鍵字但未指定選項,則會套用預設選項 KEEP。 預設選項也會套用到下一個較高的帶點的十進位數。 在此範例中,如果省略了 FILE 關鍵字,則會使用 預設的 FILE(KEEP)。 不過,如果您聽到 2? FILE、2.1、2.1.1! (KEEP) 及 2.1.1 (DELETE) 等行,則預設選項 KEEP 只會套用到下一個更高的帶點十進位數 2.1(其沒有相關聯的關鍵字)而不會套用到 2? FILE。 如果省略了關鍵字 FILE,則不使用任何選項。
  • * 表示可重複 0 或多次的語法元素。 帶點的十進位數後面的 * 符號,表示這個語法元素可使用零或多次; 亦即,它是選用的且可重複使用。 例如,如果您聽到 5.1* data area 這一行,就知道您可以包括一個資料區、 多個資料區或不包括資料區。 如果您聽到 3*、3 HOST 和 3 STATE 行,表示您可併入 HOST、STATE,兩者一起併入或都不併入。
    附註:
    1. 如果帶點的十進位數旁邊有星號 (*) 且只有一個項目有該帶點的十進位數, 則您可以重複相同項目多次。
    2. 如果帶點的十進位數旁邊有星號且數個項目有該帶點的十進位數,則您可使用清單中多個項目, 但不能重複使用每個項目。 在上一個範例中,您可以編寫 HOST STATE,但不能編寫 HOST HOST。
    3. * 符號等同於鐵路語法圖中的迴路。
  • + 表示必須加入一或多次的語法元素。 帶點的十進位數後面的 + 符號,表示必須加入這個語法元素一或多次; 亦即,它至少要加入一次且可重複加入。 例如,如果您聽到 6.1+ data area 這一行,就必須至少包括一個資料區。 如果您聽到 2+、2 HOST 及 2 STATE 行,表示您必須加入 HOST、STATE 或兩者。 + 符號與 * 符號相似之處在於,如果只有一個特定項目具有某個帶點的十進位數數字, 則 + 符號只能重複一次該項目。 + 符號 (類似於 * 符號) 等同於鐵路語法圖中的迴路。