BerndPol Ficheiros de Configuração Usados pelo &tdevelop; O &tdevelop; usa uma série de ficheiros de configuração que estão distribuídos entre várias pastas. Existem dois grupos principais de ficheiros de configuração para distinguir: Configuração por Omissão do &tdevelop; — os ficheiros configurados quando o &tdevelop; foi instalado. Configuração Orientada pelo Utilizador — os ficheiros que contêm as modificações do utilizador aos valores predefinidos, assim como as configurações feitas pelo próprio &tdevelop; e pelos seus 'plugins'. Configuração Predefinida do &tdevelop; Na instalação, o &tdevelop; grava alguns ficheiros de informação por omissão para fins de configuração nas subpastas da pasta de instalação $TDEDIR (normalmente algo do género de /opt/kde, /usr/local/kde, ou outra pasta de instalação definida pelo utilizador; veja em Instalar o &tdevelop;). Configuração Predefinida do &tdevelop; Só existe um ficheiro de configuração por omissão específico do &tdevelop; na pasta $TDEDIR/share/config/: tdeveloprc Este ficheiro contém as opções básicas que o &tdevelop; necessita para começar. Será copiado para a pasta do utilizador em $TDEHOME/share/config, quando o &tdevelop; não encontrar aí um ficheiro tdeveloprc no arranque. Valores Predefinidos da Aplicação A maioria das funcionalidades do &tdevelop; são oferecidas através de KParts. Estas são basicamente aplicações desenhadas especialmente para correr na plataforma do &tdevelop; (veja a introdução no apêndice sobre as Ferramentas e 'Plugins'). Cada aplicação KPart tem o seu próprio conjunto de ficheiros de configuração, cujos valores por omissão serão gravados em várias subpastas da pasta de instalação $TDEDIR/share/apps/. Existem bastantes subpastas de configuração por omissão em $TDEDIR/share/apps/, cujos nomes começam todos por uma sequência kdev. A maioria delas são para o uso interno do &tdevelop;. Elas poderão estar agrupadas deliberadamente para fins de legibilidade como: Aplicações Autónomas Componentes Específicas de uma Tarefa Componentes de Geração de Projectos Componentes Específicas da Linguagem Aplicações Autónomas tdevelop/ — contém os ficheiros para configurar o &IDE; &tdevelop;: licenses/ — contém os vários textos de licenças. pics/ — contém os ficheiros de imagens usados nos ecrãs iniciais do Assistente do &tdevelop; e do Desenhador do &tdevelop;. profiles/ — contém as opções de perfis dos 'plugins'. (De momento só existe um perfil tiny (minúsculo) que define um conjunto mínimo de 'plugins' activos do &tdevelop;.) eventsrc — mantém vários textos de localização de Processo com sucesso. tdevelopui.rc — oferece os menus e barras de ferramentas básicos que o &tdevelop; usa. kdevhtml_partui.rc — oferece um item Imprimir... no menu Ficheiro, um item Copiar no menu Editar e as setas Recuar e Avançar na Barra do Navegador, para o caso de navegar num ficheiro &HTML; no 'plugin' de Documentação. kdevassistant/ — oferece os menus e barras de ferramentas do navegador de documentação do Assistente do &tdevelop;. kdevdesigner/ e kdevdesignerpart/ — oferecem os menus e barras de ferramentas para o desenhador de interfaces autónomo do &tdevelop;. Componentes Específicas de uma Tarefa kdevabbrev/ — contém os ficheiros usados pelo 'plugin' de Expansão de Abreviaturas: sources/ — contém os ficheiros de definições de palavras-chave usadas pelo comando Expandir o Texto. templates/ — contém os ficheiros de definição de modelos usados pelo comando Expandir a Abreviatura. kdevabbrev.rc — oferece os itens Expandir o Texto e Expandir a Abreviatura do menu Editar. kdevappwizard/ — contém os ficheiros usados pela componente do &appwizard;: importfiles/ — contém os ficheiros de projecto .tdevelop que controlam a inicialização de um novo projecto. imports/ — contém os modelos para configurar os ficheiros .desktop específicos de um projecto. template-common/ — contém vários ficheiros que são incluídos normalmente nas pastas de código do projecto. templates/ — contém os ficheiros de configuração que descrevem a informação a ser incluída numa dada pasta de código do projecto. *.png — as imagens de antevisão do projecto usadas pelo &appwizard;. *.tar.gz — os pacotes que contêm os ficheiros de código a serem incluídos numa pasta de um projecto novo gerada. kdevastyle/ — oferece o item para Reformatar o Código no menu Editar. kdevautoproject/ — oferece os itens para o menu Construir e para a Barra de Construção (&tdevelop;). kdevclassview/ — contém os ficheiros usados pelo 'plugin' do projecto para a Janela de Classes: pics/ — contém os ícones usados na árvore de Classes. kdevclassview.tc — oferece o item do Diagrama de Herança de Classes no menu Projectos, assim como a lista de navegação de classes na Barra de Navegação. kdevcloser/ — oferece os itens de fecho do menu Janelas. kdevctags/ — oferece o item do CTags do menu Ferramentas para o 'plugin' do projecto para a Interface do CTags. kdevcvsservice/ — oferece o ícone usado pela página de CvsService e um pequeno programa usado para adicionar um novo item ao repositório do &cvs;, sendo ambos usados no 'plugin' do projecto para a Integração com o CVS. kdevdebugger/ — oferece os itens de menu Depurar para o 'plugin' do projecto Interface do Depurador. kdevdiff/ — oferece o item do Visualizador de Diferenças no menu Ferramentas. kdevdistpart/ — oferece o item de Distribuição & Publicação no menu Projecto do 'plugin' do projecto Suporte de Empacotamento Final. kdevdocumentation/ — contém os ficheiros usados pelo 'plugin' de Documentação: en/ e pics/ — contém os ficheiros usados pela ferramenta de procura htdig. tocs/ — contém os ficheiros de descrição do conteúdo da documentação por omissão do &tdevelop; (veja a descrição em Estrutura Básica dos Ficheiros TOC do &tdevelop;). kdevpart_documentation.rc — oferece os itens relacionados com a procura no menu Ajuda. kdevdoxygen/ — oferece os itens de menu para o 'plugin' do projecto Suporte do Doxygen. kdevfilecreate/ — contém os ficheiros usados pelo Assistente de Novo Ficheiro: file-templates/ — oferece o conteúdo de texto inicial a ser colocado num ficheiro de código novo de determinado tipo. kdevpart_filecreate.rc — oferece o item Novo do menu Ficheiro. template-info.xml — contém as descrições dos tipos de ficheiros disponíveis a serem mostrados na janela de Novo Ficheiro. kdevfilter/ — oferece os itens Executar um Comando... e Filtrar a Selecção Através de um Comando... no menu Ferramentas, usado pelo 'plugin' de Filtragem e Inserção na Linha de Comandos. kdevfullscreen/ — oferece o item do Modo de Ecrã Completo no menu Ver, assim como o ícone respectivo na barra de ferramentas. kdevgrepview/ — oferece o item Procurar nos Ficheiros... no menu Editar, usado pelo 'plugin' da Interface do Grep. kdevhistory/ — oferece os itens Recuar e Avançar no menu Ver. kdevjavadebugger/ — oferece o menu de Depuração do Java para poder depurar uma aplicação de &Java;. kdevoutputviews/ — oferece os itens Erro Anterior e Erro Seguinte no menu Ver. kdevpartexplorer/ — oferece o item Explorador de Componentes do menu Ferramentas, usado pelo 'plugin' da Ferramenta do Explorador de Componentes. kdevquickopen/ — oferece o item Abertura Rápida do Ficheiro... no menu Ficheiro e o Abertura Rápida de Classe... e Abertura Rápida de Método no menu Ferramentas, que são usadas pelo 'plugin' do projecto Abertura Rápida. kdevregexptest/ — oferece o item Depurar a Expressão Regular... do menu Ferramentas, usado pelo 'plugin' de Teste de Expressões Regulares. kdevreplace/ — oferece o item Procurar-Seleccionar-Substituir... do menu Editar, usado pelo 'plugin' de Substituição. kdevtipofday/ — oferece o item da Dica do Dia do menu Ajuda, assim como um ficheiro HTML que contém as dicas disponíveis. kdevtools/ — controla os vários itens de menu criados pelo Menu Ferramentas e pelo Menu de Ferramentas Externas, oferecidas pelo 'plugin' de Adição ao Menu de Ferramentas. kdevvalgrind/ — oferece os itens de Verificação de Fugas de Memória do Valgrind e Análise com o KCachegrind do menu Depurar, usados pelo 'plugin' de Interface do Valgrind. Componentes de Geração de Projectos kdevadaproject/ — oferece os itens para o menu Construir e os ícones respectivos da barra de ferramentas para criar uma aplicação em Ada. kdevantproject/ — oferece os itens para o menu Construir quando é usado o gerador de projectos Ant. kdevautoproject/ — oferece os itens para o menu Construir, assim como os ícones respectivos da barra de ferramentas ao trabalhar com o gerador de projectos &automake; com base nas ferramentas da &GNU;. Para além disso, oferece os itens Adicionar uma Tradução e Configuração da Construção para o menu Projecto. kdevcustomproject/ — oferece os itens para o menu Construir e os ícones da barra de ferramentas respectivos, quando o projecto se baseia em Makefile's personalizadas. kdevgenericproject/ — contém as definições do menu para um gerador de projectos genérico e experimental. De momento (na versão 3.1.0) não é usado. kdevhaskellproject/ — oferece os itens para o menu Construir, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Haskell. kdevpascalproject/ — oferece os itens para o menu Construir, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Pascal. kdevtrollproject/ — oferece os itens para o menu Construir, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação que usa o gestor de projectos QMake da &Qt;. Componentes Específicas da Linguagem kdeadasupport/ — oferece os itens para o menu Ferramentas, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Ada. kdebashsupport/ — oferece os itens para o menu Ferramentas, bem como os ícones da barra de ferramentas respectivos, para criar um 'script' em Bash. kdecppsupport/ — oferece os ficheiros usados pelo &appwizard; para criar aplicações em C++: newclass/ — contém os ficheiros-modelo de inclusão e de código, a partir dos quais o &appwizard; cria os ficheiros de código correspondentes. subclassing/ — contém os ficheiros-modelo que o &appwizard; usa para configurar as declarações/definições de classes iniciais nos ficheiros de código. templates — contém os ficheiros-modelo, a partir dos quais o &appwizard; configura os ficheiros de modelo de inclusão e de código predefinidos que são usados pelo &nfwizard;. configuration — modelo inútil para adicionar macros. kdevcppsupport.rc — oferece o suporte para os itens Completar o Texto e Tornar um Membro do menu Editar, o item Mudar para a Declaração/Implementação do menu Ver e o item Nova Classe do menu Projecto, assim como um ícone Nova Classe para a Barra de Navegação. kdefortransupport/ — oferece os itens para o menu Ferramentas, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Fortran. kdehaskellsupport/ — oferece os itens para o menu Ferramentas, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Haskell. kdevjavasupport/ — contém a definição da interface necessária para desenvolver as aplicações em &Java;. kdevpascalsupport/ — contém a definição da interface necessária para desenvolver aplicações em Pascal. kdevperlsupport/ — oferece os itens do menu Projecto e Ajuda necessários para desenvolver programas em Perl. kdevphpsupport/ — contém os ficheiros de definição da interface e de PHP, necessários para desenvolver programas em PHP. kdevpythonsupport/ — oferece os itens do menu Construir e Ajuda, bem como os ícones da barras de ferramentas, necessários para desenvolver programas em Python. kdevrubysupport/ — oferece os itens do menu Construir e os ícones das barras de ferramentas respectivos que são necessários para desenvolver programas em Ruby. kdevscriptproject/ — oferece as definições da interface necessárias ara criar projectos personalizados. De momento (na versão 3.1.0) não é usado. kdevsqlsupport/ — oferece as definições de interface necessárias para desenvolver projectos em SQL. De momento (na versão 3.1.0), não é usado. Configuração do Utilizador Toda a informação sobre as opções definidas pelo utilizador é mantida em duas subpastas da $TDEHOME, nomeadamente: Configuração Específica da Aplicação na pasta $TDEHOME/share/apps/ e Ficheiro de Configuração do Recurso na pasta $TDEHOME/share/config/. Configuração Específica da Aplicação Todas as alterações do utilizador à Configuração por Omissão do &tdevelop;, assim como as opções específicas do utilizador que não são mantidas em nenhum dos Ficheiros de Configuração de Recursos encontram-se nas subpastas kdev... da pasta $TDEHOME/share/apps/. A maioria destes ficheiros de configuração são usados, todavia, por vários 'plugins' do &tdevelop; para oferecer alguns itens do menu e/ou barra de ferramentas. Como tal, são apenas de interesse no caso de algo correr realmente mal com a interface do utilizador. No caso do conteúdo destas pastas reflectir o da Configuração por Omissão, o &tdevelop; terá copiado as mesmas de $TDEDIR/apps/ para a pasta $TDEHOME/apps/ no seu arranque inicial. Todas as alterações subsequentes serão feitas apenas nestas cópias. As opções da Configuração por Omissão irão permanecer inalteradas, em qualquer dos casos. kdevabbrev/ — contém os ficheiros usados pelo 'plugin' de Expansão de Abreviaturas: sources/ — de momento vazio; o &tdevelop; usa os ficheiros de definição de palavras-chave por omissão para os comandos para Expandir o Texto. templates/ — contém os ficheiros de definição de modelos usados pelo comando Expandir a Abreviatura. kdevabbrev.rc — oferece os itens Expandir o Texto e Expandir a Abreviatura do menu Editar. kdevappwizard/ — só oferece os itens Novo Projecto... e Importar um Projecto Existente... do menu de Projectos. O &appwizard; irá então usar as opções de configuração por omissão para as suas tarefas actuais. kdevastyle/ — oferece o item para Reformatar o Código no menu Editar. kdevautoproject/ — oferece os itens para o menu Construir e da Barra de Construção (KDevelop). kdevclassview — oferece o item do Diagrama de Herança de Classes no menu Projecto, assim como a lista de navegação de classes na Barra de Navegação do 'plugin' do projecto da Lista de Classes. kdevcloser/ — oferece o item para Fechar as Janelas Seleccionadas... no menu Janelas. kdevcppsupport/ — contém a configuração actual, usada pelo &appwizard;, para criar aplicações em C++. O &appwizard; usa, contudo, o seu maior bloco de informação de configuração directamente a partir da pasta de configuração por omissão. Veja aí para ter mais detalhes. newclass/ — contém os ficheiros-modelo de inclusão e de código, a partir dos quais o &appwizard; cria os ficheiros de código correspondentes. pcs/ — contém os ficheiros de base de dados que o &tdevelop; usa para criar o Persistent Code Store (.pcs) actual de um projecto em C++ do &kde;. kdevcppsupport.rc — oferece o suporte para os itens Completar o Texto e Tornar um Membro do menu Editar, o item Mudar para a Declaração/Implementação do menu Ver e o item Nova Classe do menu Projecto, assim como um ícone Nova Classe para a Barra de Navegação. kdevctags/ — oferece o item do CTags do menu Ferramentas para o 'plugin' do projecto para a Interface do CTags. kdevdebugger/ — oferece os itens de menu Depurar para o 'plugin' do projecto Interface do Depurador. kdevdiff/ — oferece o item do Visualizador de Diferenças no menu Ferramentas. kdevdocumentation/ — contém os ficheiros usados pelo 'plugin' de Documentação para além dos ficheiros predefinidos de configuração. Veja nesse local para mais detalhes. As pastas em kdevdocumentation/ normalmente guardam apenas informações de organização. Os ficheiros de documentação configurados de momento são mantidos nos ficheiros doc...pluginrc da pasta $TDEHOME/share/config/. bookmarks/ — mantém os itens da página de Favoritos do 'plugin' de Documentação do &tdevelop;. index/ — mantém os vários ficheiros de 'cache' que o &tdevelop; usa para acelerar as pesquisas de documentação na página de Índice do 'plugin' de Documentação. search/ — contém os ficheiros usados pela ferramenta de procura htdig que serve várias chamadas de procura da página Procurar do 'plugin' de Documentação. kdevpart_documentation.rc — oferece os itens relacionados com a procura no menu Ajuda. kdevdoxygen/ — oferece os itens de menu para o 'plugin' do projecto Suporte do Doxygen. tdevelop/ — contém algumas opções actuais que o IDE &tdevelop; usa para a sua configuração básica: profiles/ — oferece a configuração do perfil do 'plugin' actual. (No início existe apenas um perfil FullIDE que define um conjunto completo de 'plugins' activos inicialmente &tdevelop;.) tdevelopui.rc — oferece os menus e barras de ferramentas básicos que o &tdevelop; usa. kdevfilecreate/ — contém os ficheiros usados pelo Assistente de Novo Ficheiro: file-templates/ — oferece o conteúdo de texto inicial a ser colocado num ficheiro de código novo de determinado tipo. Podem ser encontrados mais modelos de ficheiros na pasta de ficheiros de configuração por omissão. kdevpart_filecreate.rc — oferece o item Novo do menu Ficheiro. template-info.xml — contém as descrições dos tipos de ficheiros disponíveis a serem mostrados na janela de Novo Ficheiro. kdevfilter/ — oferece os itens Executar um Comando... e Filtrar a Selecção Através de um Comando... no menu Ferramentas, usado pelo 'plugin' de Filtragem e Inserção na Linha de Comandos. kdevfullscreen/ — oferece o item do Modo de Ecrã Completo no menu Ver, assim como o ícone respectivo na barra de ferramentas. kdevgrepview/ — oferece o item Procurar nos Ficheiros... no menu Editar, usado pelo 'plugin' da Interface do Grep. kdevoutputviews/ — oferece os itens Erro Anterior e Erro Seguinte no menu Ver. kdevpartexplorer/ — oferece o item Explorador de Componentes do menu Ferramentas, usado pelo 'plugin' da Ferramenta do Explorador de Componentes. kdevquickopen/ — oferece o item Abertura Rápida do Ficheiro... no menu Ficheiro e o Abertura Rápida de Classe... e Abertura Rápida de Método no menu Ferramentas, que são usadas pelo 'plugin' do projecto Abertura Rápida. kdevregexptest/ — oferece o item Depurar a Expressão Regular... do menu Ferramentas, usado pelo 'plugin' de Teste de Expressões Regulares. kdevreplace/ — oferece o item Procurar-Seleccionar-Substituir... do menu Editar, usado pelo 'plugin' de Substituição. kdevtipofday/ — oferece o item da Dica do Dia do menu Ajuda. O ficheiro em HTML que contém as dicas disponíveis é oferecido apenas como um ficheiro de configuração por omissão. kdevtools/ — controla os vários itens de menu criados pelo Menu Ferramentas e pelo Menu de Ferramentas Externas, oferecidas pelo 'plugin' de Adição ao Menu de Ferramentas. kdevvalgrind/ — oferece os itens de Verificação de Fugas de Memória do Valgrind e Análise com o KCachegrind do menu Depurar, usados pelo 'plugin' de Interface do Valgrind. Ficheiros de Configuração dos Recursos Existem dois grupos de ficheiros de configuração do &tdevelop; na pasta $TDEHOME/share/config/, distinguidos pelas suas sequências de caracteres envolventes: O doc...pluginrc denota os ficheiros usados pelo 'plugin' de documentação. O kdev...rc denota os ficheiros de configuração usados pelo &tdevelop; propriamente dito e pelos seus 'plugins' disponíveis. Ficheiros de Configuração Usados pelo &tdevelop; kdevabbrevrc — contém o estado actual da configuração de Abreviaturas oferecida pelo 'plugin' de Expansão de Abreviaturas. Isto apenas regista se as abreviaturas serão usadas ou não. As definições actuais das abreviaturas novas irão parar ao ficheiro $TDEHOME/share/apps/kdevabbrev/templates/templates. kdevassistantrc — mantém algum estado de configuração específico do navegador de documentação do Assistente do &tdevelop;. As opções de configuração mais comuns são partilhadas no ficheiro de configuração do IDE &tdevelop; em tdeveloprc. kdevassistantuimode4rc — mantém o estado da configuração actual do MDI (posições da acoplagem, &etc;) do navegador de documentação do Assistente do &tdevelop;. kdevclassviewrc — mantém a configuração do Modo de Visualização da página de navegação de Classes, que é oferecida pelo 'plugin' de projecto da Janela de Classes. Esta é uma opção global, ainda que a Janela de Classes possa ou não estar desactivada. Qualquer alteração nesta opção será actualizada globalmente, sempre que o projecto actual for fechado e, deste modo, afectar todos os projectos carregados subsequentemente. kdevcppsupportrc — contém algumas opções usadas para configurar os ficheiros de código CPP. Em particular, irá encontrar as opções definidas na janela de configuração do Gerador de Classes de C++ aqui registadas. kdevdocumentationrc — mantém a configuração actual do 'plugin' de Documentação. tdeveloprc — contém as opções globais que o IDE &tdevelop; IDE e o Assistente do &tdevelop; usam. tdevelopuimode4rc — mantém a configuração da MDI actual (posições de acoplagem, &etc;) do IDE &tdevelop;. kdevfileselectorrc — mantém a configuração actual do 'plugin' do Selector de Ficheiros. kdevfileviewrc — mantém as configurações de cores dos ficheiros actuais que a Integração com o CVS (Cervisia) usa na apresentação. kdevfilterrc — mantém a configuração que o 'plugin' Filtragem e Inserção da Linha de Comandos usa. kdevgrepviewrc — mantém as opções actuais do 'plugin' da Interface do Grep. kdevsnippetrc — mantém a configuração actual do 'plugin' dos Excertos de Código. kdevtoolsrc — mantém a configuração actual que o 'plugin' de Adição ao Menu Ferramentas usa. Ficheiros de Configuração Usados pelo 'Plugin' de Documentação docchmpluginrc — mantém a informação sobre os ficheiros de ajuda CHM da &Microsoft;, tal como está definido na página de configuração da Colecção de Documentação CHM. doccustompluginrc — mantém a informação sobre os ficheiros de documentação personalizados que estão definidos na página de configuração da Colecção de Documentação Personalizada. docdevhelppluginrc — mantém a informação acerca dos ficheiros de documentação do GNOME 2, tal como está definido na página de configuração da Colecção de Documentação do Devhelp. docdoxygenpluginrc — mantém a informação acerca da documentação da API gerada pelo Doxygen, tal como está definida na página de configuração da Colecção de Documentação do Doxygen. dockdevtocpluginrc — mantém a informação acerca dos ficheiros de documentação estruturada KDevelopTOC, tal como está definido na página de configuração da Colecção de Documentação do KDevelopTOC. docqtpluginrc — mantém a informação acerca dos ficheiros de documentação do QT, tal como está definido na página de configuração da Colecção de Documentação do Qt. Configuração Dependente do Projecto A maior parte da configuração dependente do projecto é mantida nos ficheiros de configuração do projecto <nome-projecto>.tdevelop e <nome-projecto>.kdevses do &tdevelop;, em vez de serem mantidos em ficheiros separados como as outras opções de configuração mais globais. Em resumo estes ficheiros são: <nome-projecto>.tdevelop — informação de configuração global do projecto. <nome-projecto>.kdevses — informação de configuração necessária para repor os comportamentos específicos da sessão actual. Ambos são ficheiros em &XML;. Eles podem ser vistos e (cuidadosamente) alterados com qualquer editor de texto. Ficheiros do Repositório Persistente de Código Existe um terceiro ficheiro de configuração do projecto, o Repositório de Código Persistente <nome-projecto>.tdevelop.pcs. Este é um ficheiro binário que mantém uma 'cache' de processamento para acelerar em grande medida a sequência de carregamento do projecto. Para além disso, este repositório mantém a informação da funcionalidade de Completação do Código do &tdevelop;. Poderão estar definidos ficheiros de Repositórios de Código Persistente na página de Completação de Código da página de configuração do projecto Específico do C++. A informação sobre estes ficheiros .pcs adicionais é mantida a nível global na pasta $TDEHOME/share/apps/kdevcppsupport/pcs/.