1
<appendix id="app-files">
2
<!-- LWatts (2005-04-30): A lot of this might be better as variable lists, -->
3
<!-- but it's not that big a deal. Something to be done only when there's -->
4
<!-- a lot of textual changes needed here (e.g., maybe never ) -->
14
<!-- ROLES_OF_TRANSLATORS -->
19
>Ficheiros de Configuração Usados pelo &kdevelop;</title>
22
>O &kdevelop; 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: </para>
25
><link linkend="app-files-default"
26
>Configuração por Omissão do &kdevelop;</link
27
> — os ficheiros configurados quando o &kdevelop; foi instalado. </member>
29
><link linkend="app-files-user"
30
>Configuração Orientada pelo Utilizador</link
31
> — os ficheiros que contêm as modificações do utilizador aos valores predefinidos, assim como as configurações feitas pelo próprio &kdevelop; e pelos seus 'plugins'. </member>
34
<sect1 id="app-files-default">
36
>Configuração Predefinida do &kdevelop;</title>
39
>Na instalação, o &kdevelop; grava alguns ficheiros de informação por omissão para fins de configuração nas subpastas da pasta de instalação <filename class="directory"
43
> (normalmente algo do género de <filename class="directory"
45
>, <filename class="directory"
46
>/usr/local/kde</filename
47
>, ou outra pasta de instalação definida pelo utilizador; veja em <link linkend="kdevelop-install"
48
>Instalar o &kdevelop;</link
51
<sect2 id="app-files-default-config">
53
>Configuração Predefinida do &kdevelop;</title>
56
>Só existe um ficheiro de configuração por omissão específico do &kdevelop; na pasta <filename class="directory"
59
>/share/config/</filename
69
>Este ficheiro contém as opções básicas que o &kdevelop; necessita para começar. Será copiado para a pasta do utilizador em <filename class="directory"
72
>/share/config</filename
73
>, quando o &kdevelop; não encontrar aí um ficheiro <filename
81
> <!-- app-files-default-config -->
83
<sect2 id="app-files-default-apps">
85
>Valores Predefinidos da Aplicação</title>
88
>A maioria das funcionalidades do &kdevelop; são oferecidas através de KParts. Estas são basicamente aplicações desenhadas especialmente para correr na plataforma do &kdevelop; (veja a introdução no apêndice sobre as <link linkend="plugin-tools"
89
>Ferramentas e 'Plugins'</link
90
>). 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 <filename class="directory"
93
>/share/apps/</filename
97
>Existem bastantes subpastas de configuração por omissão em <filename class="directory"
100
>/share/apps/</filename
101
>, cujos nomes começam todos por uma sequência <filename
103
>. A maioria delas são para o uso interno do &kdevelop;. Elas poderão estar agrupadas deliberadamente para fins de legibilidade como: <simplelist>
105
><link linkend="app-files-default-apps-stdalone"
106
>Aplicações Autónomas</link
109
><link linkend="app-files-default-apps-task"
110
>Componentes Específicas de uma Tarefa</link
113
><link linkend="app-files-default-apps-project"
114
>Componentes de Geração de Projectos</link
117
><link linkend="app-files-default-apps-lang"
118
>Componentes Específicas da Linguagem</link
124
<listitem id="app-files-default-apps-stdalone"
127
>Aplicações Autónomas</title>
130
><filename class="directory"
132
> — contém os ficheiros para configurar o &IDE; &kdevelop;:</para>
136
><filename class="directory"
138
> — contém os vários textos de licenças.</para
142
><filename class="directory"
144
> — contém os ficheiros de imagens usados nos ecrãs iniciais do Assistente do &kdevelop; e do Desenhador do &kdevelop;.</para
148
><filename class="directory"
150
> — contém as opções de perfis dos 'plugins'. (De momento só existe um perfil <filename
152
> (minúsculo) que define um conjunto mínimo de 'plugins' activos do &kdevelop;.)</para
158
> — mantém vários textos de localização de <quote
159
>Processo com sucesso</quote
165
>kdevelopui.rc</filename
166
> — oferece os menus e barras de ferramentas básicos que o &kdevelop; usa.</para
171
>kdevhtml_partui.rc</filename
172
> — oferece um item <guimenuitem
173
>Imprimir...</guimenuitem
176
>, um item <guimenuitem
180
> e as setas <guilabel
185
>Barra do Navegador</guilabel
186
>, para o caso de navegar num ficheiro &HTML; no 'plugin' de <guilabel
187
>Documentação</guilabel
194
><filename class="directory"
195
>kdevassistant/</filename
196
> — oferece os menus e barras de ferramentas do navegador de documentação do Assistente do &kdevelop;.</para
200
><filename class="directory"
201
>kdevdesigner/</filename
202
> e <filename class="directory"
203
>kdevdesignerpart/</filename
204
> — oferecem os menus e barras de ferramentas para o desenhador de interfaces autónomo do &kdevelop;.</para
210
><itemizedlist id="app-files-default-apps-task">
212
>Componentes Específicas de uma Tarefa</title>
213
<listitem id="app-files-default-abbrev">
215
><filename class="directory"
216
>kdevabbrev/</filename
217
> — contém os ficheiros usados pelo 'plugin' de <guilabel
218
>Expansão de Abreviaturas</guilabel
223
><filename class="directory"
225
> — contém os ficheiros de definições de palavras-chave usadas pelo comando <guilabel
226
>Expandir o Texto</guilabel
231
><filename class="directory"
232
>templates/</filename
233
> — contém os ficheiros de definição de modelos usados pelo comando <guilabel
234
>Expandir a Abreviatura</guilabel
240
>kdevabbrev.rc</filename
241
> — oferece os itens <guimenuitem
242
>Expandir o Texto</guimenuitem
244
>Expandir a Abreviatura</guimenuitem
251
<listitem id="app-files-default-appwizard">
253
><filename class="directory"
254
>kdevappwizard/</filename
255
> — contém os ficheiros usados pela componente do &appwizard;:</para>
259
><filename class="directory"
260
>importfiles/</filename
261
> — contém os ficheiros de projecto <filename
263
> que controlam a inicialização de um novo projecto.</para
267
><filename class="directory"
269
> — contém os modelos para configurar os ficheiros <filename
271
> específicos de um projecto.</para
275
><filename class="directory"
276
>template-common/</filename
277
> — contém vários ficheiros que são incluídos normalmente nas pastas de código do projecto.</para
281
><filename class="directory"
282
>templates/</filename
283
> — contém os ficheiros de configuração que descrevem a informação a ser incluída numa dada pasta de código do projecto.</para
289
> — as imagens de antevisão do projecto usadas pelo &appwizard;.</para
295
> — os pacotes que contêm os ficheiros de código a serem incluídos numa pasta de um projecto novo gerada.</para
301
><filename class="directory"
302
>kdevastyle/</filename
303
> — oferece o item para <guimenuitem
304
>Reformatar o Código</guimenuitem
311
><filename class="directory"
312
>kdevautoproject/</filename
313
> — oferece os itens para o menu <guimenu
316
>Barra de Construção (&kdevelop;)</guilabel
321
><filename class="directory"
322
>kdevclassview/</filename
323
> — contém os ficheiros usados pelo 'plugin' do projecto para a <guilabel
324
>Janela de Classes</guilabel
329
><filename class="directory"
331
> — contém os ícones usados na árvore de <guilabel
338
>kdevclassview.tc</filename
339
> — oferece o item do <guimenuitem
340
>Diagrama de Herança de Classes</guimenuitem
343
>, assim como a lista de navegação de classes na <guilabel
344
>Barra de Navegação</guilabel
351
><filename class="directory"
352
>kdevcloser/</filename
353
> — oferece os itens de fecho do menu <guimenu
359
><filename class="directory"
360
>kdevctags/</filename
361
> — oferece o item do <guimenuitem
364
>Ferramentas</guimenu
365
> para o 'plugin' do projecto para a <guilabel
366
>Interface do CTags</guilabel
371
><filename class="directory"
372
>kdevcvsservice/</filename
373
> — oferece o ícone usado pela página de <guilabel
374
>CvsService</guilabel
375
> e um pequeno programa usado para adicionar um novo item ao repositório do &cvs;, sendo ambos usados no 'plugin' do projecto para a <guilabel
376
>Integração com o CVS</guilabel
381
><filename class="directory"
382
>kdevdebugger/</filename
383
> — oferece os itens de menu <guimenu
385
> para o 'plugin' do projecto <guilabel
386
>Interface do Depurador</guilabel
391
><filename class="directory"
393
> — oferece o item do <guimenuitem
394
>Visualizador de Diferenças</guimenuitem
396
>Ferramentas</guimenu
401
><filename class="directory"
402
>kdevdistpart/</filename
403
> — oferece o item de <guimenuitem
404
>Distribuição & Publicação</guimenuitem
407
> do 'plugin' do projecto <guilabel
408
>Suporte de Empacotamento Final</guilabel
411
<listitem id="app-files-default-kdevdoc">
413
><filename class="directory"
414
>kdevdocumentation/</filename
415
> — contém os ficheiros usados pelo 'plugin' de <guilabel
416
>Documentação</guilabel
421
><filename class="directory"
423
> e <filename class="directory"
425
> — contém os ficheiros usados pela ferramenta de procura <application
431
><filename class="directory"
433
> — contém os ficheiros de descrição do conteúdo da documentação por omissão do &kdevelop; (veja a descrição em <link linkend="toc-file-structure"
434
>Estrutura Básica dos Ficheiros TOC do &kdevelop;</link
440
>kdevpart_documentation.rc</filename
441
> — oferece os itens relacionados com a procura no menu <guimenu
449
><filename class="directory"
450
>kdevdoxygen/</filename
451
> — oferece os itens de menu para o 'plugin' do projecto <guilabel
452
>Suporte do Doxygen</guilabel
455
<listitem id="app-files-default-filecreate">
457
><filename class="directory"
458
>kdevfilecreate/</filename
459
> — contém os ficheiros usados pelo <guilabel
460
>Assistente de Novo Ficheiro:</guilabel
464
><filename class="directory"
465
>file-templates/</filename
466
> — oferece o conteúdo de texto inicial a ser colocado num ficheiro de código novo de determinado tipo.</para
471
>kdevpart_filecreate.rc</filename
472
> — oferece o item <guimenuitem
481
>template-info.xml</filename
482
> — contém as descrições dos tipos de ficheiros disponíveis a serem mostrados na janela de <guilabel
483
>Novo Ficheiro</guilabel
491
><filename class="directory"
492
>kdevfilter/</filename
493
> — oferece os itens <guimenuitem
494
>Executar um Comando...</guimenuitem
496
>Filtrar a Selecção Através de um Comando...</guimenuitem
498
>Ferramentas</guimenu
499
>, usado pelo 'plugin' de <guilabel
500
>Filtragem e Inserção na Linha de Comandos</guilabel
505
><filename class="directory"
506
>kdevfullscreen/</filename
507
> — oferece o item do <guimenuitem
508
>Modo de Ecrã Completo</guimenuitem
511
>, assim como o ícone respectivo na barra de ferramentas.</para
515
><filename class="directory"
516
>kdevgrepview/</filename
517
> — oferece o item <guimenuitem
518
>Procurar nos Ficheiros...</guimenuitem
521
>, usado pelo 'plugin' da <guilabel
522
>Interface do Grep</guilabel
527
><filename class="directory"
528
>kdevhistory/</filename
529
> — oferece os itens <guimenuitem
532
>Avançar</guimenuitem
539
><filename class="directory"
540
>kdevjavadebugger/</filename
541
> — oferece o menu de <guimenu
542
>Depuração do Java</guimenu
543
> para poder depurar uma aplicação de &Java;.</para
547
><filename class="directory"
548
>kdevoutputviews/</filename
549
> — oferece os itens <guimenuitem
550
>Erro Anterior</guimenuitem
552
>Erro Seguinte</guimenuitem
559
><filename class="directory"
560
>kdevpartexplorer/</filename
561
> — oferece o item <guimenuitem
562
>Explorador de Componentes</guimenuitem
564
>Ferramentas</guimenu
565
>, usado pelo 'plugin' da <guilabel
566
>Ferramenta do Explorador de Componentes</guilabel
571
><filename class="directory"
572
>kdevquickopen/</filename
573
> — oferece o item <guimenuitem
574
>Abertura Rápida do Ficheiro...</guimenuitem
578
>Abertura Rápida de Classe...</guimenuitem
580
>Abertura Rápida de Método</guimenuitem
582
>Ferramentas</guimenu
583
>, que são usadas pelo 'plugin' do projecto <guilabel
584
>Abertura Rápida</guilabel
589
><filename class="directory"
590
>kdevregexptest/</filename
591
> — oferece o item <guimenuitem
592
>Depurar a Expressão Regular...</guimenuitem
594
>Ferramentas</guimenu
595
>, usado pelo 'plugin' de <guilabel
596
>Teste de Expressões Regulares</guilabel
601
><filename class="directory"
602
>kdevreplace/</filename
603
> — oferece o item <guimenuitem
604
>Procurar-Seleccionar-Substituir...</guimenuitem
607
>, usado pelo 'plugin' de <guilabel
608
>Substituição</guilabel
611
<listitem id="app-files-default-tips"
613
><filename class="directory"
614
>kdevtipofday/</filename
615
> — oferece o item da <guimenuitem
616
>Dica do Dia</guimenuitem
619
>, assim como um ficheiro HTML que contém as dicas disponíveis.</para
623
><filename class="directory"
624
>kdevtools/</filename
625
> — controla os vários itens de menu criados pelo <guimenu
626
>Menu Ferramentas</guimenu
628
>Menu de Ferramentas Externas</guilabel
629
>, oferecidas pelo 'plugin' de <guilabel
630
>Adição ao Menu de Ferramentas</guilabel
635
><filename class="directory"
636
>kdevvalgrind/</filename
637
> — oferece os itens de <guimenuitem
638
>Verificação de Fugas de Memória do Valgrind</guimenuitem
640
>Análise com o KCachegrind</guimenuitem
643
>, usados pelo 'plugin' de <guilabel
644
>Interface do Valgrind</guilabel
651
><itemizedlist id="app-files-default-apps-project">
653
>Componentes de Geração de Projectos</title>
656
><filename class="directory"
657
>kdevadaproject/</filename
658
> — oferece os itens para o menu <guimenu
660
> e os ícones respectivos da barra de ferramentas para criar uma aplicação em Ada.</para
664
><filename class="directory"
665
>kdevantproject/</filename
666
> — oferece os itens para o menu <guimenu
668
> quando é usado o gerador de projectos Ant.</para
672
><filename class="directory"
673
>kdevautoproject/</filename
674
> — oferece os itens para o menu <guimenu
676
>, 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 <guimenuitem
677
>Adicionar uma Tradução</guimenuitem
679
>Configuração da Construção</guimenuitem
680
> para o menu <guimenu
686
><filename class="directory"
687
>kdevcustomproject/</filename
688
> — oferece os itens para o menu <guimenu
690
> e os ícones da barra de ferramentas respectivos, quando o projecto se baseia em Makefile's personalizadas.</para
694
><filename class="directory"
695
>kdevgenericproject/</filename
696
> — 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.</para
700
><filename class="directory"
701
>kdevhaskellproject/</filename
702
> — oferece os itens para o menu <guimenu
704
>, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Haskell.</para
708
><filename class="directory"
709
>kdevpascalproject/</filename
710
> — oferece os itens para o menu <guimenu
712
>, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Pascal.</para
716
><filename class="directory"
717
>kdevtrollproject/</filename
718
> — oferece os itens para o menu <guimenu
720
>, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação que usa o gestor de projectos QMake da &Qt;.</para
726
><itemizedlist id="app-files-default-apps-lang">
728
>Componentes Específicas da Linguagem</title>
731
><filename class="directory"
732
>kdeadasupport/</filename
733
> — oferece os itens para o menu <guimenu
734
>Ferramentas</guimenu
735
>, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Ada.</para
739
><filename class="directory"
740
>kdebashsupport/</filename
741
> — oferece os itens para o menu <guimenu
742
>Ferramentas</guimenu
743
>, bem como os ícones da barra de ferramentas respectivos, para criar um 'script' em Bash.</para
745
<listitem id="app-files-default-apps-lang-cpp">
747
><filename class="directory"
748
>kdecppsupport/</filename
749
> — oferece os ficheiros usados pelo &appwizard; para criar aplicações em C++:</para>
753
><filename class="directory"
755
> — 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.</para
759
><filename class="directory"
760
>subclassing/</filename
761
> — contém os ficheiros-modelo que o &appwizard; usa para configurar as declarações/definições de classes iniciais nos ficheiros de código.</para
765
><filename class="directory"
767
> — 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;. </para
772
>configuration</filename
773
> — modelo inútil para adicionar macros.</para
778
>kdevcppsupport.rc</filename
779
> — oferece o suporte para os itens <guimenuitem
780
>Completar o Texto</guimenuitem
782
>Tornar um Membro</guimenuitem
785
>, o item <guimenuitem
786
>Mudar para a Declaração/Implementação</guimenuitem
789
> e o item <guimenuitem
790
>Nova Classe</guimenuitem
793
>, assim como um ícone <guiicon
794
>Nova Classe</guiicon
796
>Barra de Navegação</guilabel
803
><filename class="directory"
804
>kdefortransupport/</filename
805
> — oferece os itens para o menu <guimenu
806
>Ferramentas</guimenu
807
>, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Fortran.</para
811
><filename class="directory"
812
>kdehaskellsupport/</filename
813
> — oferece os itens para o menu <guimenu
814
>Ferramentas</guimenu
815
>, bem como os ícones da barra de ferramentas respectivos, para criar uma aplicação em Haskell.</para
819
><filename class="directory"
820
>kdevjavasupport/</filename
821
> — contém a definição da interface necessária para desenvolver as aplicações em &Java;.</para
825
><filename class="directory"
826
>kdevpascalsupport/</filename
827
> — contém a definição da interface necessária para desenvolver aplicações em Pascal.</para
831
><filename class="directory"
832
>kdevperlsupport/</filename
833
> — oferece os itens do menu <guimenu
837
> necessários para desenvolver programas em Perl.</para
841
><filename class="directory"
842
>kdevphpsupport/</filename
843
> — contém os ficheiros de definição da interface e de PHP, necessários para desenvolver programas em PHP.</para
847
><filename class="directory"
848
>kdevpythonsupport/</filename
849
> — oferece os itens do menu <guimenu
853
>, bem como os ícones da barras de ferramentas, necessários para desenvolver programas em Python.</para
857
><filename class="directory"
858
>kdevrubysupport/</filename
859
> — oferece os itens do menu <guimenu
861
> e os ícones das barras de ferramentas respectivos que são necessários para desenvolver programas em Ruby.</para
865
><filename class="directory"
866
>kdevscriptproject/</filename
867
> — oferece as definições da interface necessárias ara criar projectos personalizados. De momento (na versão 3.1.0) não é usado.</para
871
><filename class="directory"
872
>kdevsqlsupport/</filename
873
> — oferece as definições de interface necessárias para desenvolver projectos em SQL. De momento (na versão 3.1.0), não é usado.</para
881
> <!-- app-files-default-apps -->
884
> <!-- app-files-default -->
886
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
888
<sect1 id="app-files-user">
890
>Configuração do Utilizador</title>
893
>Toda a informação sobre as opções definidas pelo utilizador é mantida em duas subpastas da <filename class="directory"
897
>, nomeadamente: <simplelist>
899
><link linkend="app-files-user-apps"
900
>Configuração Específica da Aplicação</link
901
> na pasta <filename class="directory"
904
>/share/apps/</filename
907
><link linkend="app-files-user-config"
908
>Ficheiro de Configuração do Recurso</link
909
> na pasta <filename class="directory"
912
>/share/config/</filename
917
<sect2 id="app-files-user-apps">
919
>Configuração Específica da Aplicação</title>
922
>Todas as alterações do utilizador à <link linkend="app-files-default"
923
>Configuração por Omissão do &kdevelop;</link
924
>, assim como as opções específicas do utilizador que não são mantidas em nenhum dos <link linkend="app-files-user-config"
925
>Ficheiros de Configuração de Recursos</link
926
> encontram-se nas subpastas <filename
928
> da pasta <filename class="directory"
931
>/share/apps/</filename
934
>A maioria destes ficheiros de configuração são usados, todavia, por vários 'plugins' do &kdevelop; 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. </para>
937
>No caso do conteúdo destas pastas reflectir o da Configuração por Omissão, o &kdevelop; terá copiado as mesmas de <filename class="directory"
941
> para a pasta <filename class="directory"
945
> 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. </para
951
><filename class="directory"
952
>kdevabbrev/</filename
953
> — contém os ficheiros usados pelo 'plugin' de <guilabel
954
>Expansão de Abreviaturas</guilabel
959
><filename class="directory"
961
> — de momento vazio; o &kdevelop; usa os ficheiros de <link linkend="app-files-default-abbrev"
962
>definição de palavras-chave por omissão</link
963
> para os comandos para <guilabel
964
>Expandir o Texto</guilabel
969
><filename class="directory"
970
>templates/</filename
971
> — contém os ficheiros de definição de modelos usados pelo comando <guilabel
972
>Expandir a Abreviatura</guilabel
978
>kdevabbrev.rc</filename
979
> — oferece os itens <guimenuitem
980
>Expandir o Texto</guimenuitem
982
>Expandir a Abreviatura</guimenuitem
992
><filename class="directory"
993
>kdevappwizard/</filename
994
> — só oferece os itens <guimenuitem
995
>Novo Projecto...</guimenuitem
997
>Importar um Projecto Existente...</guimenuitem
998
> do menu de <guimenu
1000
>. O &appwizard; irá então usar as <link linkend="app-files-default-appwizard"
1001
>opções de configuração por omissão</link
1002
> para as suas tarefas actuais.</para>
1006
><filename class="directory"
1007
>kdevastyle/</filename
1008
> — oferece o item para <guimenuitem
1009
>Reformatar o Código</guimenuitem
1016
><filename class="directory"
1017
>kdevautoproject/</filename
1018
> — oferece os itens para o menu <guimenu
1021
>Barra de Construção (KDevelop)</guilabel
1026
><filename class="directory"
1027
>kdevclassview</filename
1028
> — oferece o item do <guimenuitem
1029
>Diagrama de Herança de Classes</guimenuitem
1032
>, assim como a lista de navegação de classes na <guilabel
1033
>Barra de Navegação</guilabel
1034
> do 'plugin' do projecto da <guilabel
1035
>Lista de Classes</guilabel
1040
><filename class="directory"
1041
>kdevcloser/</filename
1042
> — oferece o item para <guimenuitem
1043
>Fechar as Janelas Seleccionadas...</guimenuitem
1050
><filename class="directory"
1051
>kdevcppsupport/</filename
1052
> — 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 <link linkend="app-files-default-apps-lang-cpp"
1053
>pasta de configuração por omissão</link
1054
>. Veja aí para ter mais detalhes.</para>
1058
><filename class="directory"
1059
>newclass/</filename
1060
> — 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.</para>
1064
><filename class="directory"
1066
> — contém os ficheiros de base de dados que o &kdevelop; usa para criar o Persistent Code Store (<filename
1068
>) actual de um projecto em C++ do &kde;.</para>
1073
>kdevcppsupport.rc</filename
1074
> — oferece o suporte para os itens <guimenuitem
1075
>Completar o Texto</guimenuitem
1077
>Tornar um Membro</guimenuitem
1080
>, o item <guimenuitem
1081
>Mudar para a Declaração/Implementação</guimenuitem
1084
> e o item <guimenuitem
1085
>Nova Classe</guimenuitem
1088
>, assim como um ícone <guiicon
1089
>Nova Classe</guiicon
1091
>Barra de Navegação</guilabel
1098
><filename class="directory"
1099
>kdevctags/</filename
1100
> — oferece o item do <guimenuitem
1103
>Ferramentas</guimenu
1104
> para o 'plugin' do projecto para a <guilabel
1105
>Interface do CTags</guilabel
1110
><filename class="directory"
1111
>kdevdebugger/</filename
1112
> — oferece os itens de menu <guimenu
1114
> para o 'plugin' do projecto <guilabel
1115
>Interface do Depurador</guilabel
1120
><filename class="directory"
1121
>kdevdiff/</filename
1122
> — oferece o item do <guimenuitem
1123
>Visualizador de Diferenças</guimenuitem
1125
>Ferramentas</guimenu
1130
><filename class="directory"
1131
>kdevdocumentation/</filename
1132
> — contém os ficheiros usados pelo 'plugin' de <guilabel
1133
>Documentação</guilabel
1134
> para além dos <link linkend="app-files-default-kdevdoc"
1135
> ficheiros predefinidos de configuração</link
1136
>. Veja nesse local para mais detalhes.</para>
1138
>As pastas em <filename class="directory"
1139
>kdevdocumentation/</filename
1140
> normalmente guardam apenas informações de organização. Os ficheiros de documentação configurados de momento são mantidos nos <link linkend="app-files-user-config-doc"
1143
>doc...pluginrc</filename
1146
> da pasta <filename class="directory"
1149
>/share/config/</filename
1154
><filename class="directory"
1155
>bookmarks/</filename
1156
> — mantém os itens da página de <guilabel
1157
>Favoritos</guilabel
1158
> do 'plugin' de <guilabel
1159
>Documentação</guilabel
1160
> do &kdevelop;.</para>
1164
><filename class="directory"
1166
> — mantém os vários ficheiros de 'cache' que o &kdevelop; usa para acelerar as pesquisas de documentação na página de <guilabel
1168
> do 'plugin' de <guilabel
1169
>Documentação</guilabel
1174
><filename class="directory"
1176
> — contém os ficheiros usados pela ferramenta de procura <application
1178
> que serve várias chamadas de procura da página <guilabel
1180
> do 'plugin' de <guilabel
1181
>Documentação</guilabel
1187
>kdevpart_documentation.rc</filename
1188
> — oferece os itens relacionados com a procura no menu <guimenu
1196
><filename class="directory"
1197
>kdevdoxygen/</filename
1198
> — oferece os itens de menu para o 'plugin' do projecto <guilabel
1199
>Suporte do Doxygen</guilabel
1204
><filename class="directory"
1205
>kdevelop/</filename
1206
> — contém algumas opções actuais que o IDE &kdevelop; usa para a sua configuração básica:</para>
1210
><filename class="directory"
1211
>profiles/</filename
1212
> — oferece a configuração do perfil do 'plugin' actual. (No início existe apenas um perfil <filename
1214
> que define um conjunto completo de 'plugins' activos inicialmente &kdevelop;.)</para
1219
>kdevelopui.rc</filename
1220
> — oferece os menus e barras de ferramentas básicos que o &kdevelop; usa.</para
1226
><filename class="directory"
1227
>kdevfilecreate/</filename
1228
> — contém os ficheiros usados pelo <guilabel
1229
>Assistente de Novo Ficheiro:</guilabel
1234
><filename class="directory"
1235
>file-templates/</filename
1236
> — 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 <link linkend="app-files-default-filecreate"
1237
>ficheiros de configuração por omissão</link
1243
>kdevpart_filecreate.rc</filename
1244
> — oferece o item <guimenuitem
1253
>template-info.xml</filename
1254
> — contém as descrições dos tipos de ficheiros disponíveis a serem mostrados na janela de <guilabel
1255
>Novo Ficheiro</guilabel
1262
><filename class="directory"
1263
>kdevfilter/</filename
1264
> — oferece os itens <guimenuitem
1265
>Executar um Comando...</guimenuitem
1267
>Filtrar a Selecção Através de um Comando...</guimenuitem
1269
>Ferramentas</guimenu
1270
>, usado pelo 'plugin' de <guilabel
1271
>Filtragem e Inserção na Linha de Comandos</guilabel
1276
><filename class="directory"
1277
>kdevfullscreen/</filename
1278
> — oferece o item do <guimenuitem
1279
>Modo de Ecrã Completo</guimenuitem
1282
>, assim como o ícone respectivo na barra de ferramentas.</para>
1286
><filename class="directory"
1287
>kdevgrepview/</filename
1288
> — oferece o item <guimenuitem
1289
>Procurar nos Ficheiros...</guimenuitem
1292
>, usado pelo 'plugin' da <guilabel
1293
>Interface do Grep</guilabel
1298
><filename class="directory"
1299
>kdevoutputviews/</filename
1300
> — oferece os itens <guimenuitem
1301
>Erro Anterior</guimenuitem
1303
>Erro Seguinte</guimenuitem
1310
><filename class="directory"
1311
>kdevpartexplorer/</filename
1312
> — oferece o item <guimenuitem
1313
>Explorador de Componentes</guimenuitem
1315
>Ferramentas</guimenu
1316
>, usado pelo 'plugin' da <guilabel
1317
>Ferramenta do Explorador de Componentes</guilabel
1322
><filename class="directory"
1323
>kdevquickopen/</filename
1324
> — oferece o item <guimenuitem
1325
>Abertura Rápida do Ficheiro...</guimenuitem
1329
>Abertura Rápida de Classe...</guimenuitem
1331
>Abertura Rápida de Método</guimenuitem
1333
>Ferramentas</guimenu
1334
>, que são usadas pelo 'plugin' do projecto <guilabel
1335
>Abertura Rápida</guilabel
1340
><filename class="directory"
1341
>kdevregexptest/</filename
1342
> — oferece o item <guimenuitem
1343
>Depurar a Expressão Regular...</guimenuitem
1345
>Ferramentas</guimenu
1346
>, usado pelo 'plugin' de <guilabel
1347
>Teste de Expressões Regulares</guilabel
1352
><filename class="directory"
1353
>kdevreplace/</filename
1354
> — oferece o item <guimenuitem
1355
>Procurar-Seleccionar-Substituir...</guimenuitem
1358
>, usado pelo 'plugin' de <guilabel
1359
>Substituição</guilabel
1364
><filename class="directory"
1365
>kdevtipofday/</filename
1366
> — oferece o item da <guimenuitem
1367
>Dica do Dia</guimenuitem
1370
>. O ficheiro em HTML que contém as dicas disponíveis é oferecido apenas como um <link linkend="app-files-default-tips"
1371
>ficheiro de configuração por omissão</link
1376
><filename class="directory"
1377
>kdevtools/</filename
1378
> — controla os vários itens de menu criados pelo <guimenu
1379
>Menu Ferramentas</guimenu
1381
>Menu de Ferramentas Externas</guilabel
1382
>, oferecidas pelo 'plugin' de <guilabel
1383
>Adição ao Menu de Ferramentas</guilabel
1388
><filename class="directory"
1389
>kdevvalgrind/</filename
1390
> — oferece os itens de <guimenuitem
1391
>Verificação de Fugas de Memória do Valgrind</guimenuitem
1393
>Análise com o KCachegrind</guimenuitem
1396
>, usados pelo 'plugin' de <guilabel
1397
>Interface do Valgrind</guilabel
1403
> <!-- app-files-user-apps -->
1405
<sect2 id="app-files-user-config">
1407
>Ficheiros de Configuração dos Recursos</title>
1410
>Existem dois grupos de ficheiros de configuração do &kdevelop; na pasta <filename class="directory"
1413
>/share/config/</filename
1414
>, distinguidos pelas suas sequências de caracteres envolventes: <simplelist>
1418
>doc...pluginrc</filename
1420
> denota os <link linkend="app-files-user-config-doc"
1421
>ficheiros usados pelo 'plugin' de documentação.</link
1426
>kdev...rc</filename
1428
> denota os <link linkend="app-files-user-config-kdev"
1429
>ficheiros de configuração usados pelo &kdevelop;</link
1430
> propriamente dito e pelos seus 'plugins' disponíveis.</member>
1434
<itemizedlist id="app-files-user-config-kdev">
1436
>Ficheiros de Configuração Usados pelo &kdevelop;</title>
1440
>kdevabbrevrc</filename
1441
> — contém o estado actual da configuração de <guilabel
1442
>Abreviaturas</guilabel
1443
> oferecida pelo 'plugin' de <guilabel
1444
>Expansão de Abreviaturas</guilabel
1448
>Isto apenas regista se as abreviaturas serão usadas ou não. As definições actuais das abreviaturas novas irão parar ao ficheiro <filename
1451
>/share/apps/kdevabbrev/templates/templates</filename
1458
>kdevassistantrc</filename
1459
> — mantém algum estado de configuração específico do navegador de documentação do Assistente do &kdevelop;.</para>
1462
>As opções de configuração mais comuns são partilhadas no ficheiro de configuração do IDE &kdevelop; em <filename
1463
>kdeveloprc</filename
1470
>kdevassistantuimode4rc</filename
1471
> — mantém o estado da configuração actual do MDI (posições da acoplagem, &etc;) do navegador de documentação do Assistente do &kdevelop;.</para
1476
>kdevclassviewrc</filename
1477
> — mantém a configuração do <guilabel
1478
>Modo de Visualização</guilabel
1479
> da página de navegação de <guilabel
1481
>, que é oferecida pelo 'plugin' de projecto da <guilabel
1482
>Janela de Classes</guilabel
1486
>Esta é uma opção global, ainda que a <guilabel
1487
>Janela de Classes</guilabel
1488
> 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.</para
1494
>kdevcppsupportrc</filename
1495
> — 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 <guilabel
1496
>Gerador de Classes de C++</guilabel
1497
> aqui registadas.</para
1502
>kdevdocumentationrc</filename
1503
> — mantém a configuração actual do 'plugin' de <guilabel
1504
>Documentação</guilabel
1510
>kdeveloprc</filename
1511
> — contém as opções globais que o IDE &kdevelop; IDE e o Assistente do &kdevelop; usam.</para
1516
>kdevelopuimode4rc</filename
1517
> — mantém a configuração da MDI actual (posições de acoplagem, &etc;) do IDE &kdevelop;.</para
1522
>kdevfileselectorrc</filename
1523
> — mantém a configuração actual do 'plugin' do <guilabel
1524
>Selector de Ficheiros</guilabel
1530
>kdevfileviewrc</filename
1531
> — mantém as configurações de cores dos ficheiros actuais que a <guilabel
1532
>Integração com o CVS (Cervisia)</guilabel
1533
> usa na apresentação.</para
1538
>kdevfilterrc</filename
1539
> — mantém a configuração que o 'plugin' <guilabel
1540
>Filtragem e Inserção da Linha de Comandos</guilabel
1546
>kdevgrepviewrc</filename
1547
> — mantém as opções actuais do 'plugin' da <guilabel
1548
>Interface do Grep</guilabel
1554
>kdevsnippetrc</filename
1555
> — mantém a configuração actual do 'plugin' dos <guilabel
1556
>Excertos de Código</guilabel
1562
>kdevtoolsrc</filename
1563
> — mantém a configuração actual que o 'plugin' de <guilabel
1564
>Adição ao Menu Ferramentas</guilabel
1569
<itemizedlist id="app-files-user-config-doc">
1571
>Ficheiros de Configuração Usados pelo 'Plugin' de Documentação</title>
1575
>docchmpluginrc</filename
1576
> — mantém a informação sobre os ficheiros de ajuda CHM da &Microsoft;, tal como está definido na página de configuração da <guilabel
1577
>Colecção de Documentação CHM</guilabel
1583
>doccustompluginrc</filename
1584
> — mantém a informação sobre os ficheiros de documentação personalizados que estão definidos na página de configuração da <guilabel
1585
>Colecção de Documentação Personalizada</guilabel
1591
>docdevhelppluginrc</filename
1592
> — 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 <guilabel
1593
>Colecção de Documentação do Devhelp</guilabel
1599
>docdoxygenpluginrc</filename
1600
> — 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 <guilabel
1601
>Colecção de Documentação do Doxygen</guilabel
1607
>dockdevtocpluginrc</filename
1608
> — mantém a informação acerca dos ficheiros de documentação estruturada KDevelopTOC, tal como está definido na página de configuração da <guilabel
1609
>Colecção de Documentação do KDevelopTOC</guilabel
1615
>docqtpluginrc</filename
1616
> — mantém a informação acerca dos ficheiros de documentação do QT, tal como está definido na página de configuração da <guilabel
1617
>Colecção de Documentação do Qt</guilabel
1623
> <!-- app-files-user-config -->
1626
> <!-- app-files-user -->
1628
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
1630
<sect1 id="app-files-project">
1632
>Configuração Dependente do Projecto</title>
1635
>A maior parte da configuração dependente do projecto é mantida nos ficheiros de configuração do projecto <filename
1636
><nome-projecto>.kdevelop</filename
1638
><nome-projecto>.kdevses</filename
1639
> do &kdevelop;, em vez de serem mantidos em ficheiros separados como as outras opções de configuração mais globais. Em resumo estes ficheiros são: </para>
1643
><nome-projecto>.kdevelop</filename
1644
> — informação de configuração global do projecto.</member>
1647
><nome-projecto>.kdevses</filename
1648
> — informação de configuração necessária para repor os comportamentos específicos da sessão actual.</member>
1651
>Ambos são ficheiros em &XML;. Eles podem ser vistos e (cuidadosamente) alterados com qualquer editor de texto. </para>
1655
>Ficheiros do Repositório Persistente de Código</title>
1658
>Existe um terceiro ficheiro de configuração do projecto, o Repositório de Código Persistente <filename
1659
><nome-projecto>.kdevelop.pcs</filename
1660
>. 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 <guilabel
1661
>Completação do Código</guilabel
1662
> do &kdevelop;. </para>
1666
>Poderão estar definidos ficheiros de Repositórios de Código Persistente na página de <guilabel
1667
>Completação de Código</guilabel
1668
> da página de configuração do projecto <guilabel
1669
>Específico do C++</guilabel
1670
>. A informação sobre estes ficheiros <filename
1672
> adicionais é mantida a nível global na pasta <filename class="directory"
1675
>/share/apps/kdevcppsupport/pcs/</filename
1681
> <!-- app-files-project -->
1684
> <!-- app-files -->