Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

Comandos

O que um comando faz quando é executado

Todos os comandos terminam em algo visível. Nada é bem-sucedido em silêncio, porque um comando que não diz nada parece exatamente um que nunca foi executado.

  • Escolher uma Release altera os dois indicadores e não gera nenhuma notificação. O resultado já está à vista, e uma notificação sobre ele só ensinaria a descartar notificações sem as ler.
  • Validate e lint indicam quantos problemas encontraram — inclusive quando não encontraram nenhum. Uma execução limpa di-lo, em vez de deixar o painel Problems intacto e o utilizador sem saber se o comando foi executado.
  • Draft entity e inspect terminam com o documento aberto num separador. Show config termina num painel em vez de num documento, porque o que apresenta é uma lista de definições para ler de cima a baixo e não um ficheiro para guardar.
  • Uma operação longa mostra o progresso com um botão Cancel. Isso abrange tudo o que chega a um registo, renderiza ou resolve uma Release, percorre o catálogo ou executa um plugin sobre a entrada: validate, lint, build, preview build, o grafo de topologia, pull, inspect, push, sign, deprecate e import. Redigir um documento, apresentar a configuração efetiva e manter as caches não se incluem em nada disso, pelo que são executados sem ele. Além disso, a manutenção da cache não pode de todo ser interrompida — o compilador não tem forma de a parar a meio —, pelo que fica coberta pela confirmação prévia e não por um botão que só poderia fazer o editor deixar de esperar.
  • Premir Cancel para o compilador, e não apenas a espera do editor. Através do servidor de linguagem, a extensão envia o cancelamento do pedido que emitiu; através de um subprocesso, termina o processo. O cancelamento de uma compilação produz efeito nos limites de fase da própria compilação, pelo que uma fase pesada já em curso termina primeiro — e é por isso que a mensagem diz que a operação foi parada e não que parou instantaneamente. Em qualquer dos casos, o resultado é comunicado como stopped, nunca como falha.
  • Uma operação de cache que remove algo pergunta primeiro e indica as caches que vai atingir. Esvaziar e podar afetam as caches próprias deste workspace e as caches de módulos compilados e de plugin-describe partilhadas por todos os projetos nesta máquina, pelo que essas confirmações indicam ambas. Aparar afeta apenas a cache partilhada de módulos compilados, pelo que a sua confirmação indica essa e diz que as caches próprias do workspace ficam intactas. Depois, uma mensagem indica o que foi removido e, quando existe, quanto ficou no lugar porque outro processo o tem aberto; recusar indica que nada foi removido.
  • Push, sign e deprecate indicam o que passa a ser verdade para os consumidores — que a versão publicada é o que outros que a obtêm passam a resolver, que a assinatura está disponível para ser verificada, que o marcador de descontinuação é o que os resolvedores passam a ver. Cada um indica o registo que alcançou e se algo saiu de facto desta máquina, com base no que o compilador fez e não no que foi pedido, pelo que uma publicação que não depositou nada nunca é comunicada como uma que depositou.
  • Uma falha mostra a própria mensagem do compilador, com um botão ao lado, nunca um resumo reformulado no lugar dela. A mensagem do compilador indica normalmente o que executar ou o que corrigir, e o botão Show output leva ao texto completo no canal de saída do Aggrega. Uma operação que executa o binário aggrega e é recusada indica o estado com que o binário terminou e depois as palavras que escreveu ao recusar, sem alterações, e o canal de saída termina com a mesma frase, linha por linha. Uma inspeção recusada por causa do documento que declara a entidade oferece antes Open document, porque é desse documento que a mensagem trata e o canal não contém mais nada.

Os comandos

