Diagramas de Sintaxe
Um diagrama de sintaxe usa símbolos para representar os elementos de um comando e para especificar as regras para o uso desses elementos.
Tabela 1 explica como ler os diagramas de sintaxe que representam os comandos da interface de linha de comandos (CLI). Com isso, ela define os símbolos que representam os elementos do comando da CLI.
| Elemento | Sintaxe | Description |
|---|---|---|
| Linha de Caminho Principal | >>><>() () () | A linha de caminho principal começa à esquerda com pontas de setas duplas: >>. A linha de caminho principal termina à direita com duas pontas de setas voltadas umas para as outras: ><. Se um diagrama for mais longo do que uma linha, cada linha a ser continuada terminará com uma ponta de seta única e a próxima linha começará com uma única ponta de seta: >Leia os diagramas da esquerda para a direita, de cima para baixo, seguindo a linha de caminho principal. |
| Palavra-chave | Representa o nome de um comando, sinalizador, parâmetro ou argumento. Uma palavra-chave não é colocada em itálico. A palavra-chave deve ser digitada exatamente como mostrada no diagrama de sintaxe. | |
| Palavras-chave obrigatórias | Indicam os parâmetros ou argumentos que devem ser especificados para o comando. As palavras-chave obrigatórias devem ser escritas na linha de caminho principal. As palavras-chave obrigatórias que não podem ser utilizadas juntas são empilhadas verticalmente. | |
| Palavras-chave Opcionais | Indicam os parâmetros ou argumentos que você pode escolher especificar para o comando. As palavras-chave opcionais devem ser escritas abaixo da linha de caminho principal. Palavras-chave opcionais mutuamente exclusivas são empilhadas verticalmente. | |
| Valor padrão | O valor padrão deve ser escrito acima da linha de caminho principal. | |
| Palavra-chave ou valor Repetidos | Representa um parâmetro ou argumento que pode ser especificado mais de uma vez. Uma palavra-chave ou valor repetível é representada por uma seta retornando para a esquerda acima à esquerda da palavra-chave ou valor. | |
| Variável | Representa o valor que deve ser fornecido para um parâmetro ou argumento, como um nome de arquivo, um nome de usuário ou uma senha. As variáveis são mostradas em itálico. | |
| Separador de espaço | Inclui um espaço em branco na linha do caminho principal para separar elementos como palavras-chave, parâmetros, argumentos ou variáveis uns dos outros. | |
| Delimitadores de Aspas | Indicam o começo e o final de um parâmetro ou argumento que contém diversos valores. Coloque um ou mais pares nome-valor em um conjunto de aspas duplas para um determinado parâmetro ou argumento. Se o valor de um parâmetro ou par nome-valor contiver um espaço em branco, coloque o valor inteiro em um conjunto de aspas simples. | |
| Operador de sinal de igual | Separe um nome de seu valor em um par nome-valor. | |
| Fragmento de sintaxe | Divide diagramas de sintaxe que são muito longos, muito complexos ou repetitivos. O nome do fragmento é inserido no diagrama principal e o fragmento real é mostrado abaixo do diagrama principal. |
