1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
|
<?xml version="1.0" encoding="UTF-8" ?>
<sect1 id="debugging-3-2">
<sect1info>
<title>Depuração no &quantaplus;</title>
<authorgroup>
<author><firstname>Christopher</firstname> <surname>Hornbaker</surname> <affiliation> <address><email>[email protected]</email></address>
</affiliation>
</author>
<author><firstname>Linus</firstname> <surname>McCabe</surname> <affiliation> <address><email>[email protected]</email></address>
</affiliation>
</author>
<othercredit role="translator"><firstname>Pedro</firstname><surname>Morais</surname><affiliation><address><email>[email protected]</email></address></affiliation><contrib>Tradução</contrib></othercredit>
</authorgroup>
</sect1info>
<title>Depuração no &quantaplus;</title>
<sect2 id="php-debugging-3-2">
<title>Utilizar o Depurador de &PHP;</title>
<para>Com o &quantaplus; versão 3.3, o tratamento do depurador foi reimplementado. O suporte para o depurador incorporado de &PHP; (3), agora obsoleto, foi abandonado, assim como o suporte para o depurador 'dbg'. Em vez disso, foi implementado um sistema genérico de depuração, de modo a permitir várias implementações de 'plugins'. </para>
<para>De momento, só está disponível um 'plugin' que adiciona o suporte para usar o &gubed; com o &quantaplus;. </para>
<para>Para usar um depurador no seu projecto, abra as opções do projecto e escolha um 'plugin' de depuração adequado. Para alterar as opções específicas do depurador, carregue no botão de 'Opções' ao lado da lista do 'plugin' de depuração. </para>
<sect3 id="php-debuggin-3-2-general">
<title>Uso geral</title>
<para>Logo que um projecto tenha um depurador activo, irão aparecer alguns itens adicionais na interface de utilizador do &quantaplus;: </para>
<variablelist>
<varlistentry>
<term>Menu do depurador</term>
<listitem>
<para>Irá aparecer um menu novo, onde poderá aceder à maioria das funcionalidades do depurador. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Barra de ferramentas de depuração</term>
<listitem>
<para>Irá aparecer uma barra de ferramentas com acesso aos comandos de depuração mais comuns. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Janela de ferramentas de variáveis</term>
<listitem>
<para>Uma janela onde é mostrado o conteúdo das variáveis vigiadas. Aparece do lado esquerdo, por omissão. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Janela de pontos de paragem</term>
<listitem>
<para>Uma janela onde todos os pontos de paragem, sejam eles de linhas ou condicionais, irão aparecer. Esta aparecerá em baixo por omissão. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Janela de Resultado da Depuração</term>
<listitem>
<para>Uma janela onde o resultado (em HTML) do depurador será mostrado. Aparece na área acoplável inferior por omissão. </para>
</listitem>
</varlistentry>
</variablelist>
<para>Dependo do que o 'plugin' de depuração suporta, toda a funcionalidade, ou apenas um subconjunto desta, estará disponível. </para>
<variablelist>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Sessão</guimenuitem> <guimenuitem>Iniciar uma Sessão</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Esta acção é usada para ligar ao depurador se tal for necessário ou para indicar ao 'plugin' para começar a atender os pedidos de depuração. Esta acção é despoletada por omissão quando é aberto um projecto que use um depurador, como tal não terá à partida de se preocupar com ele. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Sessão</guimenuitem> <guimenuitem>Terminar a Sessão</guimenuitem> </menuchoice>
</term>
<listitem>
<para>O oposto da opção <menuchoice> <guimenu>Depurar</guimenu> <guimenuitem>Sessão</guimenuitem> <guimenuitem>Iniciar uma Sessão</guimenuitem> </menuchoice>. Fecha a ligação ao depurador ou pára o atendimento de pedidos. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Execução</guimenuitem> <guimenuitem>Enviar um Pedido de HTTP</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Envia um pedido de HTTP para o servidor iniciar um pedido de depuração. A utilização desta acção é equivalente a usar um navegador para ver o documento actual. O resultado do pedido termina na área de Resultado da Depuração. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Execução</guimenuitem> <guimenuitem>Pausa</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Coloca um programa, actualmente em execução, em pausa </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Execução</guimenuitem> <guimenuitem>Executar</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Diz ao depurador para começar a execução do programa e enviar informações sobre as variáveis vigiadas e a linha de execução actual à medida que vai correndo. Se isto for feito quando um programa está em pausa, a execução irá prosseguir. Se for feito antes de iniciar um pedido de depuração, o programa irá começar a correr, logo que o pedido tenha sido iniciado. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Execução</guimenuitem> <guimenuitem>Salto</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Indica ao depurador para começar a execução do programa, sem enviar informações sobre as variáveis vigiadas e a linha de execução actual. Se isto for feito enquanto um programa está em pausa, a execução irá prosseguir. Se tiver terminado antes de um pedido de depuração ter iniciado, o programa irá saltar até que o pedido seja iniciado. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Execução</guimenuitem> <guimenuitem>Passo</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Diz ao depurador para executar a próxima instrução do programa sem saltar para dentro das funções ou inclusões. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Execução</guimenuitem> <guimenuitem>Saltar Para</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Diz ao depurador para executar a próxima instrução do programa, saltando para dentro das funções ou inclusões se possível. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Execução</guimenuitem> <guimenuitem>Saltar para Fora</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Diz ao depurador para executar até que saia da função actual. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Execução</guimenuitem> <guimenuitem>Ignorar</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Diz ao depurador para saltar a próxima instrução e prosseguir para a próxima, como se a actual não existisse. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Execução</guimenuitem> <guimenuitem>Matar</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Diz ao depurador para matar o programa actualmente em execução. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Pontos de Paragem</guimenuitem> <guimenuitem>Parar quando...</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Abre uma janela onde poderá definir os pontos de paragem condicionais. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Pontos de Paragem</guimenuitem> <guimenuitem>Comutar o ponto de paragem</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Activa ou desactiva um ponto de paragem na linha onde o cursor se encontra </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Pontos de Paragem</guimenuitem> <guimenuitem>Limpar os pontos de paragem</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Retira todos os pontos de paragem. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Variáveis</guimenuitem> <guimenuitem>Vigiar a variável</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Abre uma janela onde poderá introduzir uma variável ou expressão que deseje vigiar. O valor da vigia irá aparecer na janela de variáveis. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Depurar</guimenu> <guimenuitem>Variáveis</guimenuitem> <guimenuitem>Definir o valor da variável</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Abre uma janela onde poderá indicar uma variável e um valor novo para ela. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>
<sect2 id="kxsldbg-debugging-3-2">
<title>Utilizar o &kxsl; o Depurador de &XSL;</title>
<para>O &kxsl; é uma criação do Keith Isdale, assim como esta secção da documentação. O &kxsl; é uma interface para o &kde; e uma KPart para o <command>xsldbg</command>, o qual poderá encontrar em http://xsldbg.sf.net, em conjunto com muitos outros trabalhos do Keith. </para>
<para>Para iniciar o &kxsl;, seleccione os <menuchoice> <guimenu>'Plugins'</guimenu> <guimenuitem>&kxsl;</guimenuitem> </menuchoice>. </para>
<para>Veja por favor na documentação do &kxsl; mais informações sobre a sua utilização. </para>
</sect2>
</sect1>
|