A Paleta de Comandos filtrada pelos comandos do Aggrega.

  • Aggrega: Get started — traz de volta a página de boas-vindas depois de ter sido desativada, e abre-a. Reativa aggrega.getStarted.show, de modo que desativar a página é uma escolha que se pode desfazer e não uma porta que se tranca nas costas. Marcar a caixa de verificação no rodapé da página reativa a mesma definição e não abre nada: a página é aquela em que se está, pelo que a caixa mantém o foco do teclado e a tecla Espaço marca-a e desmarca-a alternadamente. O ícone de casa na barra de título do painel Commands é outra coisa: abre a página e não altera nenhuma definição, de modo que um olhar à página nunca é também uma decisão sobre o arranque.

  • Aggrega: Stop opening the welcome page on startup — impede que a página de boas-vindas abra no arranque, desativando aggrega.getStarted.show nas definições do próprio utilizador. Isto impede que apareça sem ser pedida, em vez de a pôr fora de alcance: Aggrega: Get started trá-la de volta. Desmarcar a caixa de verificação no rodapé da página executa este mesmo comando, pelo que a decisão pode ser tomada a partir do sítio onde a página está a ser lida, tal como a partir da paleta.

  • Aggrega: Open settings — abre as preferências desta extensão. É também a roda dentada no canto superior direito do painel Commands. Abre a própria página de definições do editor filtrada para esta extensão, de modo que há um sítio onde uma preferência reside e um sítio onde é escrita. Distinto de Show config, que apresenta o que o compilador resolveu para o workspace e não o que está definido no editor.

  • Aggrega: Select Release… — escolhe a Release com que o editor trabalha. Produz efeito de imediato, volta a verificar os ficheiros abertos face a ela e faz o painel Catalog voltar a ler a sua lista; nada é reiniciado. Também acessível clicando no indicador de Release na barra de estado. Ver Selecionar uma Release.

  • Aggrega: Set the selected Release as this workspace’s default — regista a Release selecionada em .aggrega/active-release, para que uma sessão posterior comece nela. O servidor de linguagem escreve o ficheiro, e recusa, com as suas próprias palavras, onde .aggrega ou o marcador é uma ligação que leva para fora do workspace Aggrega. Local ao checkout, e não altera a seleção atual.

  • Aggrega: Set authoring_release in .aggrega-config.yaml… — abre o ficheiro de configuração para definir build.authoring_release, a predefinição versionada que uma equipa partilha. Tem precedência sobre o ficheiro marcador. Um ficheiro de configuração que o servidor de linguagem identifica como uma ligação que leva para fora do workspace Aggrega não é aberto, e um erro explica porquê.

  • Aggrega: Select Compiler Version — escolhe a versão do compilador aggrega que esta máquina executa, entre as versões com que esta extensão funciona, após um aviso que é preciso confirmar; a nova versão substitui a anterior apenas depois de o servidor de linguagem ter arrancado com ela. Ver Obter o compilador.

  • Aggrega: Start or restart the language server — inicia o servidor de linguagem onde nenhum está em execução e, onde há um, termina-o e lança um novo, repondo o contador de tentativas de reinício. Nunca fica fora da paleta de comandos: iniciar é o que faz, pelo que ocultá-lo enquanto nada está em execução ocultá-lo-ia precisamente na única situação que precisa dele. Também acessível clicando no indicador do servidor de linguagem na barra de estado. Onde nenhuma pasta na janela é uma que o Aggrega reconheça, di-lo em vez de parecer não fazer nada.

  • Aggrega: Toggle the artifact-rendering stage while inspecting — alterna no próprio lugar a definição aggrega.server.buildOnInspect, de modo que a interface das definições esteja sempre de acordo com ela, e oferece o reinício que a aplica — o servidor de linguagem lê a definição ao arrancar. Também acessível a partir do menu de ações rápidas da barra de estado, que mostra se a definição está atualmente ativada. A etapa acrescenta os avisos que aggrega build emite durante a renderização, e nenhuma das verificações em que um build é interrompido. As constatações chegam etiquetadas com a camada que as emitiu, de modo que os avisos da etapa se agrupam à parte da validação no painel Problems e são limpos independentemente dela. O reinício que aplica a alteração esvazia o painel Problems e volta a verificar os ficheiros abertos, pelo que, com a etapa desativada, os seus avisos saem dele e, com ela ativada, regressam da próxima vez que o grafo for desenhado.

  • Aggrega: Validate active file / Build / Preview build / Lint — executam a operação correspondente do compilador através do servidor de linguagem. Build, preview build e pull atuam sobre a Release selecionada em vez de perguntar de cada vez. Build compila a Release selecionada com todas as verificações ativas e escreve os artefactos que gera num diretório dist/ na pasta do projeto, de modo que chegam ao lado do trabalho que se escolheu abrir — ou, quando não está escolhida nenhuma pasta de projeto ou a escolhida não está dentro do espaço de trabalho Aggrega, no diretório dist/ na raiz do espaço de trabalho Aggrega — e a linha final do build e a sua notificação indicam o diretório em que escreveu. aggrega build executado num terminal escreve no diretório dist/ na raiz do espaço de trabalho Aggrega, seja de onde for executado, pelo que, com uma pasta de projeto abaixo dessa raiz, o editor e o terminal escrevem em dois diretórios diferentes; preview build executa a mesma compilação e indica o que teria escrito, sem mexer no diretório de saída.

    No painel Commands, o botão Build tem ao lado uma seta, chamada Build options, que abre as opções que se aplicam ao próximo build — Auto pull resolve as dependências da Release selecionada no lockfile antes da renderização, e está desativada a menos que seja ativada, que é a predefinição da própria linha de comandos para a mesma escolha. Enquanto Build não pode ser executado, a seta fica onde está, a cinzento, e apontar para ela mostra o motivo pelo qual Build não pode ser executado; não abre nada até que Build possa ser executado. Cada opção tem ao lado uma caixa — vazia enquanto está desativada, marcada enquanto está ativada — para que se possa ler o seu estado sem premir nada, e a frase que diz o que faz ativá-la aparece enquanto se aponta para a linha ou depois de se ter chegado a ela com as teclas de seta. Alternar uma opção não executa nada e deixa a lista aberta, para que se possa alternar outra; premir Build — ou novamente a seta — fecha a lista. As opções duram a sessão e não são escritas em lado nenhum, pelo que fechar a janela descarta-as, e pertencem apenas ao Build: preview build indica o que um build escreveria sem escrever nada disso, e resolver dependências escreve o lockfile, pelo que não aceita opção nenhuma.

    Ambos colocam no painel Problems as constatações que têm uma posição no documento, marcadas com a camada que as gerou — entre elas uma recusa que o compilador gera durante a renderização, registada no documento que nomeia, como a Recipe cujo Workload recusou, com o seu código curto a abrir a página que a explica, enquanto o build ou a pré-visualização termina com as próprias palavras do compilador no canal de saída e numa notificação — e escrevem os avisos que não nomeiam nenhuma posição — um pin retirado, um pai que não é possível resolver — no canal de saída do Aggrega juntamente com a lista de artefactos. Fechar um ficheiro retira as suas próprias constatações do painel Problems e mantém o que um build, uma pré-visualização ou um grafo nele encontrou: essas dizem respeito à Release e não ao ficheiro que estava aberto, pelo que permanecem até o compilador deixar de as reportar. Um Build, uma Preview ou um grafo que o compilador recusa porque uma dependência não se resolve coloca também essa recusa no painel Problems — no documento que o compilador nomeia, ou na Release quando não nomeia nenhum — e ela permanece durante a abertura e o fecho desse ficheiro, até que o próximo Build, Preview ou grafo dessa Release obtenha resposta sem ela.

    Um build com Auto pull escreve, antes destes, o que fez a sua resolução de dependências: uma linha por cada referência que fixou, com a versão para a qual foi resolvida, o seu tipo quando o compilador indica um e, quando o compilador o reporta, de onde esta execução obteve a referência, na palavra que aggrega pull --detail imprime para ela — fetched-fresh, cache-reuse, local, in-binary ou external — e depois o resumo que aggrega pull imprime num terminal, Pull complete: seguido do lockfile escrito, nomeado a partir da raiz do espaço de trabalho, e das contagens do que a resolução registou.

    Lint verifica as convenções de publicação e coloca cada constatação no painel Problems, pelo que clicar numa abre a entidade a que diz respeito. Cada uma é marcada com o código curto que aggrega lint imprime para a regra que a produziu, e a marcação abre a página que explica esse código; uma regra que não tem código curto é marcada, em vez disso, com o seu próprio nome. Uma constatação localizada num ficheiro mas não numa linha fica no topo desse ficheiro e não numa posição adivinhada, e cada constatação é também escrita no canal de saída do Aggrega, sob o documento a que diz respeito, como a linha que aggrega lint imprime para ela: a sua gravidade, o código curto da regra, a identidade da própria regra e a redação da própria regra, inalterada. Quando a configuração dá às suas Releases diretórios de catálogo próprios em workspace.releases, Lint verifica o catálogo uma vez por cada Release, sobre os diretórios que essa Release lê — as Releases que leem os mesmos diretórios são verificadas em conjunto — e reporta cada verificação à parte: o canal de saída abre-a com a linha com que aggrega lint a abre, nomeando as suas Releases e os diretórios lidos, e lista por baixo as suas constatações; a notificação final indica o que cada verificação encontrou e em quantas entidades, para as suas próprias Releases; e cada entrada de Problems termina nomeando as Releases cuja verificação a encontrou, pelo que uma constatação num diretório que duas verificações leem é listada uma vez por cada uma.

    Os quatro indicam quantas constatações produziram, inclusive quando a resposta é nenhuma, pelo que uma execução limpa se distingue de um comando que não foi executado; os quatro mostram o progresso com um botão Cancel enquanto trabalham.

  • Aggrega: Pull — executa o binário aggrega sobre a Release selecionada e transmite a sua saída para o canal de saída do Aggrega. Resolve na cache as dependências de catálogo e de código-fonte que a Release declara e escreve o lockfile por Release, registando nesse lockfile as entradas externas que a renderização da Release consome, para que um build posterior as sirva a partir do armazenamento local. Chega a um registo, pelo que mostra o progresso com um botão Cancel, e termina com uma mensagem a dizer o que fez. Um Build, uma Preview ou um grafo aberto pelo utilizador que o compilador recusa porque a Release não tem lockfile termina numa única notificação, Aggrega: <release> has no lockfile. seguida da própria frase do compilador, com um botão Pull: premi-lo executa este comando, com o binário com que a extensão está configurada, para a Release que o compilador indicou — ou para a Release selecionada onde o compilador não indicou nenhuma — e o canal de saída contém a frase do compilador na linha com que a operação termina. Um redesenho não pedido, como um grafo aberto redesenhado após guardar, gera o mesmo aviso no máximo com a frequência que as duas definições aggrega.notifications permitem. Seja o que for que escreva o lockfile da Release selecionada — este comando, um build com Auto pull ou aggrega pull escrito num terminal —, os ficheiros abertos são verificados de novo face a ele, e um aviso de que o lockfile divergiu sai por si só do painel Problems assim que a escrita o resolve: um grafo aberto nessa Release é redesenhado, o que volta a verificar o lockfile, e onde nenhum grafo mostra essa Release — nenhum está aberto, ou o que está aberto ainda mostra uma Release selecionada anteriormente —, a extensão pede o seu grafo uma vez sem desenhar nada. Apenas o lockfile da Release selecionada é acompanhado desta forma, e apenas dentro das pastas que a janela tem abertas; um aviso sobre o lockfile de outra Release permanece até que se mostre o grafo dessa Release.

  • Aggrega: Draft entity… — escolhe-se um tipo entre aqueles para os quais o compilador responde; depois é pedido ao servidor de linguagem um documento inicial, que é aberto num novo separador por guardar. Os tipos são pedidos em vez de mantidos na extensão, pelo que a escolha acompanha o compilador em execução: um tipo que ele ganhe é oferecido sem que esta extensão seja alterada. Lê-se o nome que o documento terá, e o rascunho é pedido pelo próprio token do compilador para esse tipo — e o pedido que depois solicita um nome indica que tipo está a designar, nas mesmas palavras que se acabaram de ler. Nada é escrito em disco: o rascunho pode ser editado, guardado ou descartado. Uma invocação que indica um tipo que o compilador não reconhece — um atalho de teclado ou um fluxo gravado pode conter um — regressa com a própria mensagem do compilador que indica os tipos que reconhece. É também a segunda linha do painel Catalog, Draft entity.

  • Aggrega: Inspect… — escolhe-se uma entidade que o workspace consegue ver e vê-se aquilo em que se resolve, aberto num novo separador. Uma inspeção é endereçada por nome, pelo que uma entidade resolvida a partir de um diretório de catálogo configurado é oferecida aqui tal como uma que o workspace declara. Resolve-se nos termos da Release selecionada, e as entidades oferecidas são as que o painel Catalog lista para essa Release: um nome que várias variantes declaram, uma por Release, resolve-se na da Release selecionada, e um nome que essa Release não resolve é reportado como não resolvido, com o motivo do compilador, que indica a entrada dessa Release em workspace.releases. Sem nenhuma Release selecionada, resolve-se através dos diretórios de catálogo próprios do workspace. Onde um documento no workspace declara a entidade e o catálogo não resolveu nada a partir dele — o documento viola o esquema do seu tipo, por exemplo, ou está fora de todos os diretórios de catálogo —, a notificação diz que a entidade não pode ser inspecionada por causa do documento que a declara, seguida da própria frase do compilador a dizer o que está errado, e o seu botão Open document abre esse documento; o canal de saída do Aggrega contém a mesma frase. Uma inspeção recusada por qualquer outro motivo termina como qualquer operação falhada. A leitura das entidades que o workspace contém mostra o progresso e pode ser parada, tal como a resolução que se segue. Quando o comando é premido no painel Commands, as entidades são oferecidas como um menu ao lado do botão; executado a partir daqui, são oferecidas como uma lista onde se escolhe. A inspeção que uma linha do painel Catalog oferece é esta, e termina da mesma forma.

  • Aggrega: Import into Aggrega — ver Importar para o Aggrega.

  • Aggrega: Cache… — escolhe-se uma operação de cache e executa-se através do servidor de linguagem. Premido no painel Commands, as quatro operações são apresentadas como um menu ao lado do botão; executado a partir daqui, são apresentadas como uma lista para escolher. Nenhum processo é lançado, e cada resposta regressa como um resultado estruturado que o painel apresenta: status lista cada cache, o que contém e até que ponto cada uma é partilhada, e não remove nada; prune remove as entradas que nenhum lockfile referencia e indica o que manteve, juntamente com tudo o que não tinha base para recuperar e a operação que o faria; evict pede primeiro um limite de tamanho — uma quantidade de bytes como 5GiB ou 512MiB, ou um número de bytes, lido pelo mesmo analisador que a linha de comandos utiliza — e reduz a cache partilhada de módulos compilados até esse limite; clear esvazia todas as caches. As três que removem algo pedem confirmação primeiro, e cada confirmação indica as caches que essa operação realmente alcança: esvaziar alcança as caches próprias deste espaço de trabalho para entidades, artefactos de origem e entradas externas e as caches de módulos compilados, de descrições de plugins, de pacotes de documentação e de plugins de CLI que todos os projetos desta máquina partilham; podar alcança as mesmas caches do espaço de trabalho e as caches partilhadas de módulos compilados, de descrições de plugins e de plugins de CLI; e reduzir alcança apenas a cache partilhada de módulos compilados. Cada tamanho que estas operações indicam é escrito no mesmo vocabulário em que esse limite é lido, pelo que um valor lido num relatório de cache pode ser escrito diretamente no pedido do limite. Um limite que o compilador não consegue ler regressa com a própria mensagem do compilador a indicar o aspeto de um limite de tamanho. As caches esvaziadas e reduzidas voltam a ser preenchidas no build seguinte que delas precise. O Windows recusa-se a remover um ficheiro que outro processo tem aberto, e uma poda, uma redução ou um esvaziamento deixa-o então no lugar e continua com o resto em vez de falhar: o canal de saída do Aggrega indica cada entrada que uma poda ou uma redução deixou, com a sua classe, até que ponto é partilhada e o seu tamanho, e indica, sob cada cache que um esvaziamento alcançou, quantos ficheiros lá deixou e o tamanho destes; a mensagem com que a operação termina diz quantos ficaram no lugar, pede que a operação seja executada de novo assim que esse processo tiver terminado e remete para o canal para saber quais. Onde nada ficou no lugar, o que acontece em todas as execuções numa plataforma que remove um ficheiro aberto, nenhuma das duas diz nada a esse respeito.

  • Aggrega: Push… / Sign… / Deprecate… — as operações que alteram o que outras pessoas resolvem. Push pergunta qual das entidades que o painel Catalog lista deve ser publicada — um menu ao lado do botão no painel Commands, uma lista para escolher quando executado a partir daqui — e depois empacota-a e publica-a num registo configurado. Sign e deprecate pedem uma referência a um artefacto já publicado, porque ambas alteram bytes publicados em vez do espaço de trabalho: sign anexa uma assinatura, deprecate anexa um marcador de descontinuação assinado e pede a gravidade — warning, error ou retracted — e o motivo que regista. As três passam pelo servidor de linguagem, as três mostram o progresso com um botão Cancel que termina a publicação e não apenas a espera, e cada uma termina indicando o que o compilador realmente fez: a referência e a versão para as quais a entidade foi resolvida e o digest para o qual essa versão aponta agora, o digest com que cada assinatura se compromete, ou o próprio digest do marcador. Uma publicação que encontrou os mesmos bytes já publicados di-lo, em vez de se apresentar como uma que depositou algo. As suas constatações e o relato completo vão para o canal de saída do Aggrega.

  • Aggrega: Show config — abre um painel que lista todas as definições declaradas pelo esquema de configuração, gerado a partir desse esquema para que as definições, os seus nomes, os seus valores predefinidos e o que aceitam tenham um único lugar e uma nova definição apareça sem qualquer alteração aqui. O painel abre-se como uma tabela com uma linha por definição, sob uma linha de cabeçalho para cada grupo da configuração — workspace, build, plugins, mcp, signing e os restantes —, com as definições de nível superior em primeiro lugar. Cada linha apresenta a definição tal como seria escrita no ficheiro, o seu nome por extenso, o seu valor, o que a definição aceita e de onde veio o valor. O nome é derivado da chave: uma sigla é escrita em maiúsculas e, onde os nomes de duas definições se leriam da mesma forma, acrescenta-se o grupo em que cada uma se encontra, de modo que duas linhas nunca partilham um nome. A única coluna de valor indica o que se aplica agora: um valor definido num ficheiro ou no ambiente, ou um que não é o valor predefinido declarado pelo esquema, é marcado com ●, e apontar para a marca indica porquê e qual é o valor predefinido declarado — é assim que se encontram as definições alteradas; uma definição sem valor em vigor mostra none, e uma lista vazia mostra [].

    O complemento aditivo de uma lista — workspace.catalog_dirs_append ao lado de workspace.catalog_dirs, por exemplo — não tem linha própria: é nomeado sob o caminho da sua lista, e a linha da lista mostra o único valor e a única origem que o relatório do compilador atribui aos dois em conjunto, o que não indica que entradas o complemento acrescentou. Uma definição que pertence à máquina e não a um único projeto — um registry e a sua política de confiança de assinaturas, a cache de módulos compilados, a lista de plugins que contribuem com comandos — é marcada como Global na sua linha. A descrição da definição encontra-se por trás de um pequeno círculo marcado com i na última coluna, intitulada Description, o que mantém fora da linha o elemento mais longo de uma definição: prima-o ou passe o ponteiro por cima para ler a descrição, com qualquer código que nomeie apresentado como código. O caminho de uma definição só quebra depois de _ ou ., e um valor ou um caminho de ficheiro só depois de /, . ou _ ou num espaço, de modo que nada é cortado a meio de uma palavra.

    Ainda assim, a tabela é mais larga do que um painel ancorado e desloca-se lateralmente nele, e a chave da definição mantém-se visível durante o deslocamento, de modo que o valor até ao qual se desloca tem sempre ao lado a definição a que pertence; a legenda acima da tabela quebra conforme a largura do painel. Cada cabeçalho de coluna com rótulo tem um canto de redimensionamento no seu limite direito: arraste-o para alargar ou estreitar essa coluna. Alargar uma coluna não alarga a tabela, pelo que a coluna segue o ponteiro enquanto as outras colunas têm espaço para ceder e para quando estão todas na largura mínima; onde o painel é demasiado estreito para a tabela mesmo na sua largura mínima — ancorado na barra lateral, por exemplo —, cada coluna já lá está e os cantos não movem nada. Uma coluna deixa de estreitar no troço mais largo que não pode quebrar — o seu cabeçalho, uma palavra do nome de uma definição, ou a parte de um caminho ou de um valor entre dois pontos onde pode quebrar — e a coluna da definição mantém uma largura mínima própria; tudo o resto numa coluna estreitada quebra dentro dela em vez de invadir a seguinte. O painel não executa nenhum script, e daí resultam três limites: uma largura definida dura apenas até o painel ser redesenhado, pelo que mudar para a outra forma, premir novamente Show config ou reabrir o painel redesenha cada coluna de raiz na largura que a tabela lhe atribui; uma coluna não pode ser ajustada ao seu conteúdo a pedido, com um duplo clique ou de outra forma; e o canto alcança-se com o ponteiro, não com o teclado.

    Um controlo acima da tabela muda para uma segunda forma que dá a cada definição um bloco próprio, com a sua descrição e o seu alcance mostrados no local e a regra da marca Global enunciada no topo, e o painel reabre-se na forma usada por último. Cada definição mostra o valor em vigor e, onde o compilador o consegue indicar, de que ficheiro veio esse valor. O relatório do compilador atribui cada definição, o complemento de uma lista na própria linha da sua lista; onde não nomeia uma definição em lado nenhum — um relatório que não pôde ser lido, por exemplo —, o painel di-lo em vez de sugerir uma origem que não tem: essa definição é mostrada com o seu valor predefinido declarado, marcado como a declaração e não como uma leitura, e sem origem, e a caixa no topo do painel nomeia cada uma delas.

    Premir Show config com o painel aberto trá-lo para a frente e volta a ler a configuração. Onde a configuração não pode ser lida, premir fecha o painel, estivesse ou não aberto, e uma notificação indica porquê; onde o motivo é o servidor de linguagem não estar em execução, a notificação oferece Start, que executa Aggrega: Start or restart the language server. O painel relata; não escreve. Alterar uma definição é editar o ficheiro de configuração.

  • Aggrega: Show topology graph — abre o grafo de topologia da Release selecionada. Desenhá-lo compila essa Release até à sua topologia, pelo que mostra o progresso com um botão Cancel.

  • Aggrega: Attach a Feature to the connection at the cursor — associa uma Feature a uma ligação a partir da entrada desta no documento. Encontra-se no menu de contexto do editor e na paleta de comandos, e apenas num documento que o servidor de linguagem indica como um dos Aggregates ou das Releases do espaço de trabalho. Pergunta ao servidor de linguagem dentro da entrada de que ligação está o cursor, nos termos da Release selecionada, como as restantes funcionalidades do cursor: a entrada com que um componente traça uma ligação, sob o alias da ligação, ou a entrada que uma Release escreve para uma. Numa entrada assim, abre o grafo de topologia na Release selecionada com essa ligação selecionada, e a associação faz-se a partir da sua secção May attach como depois de clicar na aresta da ligação, exceto que a entrada é escrita no documento em que o comando foi executado. Em qualquer outro lugar, não abre nada e diz porquê: o cursor não está dentro da entrada de uma ligação, foi uma Feature que traçou a ligação, ou a entrada da Release diz respeito a uma ligação que o seu grafo compilado não contém. Sem Release selecionada, propõe selecionar uma, como faz Aggrega: Show topology graph, e uma recusa do servidor de linguagem é mostrada nas suas próprias palavras. As alterações não guardadas são enviadas primeiro ao servidor de linguagem, de modo que o cursor é lido em relação ao texto que se vê.

  • Aggrega: Search published catalog — abre a lista de filtros, restringe a pesquisa por texto livre, tipo, etiquetas, capacidade, socket de plugin ou um limite de resultados, depois executa-a e copia uma referência encontrada. Cada faceta é editável por qualquer ordem e regressa à lista, de modo que o filtro inteiro pode ser lido antes de ser executado. Enquanto a extensão estiver em execução na janela, a lista abre com o filtro deixado pela última pesquisa, e Reset search filter, logo acima de Search, limpa todas as facetas sem pesquisar. Uma pesquisa que não encontrou nada indica o filtro que executou e, onde um registo configurado ainda não tem índice, os registos em que pesquisou, depois aqueles em que não pesquisou e como construir o respetivo índice; essa é uma resposta diferente de um índice que não pôde de todo ser lido — a segunda indica a própria mensagem do compilador e o texto completo vai para o canal de saída do Aggrega, juntamente com a linha de atualidade que indica cada registo pesquisado e quando o seu índice foi atualizado pela última vez. É também a primeira linha do painel Catalog, Search catalog.

  • Aggrega: Refresh plugins — recarrega o painel Plugins.

  • Aggrega: Refresh registries — volta a ler os registos configurados. Não contacta nenhum registo, pelo que repetir custa pouco.

  • Aggrega: Refresh workspace catalog — volta a perguntar ao servidor de linguagem que entidades o espaço de trabalho consegue ver. Lê o espaço de trabalho que o servidor já tem aberto e não contacta nenhum registo, pelo que repetir custa pouco. O painel volta a perguntar por si só quando o servidor de linguagem passa a poder responder, quando a Release selecionada muda, depois de um documento ser criado, alterado ou eliminado no disco, e depois de o editor fechar um, pelo que este comando serve para o que nenhum desses casos cobre, como uma alteração ainda num buffer não guardado. Encontra-se na barra de título do painel Catalog, onde é o único elemento: volta a ler essa lista em vez de agir sobre o que a lista contém, pelo que pertence ao painel e não ao espaço de trabalho.