1Tutorial do Emacs. Veja no fim as condi��es para c�pia.
2
3Os comandos do Emacs geralmente envolvem a tecla CONTROL (algumas vezes
4nomeada CTRL ou CTL) ou a tecla META (algumas vezes nomeada EDIT ou
5ALT). Antes de escrever isso tudo toda vez, usaremos as seguintes
6abrevia��es:
7
8 C-<chr>  Significa pressionar a tecla CONTROL enquanto digitar o
9          caractere <chr>.
10	  Assim, C-f seria: Pressionar a tecla CONTROL e digitar f.
11 M-<chr>  Significa pressionar a tecla META, EDIT ou ALT enquanto
12          digitar <chr>.
13	  Se n�o tiver META, EDIT ou ALT, no lugar digite ESC e depois
14          <chr>. Escrevemos <ESC> para tecla ESC.
15
16
17Nota importante: para terminar a sess�o do Emacs, digite C-x C-c. (Dois
18caracteres.) Os caracteres ">>" na margem esquerda indicam dire��es para
19voc� tentar usar um comando. Por exemplo:
20<<Linhas vazias inseridas ao redor da linha seguinte por
21ajuda-com-tutorial>>
22[Metade da p�gina em branco para prop�sitos did�ticos. O texto continua
23abaixo]
24>>  Agora digite C-v (Ver pr�xima tela) para ir para pr�xima tela.
25       (v� em frente, fa�a isso pressionando a tecla CONTROL enquanto
26       digitar v).
27       De agora em diante, voc� deve fazer isso de novo sempre que voc�
28       terminar de ler a tela.
29
30Note que tem uma sobreposi��o de duas linhas quando voc� move de tela em
31tela; isso fornece uma continuidade para que voc� continue lendo o
32texto.
33
34A primeira coisa que voc� precisa saber � como se mover de um lugar a
35outro no texto. Voc� j� sabe como mover para pr�xima tela, com
36C-v. Para mover para tr�s uma tela, digite M-v (pressione a tecla
37META enquanto digita v, ou digite <ESC>v se o seu teclado n�o tiver a tecla
38META, EDIT ou ALT).
39
40>>  Tente digitar M-v e depois C-v, algumas vezes.
41
42
43* SUM�RIO
44---------
45
46Os comandos a seguir s�o �teis para visualizar telas inteiras
47
48        C-v     Move para tela inteira posterior
49	M-x     Move para tela inteira anterior
50	C-l     Limpa a tela e re-mostr� todo o texto, movendo o texto ao
51		redor do cursor para o centro da tela. (Isso �
52		control-L, n�o control-1.)
53
54>> Encontre o cursor, e note o texto que est� perto dele.
55   Digite C-l.
56   Encontre o cursor novamente e perceba que o mesmo texto continua
57   perto do cursor.
58
59
60* CONTROLE B�SICO DO CURSOR
61---------------------------
62
63Movendo de uma tela inteira para outra tela cheia � �til, mas como voc�
64move para um lugar especifico com o mesmo texto na tela?
65
66Existem diversas maneiras para voc� poder fazer isso. A maneira mais
67b�sica � utilizar os comandos C-p, C-b, C-f e C-n. Cada um desses
68comandos movem o cursor uma linha ou coluna na tela em uma dire��o
69particular. Aqui est� uma tabela mostrando esses quatro comandos e as
70dire��es que eles movem:
71
72                         Linha anterior, C-p
73			          :
74				  :
75    Traz, C-b .... Posi��o corrente do cursor .... Frente, C-f
76				  :
77				  :
78                          Linha posterior, C-n
79
80>> Mova o cursor para a linha no meio do diagrama acima utilizando C-n
81   ou C-p. Digite C-l para ver o diagrama inteiro centralizado na tela.
82
83Voc� provavelmente achar� isso f�cil pensando neles pela letra: P para
84Previous (anterior), N para Next (Posterior), B para Backward (tr�s) e F
85para Forward (frente). Estes s�o os comandos b�sicos de posicionamento
86de cursor e voc� os estar� utilizando a TODO tempo, ent�o seria �timo
87se voc� os aprendesse agora.
88
89>> Fa�a alguns C-n's para trazer o cursor abaixo desta linha.
90
91>> Mova para a linha com C-f's e depois para cima com C-p's.
92   Veja o que C-p faz quando o cursor est� no meio da linha.
93
94Cada linha de texto termina com um caractere de nova linha, que serve
95para separar da pr�xima linha. No fim da �ltima linha deve ter um
96caractere de nova linha (mas n�o � exigido pelo Emacs).
97
98>> Tente digitar C-b no come�o da linha. O cursor deve mover para o fim
99   da linha anterior. Isso acontece por que ele se moveu para tr�s
100   atrav�s do caractere de nova linha.
101
102C-f pode mover o cursor atrav�s de uma Nova linha do mesmo jeito que
103    C-b.
104
105>> Fa�a mais alguns C-b's, assim voc� percebe onde o est� o cursor.
106   Depois alguns C-f's para retornar para o fim da linha.
107   Depois mais um C-f para mover para linha seguinte.
108
109Quando voc� move o cursor passando o topo ou o rodap� da tela, o pr�ximo
110texto al�m da borda desloca-se na tela. Isso � chamado rolagem. Isso
111ativa o Emacs para mover o cursor para o lugar especificado no texto sem
112mov�-lo fora da tela.
113
114>> Tente mover o cursor fora do rodap� da tela com C-n, e veja o que
115   acontece.
116
117Se mover por caracteres � muito lento, voc� pode se mover por
118palavras. M-f (Meta-f) move uma palavra para frente e M-b uma palavra
119para tr�s.
120
121>> Digite alguns M-f's e M-b's
122
123Quando voc� est� no meio de uma palavra, M-f move o cursor para o fim da
124mesma. Quando voc� est� em um espa�o em branco no meio de duas palavras,
125M-f move o cursor para o fim da palavra seguinte. M-b funciona do mesmo
126jeito na dire��o contraria.
127
128>> Digite M-f e M-b algumas vezes, intercalado com C-f's e C-b's assim
129   voc� pode observar a a��o do M-f e M-b de varias lugares dentro e no
130   meio de palavras.
131
132Observe o paralelismo entre C-f e C-b por um lado, e M-f e M-b por outro
133lado. Muito freq�entemente os caracteres Meta s�o usados para opera��es
134relacionadas com as unidades definidas pela linguagem (palavras,
135senten�as, par�grafos), enquanto caracteres Control operam nas unidades
136b�sicas que s�o independente do que voc� est� editando (caracteres,
137linhas, etc).
138
139Esse paralelismo aplica-se entre linhas e senten�as: C-a e C-e move o
140cursor para o come�o ou fim da linha, e M-a e M-e move o cursor para o
141come�o ou fim da senten�a.
142
143>> Tente alguns C-a's, e depois alguns C-e's.
144   Tente alguns M-a's, e depois alguns M-e's.
145
146Veja como repetidos C-a's fazem nada, mas repetidos M-a's mant�m movendo
147mais uma senten�a. Embora estes n�o sejam completamente an�logos, cada
148um parece natural.
149
150A posi��o do cursor no texto � tamb�m chamado "ponto" (point). Para
151parafrasear, o cursor mostra na tela onde o ponto � encontrado no texto.
152
153Aqui est� um simples sum�rio das opera��es de movimento de cursor,
154incluindo comandos de movimento de palavra e senten�a.
155
156	C-f     Move o cursor um caractere para frente
157	C-b     Move o cursor um caractere para tr�s
158
159	M-f     Move o cursor uma palavra para frente
160	M-b	Move o cursor uma palavra para tr�s
161
162	C-n	Move o cursor para linha posterior
163	C-p	Move o cursor para linha anterior
164
165	C-a	Move o cursor para o come�o da linha
166	C-e	Move o cursor para o fim da linha
167
168	M-a     Move o cursor para tr�s no come�o da senten�a
169	M-e     Move o cursor para frente no fim da senten�a
170
171>> Tente agora todos estes comandos algumas vezes para praticar.
172   Estes s�o os comandos mais utilizados.
173
174Outros dois comandos de movimento de cursor importantes s�o M-< (Meta
175Menor-que), o qual move o cursor para o come�o de todo o texto, e M->
176(Meta Maior-que), o qual move para o fim de todo o texto.
177
178Na maioria dos terminais, o "<" � acima da v�rgula, ent�o voc� precisa
179utilizar a tecla shift para digit�-la. Nestes terminais voc� precisa
180utilizar a tecla shift para digitar M-< tamb�m; sem a tecla shift, voc�
181estaria teclando M-virgula.
182
183>> Tente agora M-<, para mover o cursor ao come�o do tutorial.
184   Use ent�o C-v repetidamente para trazer o cursor novamente aqui.
185
186>> Tente agora M->, para mover o cursor ao fim do tutorial.
187   Use ent�o M-v repetidamente para trazer o cursor novamente aqui.
188
189Voc� tamb�m pode mover o cursor com as setas, se o seu terminal tem
190teclas com setas. N�s recomendamos aprender C-b, C-f, C-n e C-p por tr�s
191raz�es. Primeira, elas funcionam em todos os terminais. Segunda, uma vez
192que voc� ganhar pr�tica usando o Emacs, voc� descobrir� que digitar
193nestes caracteres Control � mais r�pido do que digitar nas setas (porque
194voc� n�o tem que mover suas m�os t�o longe da posi��o de
195digita��o). Terceira, uma vez que voc� tiver o h�bito de utilizar estes
196comandos de caracteres Control, voc� pode facilmente aprender como usar
197outros comandos avan�ados de movimenta��o do cursor.
198
199A maioria dos comandos do Emacs aceitam argumentos num�ricos; para
200maioria dos comandos, isso serve como um fator de repeti��o. A maneira
201que voc� da a um comando uma repeti��o teclando C-u e depois os d�gitos
202antes de digitar o comando. Se voc� tem o META (EDIT ou ALT), tem outra
203alternativa para digitar um argumento num�rico: digite os d�gitos
204enquanto pressionando a tecla META. N�s recomendamos aprender o m�todo
205C-u porque funciona em todos os terminais. O argumento num�rico tamb�m �
206chamado de "argumento prefixo", porque voc� digita o argumento antes do
207comando que ele se aplica.
208
209Por exemplo, C-u 8 C-f move o cursor oito caracteres para frente
210
211>> Tente usar C-n ou C-p com um argumento num�rico, para mover o
212   cursor para um linha perto dessa com um �nico comando.
213
214A maioria dos comandos usam o argumento num�rico para um fator de
215repeti��o, mas alguns comandos usam isso de outra maneira. Diversos
216comandos (mas nenhum daqueles comandos que voc� tenha aprendido at�
217agora) usam isso como uma marca -- a presen�a de um argumento prefixo,
218independente do seu valor, faz o comando fazer alguma coisa diferente.
219
220C-v e M-v s�o outro tipo de exce��o. Quando voc� da um argumento, eles
221rolam a tela para cima ou para baixo por aquele n�mero de linhas, de
222prefer�ncia com a tela cheia. Por exemplo, C-u 8 C-v rola a tela 8
223linhas.
224
225>> Tente agora digitar C-u 8 C-v.
226
227Isso deve ter rolado a tela para cima 8 linhas. Se voc� quiser rolar a
228tela para baixo novamente, voc� pode dar um argumento para o M-v.
229
230Se voc� est� usando um display com janelas, como o X11 ou MS-Windows,
231deve ter uma �rea retangular alta chamada barra de rolagem na m�o
232esquerda da janela do Emacs. Voc� pode rolar o texto clicando o mouse na
233barra de rolagem.
234
235>> Tente pressionar o bot�o do meio no topo da �rea destacada junto a
236   barra de rolagem. Isso deve rolar o texto para uma determinada
237   posi��o dependendo de qu�o alto ou baixo voc� clicar.
238
239>> Tente mover o mouse para cima e para baixo, enquanto pressionar o
240   bot�o do meio. Voc� ver� que o texto rolar� para cima e baixo assim
241   que voc� mover o mouse.
242
243
244* QUANDO O EMACS PARECE MORTO
245-----------------------------
246
247Se o Emacs parar de responder os seus comandos, voc� pode seguramente
248par�-lo digitando C-g. Voc� pode utilizar C-g para parar um comando que
249est� levando muito tempo para executar.
250
251Voc� tamb�m pode utilizar C-g para interromper um argumento num�rico ou
252o inicio de um comando que voc� n�o quer terminar.
253
254>> Digite C-u 100 para fazer um argumento num�rico de 100, e depois
255   digite C-g. Agora digite C-f. O Cursor deve mover apenas um
256   caractere, porque voc� cancelou o argumento com C-g.
257
258Se voc� digitou um <ESC> por engano, voc� pode sair dele com um c-g.
259
260
261* COMANDOS DESABILITADOS
262------------------------
263
264Alguns comandos do Emacs s�o "desabilitados" para que os usu�rios
265iniciantes n�o utilizem por acidente.
266
267Se voc� digita um dos comandos desabilitados, o Emacs mostrar� uma
268mensagem dizendo qual comando foi, e pergunta se voc� quer seguir e
269executar o comando.
270
271Se voc� realmente quiser tentar o comando, digite Espa�o na resposta da
272pergunta. Normalmente, se voc� n�o quer executar o comando desabilitado,
273responda a pergunta com "n".
274
275>> Digite C-x C-l (que � um comando desabilitado),
276   e ent�o digite n para responder a pergunta.
277
278
279* JANELAS
280---------
281
282O Emacs pode ter diversas janelas, cada uma mostrando seu pr�prio
283texto. N�s vamos explicar mais tarde como utilizar estas m�ltiplas
284janelas. Neste momento nos queremos explicar como se livrar das janelas
285extras e voltar a edi��o b�sica em uma janela. � simples:
286
287	C-x 1	Uma janela (mate todas as outras janelas).
288
289Isto � Control-x seguido pelo digito 1. C-x 1 expande a janela que est�
290com o cursor, para ocupar a tela inteira. Ela remove todas as outras
291janelas.
292
293>> Mova o cursor para esta linha e digite C-u 0 C-l.
294>> Digite Control-h k Control-f.
295   Veja como esta janela diminui, enquanto uma nova aparece para mostrar
296   a documenta��o do comando Control-f.
297
298>> Digite C-x 1 e veja a listagem de documenta��o desaparecer.
299
300Este comando � diferente dos outros que voc� aprendeu por isso ele
301consiste em dois caracteres. Ele inicia com o caractere Control-x. Tem
302uma grande serie de comandos que iniciam com Control-x; a maioria deles
303tem a ver com janelas, arquivos, buffers, e coisas relacionadas. Estes
304comandos tem dois, tr�s ou quatro caracteres de tamanho.
305
306
307* INSERINDO E REMOVENDO
308-----------------------
309
310Se voc� quiser inserir um texto, apenas digite o texto. Os caracteres
311que voc� ver�, como A, 7, *, etc. s�o vistos pelo Emacs como texto e s�o
312inseridos imediatamente. Digite <Return> para inserir um caractere de
313nova linha.
314
315Voc� pode remover o �ltimo caractere que voc� inseriu digitando
316<Delete>. <Delete> � uma tecla no teclado, que est� nomeado como
317"Del". Em algumas casos, a tecla "Backspace" serve como o <Delete>, mas
318nem sempre!
319
320Mas geralmente, <Delete> remove o caractere imediatamente anterior a
321posi��o corrente do cursor.
322
323>> Fa�a isso agora - Digite alguns caracteres, ent�o remova-os
324   digitando <Delete> algumas vezes. N�o se preocupe em modificar este
325   arquivo; voc� n�o alterar� o arquivo principal. Esta � a sua c�pia
326   pessoal dele.
327
328Quando uma linha de texto fica muito grande na tela, a linha do texto �
329continuada na linha seguinte. Uma barra invertida ("\") na margem
330direita indica a linha que foi continuada.
331
332>> Insira texto at� que voc� alcance a margem direita, e mantenha
333   inserindo. Voc� ver� a linha de continua��o aparecer.
334
335>> Utilize <Delete> para remover o texto at� a linha caber em uma linha
336   novamente. A linha de continua��o ir� embora.
337
338Voc� pode remover o caractere de nova linha como qualquer outro
339caracter. Removendo o caractere de nova linha entre duas linhas voc�
340juntar� as duas em uma �nica linha. Se o resultado for muito longo para
341acomodar na largura da tela, aparecer� um caractere de continua��o.
342
343>> Mova o cursor para o inicio da linha e digite <Delete>. Isso juntar�
344   esta linha com a anterior.
345
346>> Digite <Return> para re-inserir a nova linha que voc� removeu.
347
348Lembre-se que a maioria dos comandos do Emacs podem receber um n�mero de
349repeti��o; isso inclui texto de caracteres. Repetir um texto de
350caractere o insere algumas vezes.
351
352>> Tente isso agora -- digite C-u 8 * para inserir ********.
353
354Voc� acabou de aprender o jeito mais simples de digitar alguma coisa no
355Emacs e corrigir os erros. Voc� pode remover palavras ou linhas
356tamb�m. Aqui vai um sum�rio dos comandos de dele��o:
357
358        <Delete>     remove o caractere imediatamente antes do cursor
359        M-d          remove o pr�ximo caractere apos o cursor
360
361        M-<Delete>   Mata a palavra imediatamente antes do cursor
362        M-d          Mata a pr�xima palavra depois do cursor
363
364        C-k          Mata a posi��o do cursor at� o fim da linha
365        M-k          Mata at� o fim da senten�a corrente
366
367Note que o <Delete> e o C-d vs M-<Delete> e M-d estende o paralelo
368iniciado por C-f e M-f (bem, <Delete> n�o � realmente um controle de
369caractere, mas n�o vamos nos preocupar com isso). C-k e M-k s�o como C-e
370e M-e, uma parte, nessas linhas s�o senten�as opostas.
371
372Voc� pode tamb�m matar parte de um buffer com um m�todo uniforme. Mova
373para o fim dessa parte, e digite C-@ ou C-SPC (um ou outro). (SPC � a
374Barra de Espa�o.) Mova para o outro fim dessa parte, e digite C-w. Isso
375matar� todo o texto entre as duas posi��es.
376
377>> Mova o cursor para o V no inicio do par�grafo anterior.
378>> Digite C-SPC. Emacs vai mostrar a mensagem "Mark set" no rodap� da
379   tela.
380>> Mova o cursor para o . (ponto) no "fim", na segunda linha do
381   par�grafo.
382>> Digite C-w. Isso vai matar o texto iniciando no V, e terminando bem
383   antes do . (ponto).
384
385A diferen�a entra "matar" e "remover" � que o texto "matado" pode ser
386re-inserido, onde os textos "removidos" n�o podem ser re-inseridos.
387Re-inser��o de um texto matado chama-se colar (yanking). Geralmente, o
388comando que pode remover bastante texto mata o texto (eles fazem com que
389voc� possa colar (yank) o texto), enquanto os comandos que removem um
390caractere, ou apenas linhas brancas ou espa�os, fazem dele��o (para que
391voc� n�o possa colar esse texto).
392
393>> Mova o cursor para o inicio da linha que n�o esteja vazia.
394   Agora digite C-k para matar o texto nessa linha.
395>> Digite C-k pela segunda vez. Voc� ver� que a nova linha que segue a
396   linha ser� matada.
397
398Note que um simples C-k mata o conte�do de uma linha, � um segundo C-k
399mata a linha, e faz com que todas as outras linhas movam para cima. C-k
400trata um argumento num�rico especialmente: ele mata tantas linhas E seus
401conte�dos. Isso n�o � uma simples repeti��o. C-u 2 C-k mata duas linhas
402e suas novas linhas; digitar C-k duas vezes n�o faria isso.
403
404Para trazer o texto matado novamente � chamado colar "yaking". (Pense
405nisso como colar, ou trazer de volta, algum texto que foi levado
406embora.) Voc� pode colar (yank) o texto matado no mesmo lugar onde ele
407foi matado, ou em qualquer outro lugar do buffer, ou ate em um arquivo
408diferente. Voc� pode colar o texto diversas vezes, o que far� diversas
409c�pias dele.
410
411O comando para colar � C-y. Ele re-insere o �ltimo texto matado, na
412posi��o corrente do cursor.
413
414>> Tente; digite C-y para colar o texto novamente.
415
416Se voc� fizer diversos C-k's em uma linha, todo esse texto matado ser�
417salvo junto, ent�o aquele C-y vai colar todas aquelas linhas de uma vez.
418
419>> Faca isso agora, digite C-k diversas vezes.
420
421Agora pegue o texto matado:
422
423Digite C-y. Ent�o mova o cursor para baixo algumas linhas e digite C-y
424novamente. Agora voc� sabe como copiar determinado texto.
425
426O que voc� faria se voc� tivesse determinado texto que voc� gostaria de
427colar, e ent�o voc� mata alguma outra coisa? C-y colar� o kill mais
428recente. Mas o antigo texto ainda n�o foi perdido. Voc� pode t�-lo
429novamente usando o comando M-y. Depois que voc� der um C-y para pegar o
430kill mais recente, digitar M-y troca o que voc� colou pelo anterior a
431ele. Digitar M-y novamente e novamente traz kills anteriores e
432anteriores. Quando voc� tiver alcan�ado o texto que voc� que esta
433procurando, voc� n�o precisa fazer nada para mant�-lo. Apenas continue
434com a sua edi��o, deixando o texto onde ele esta.
435
436Se voc� digitar M-y o suficiente, voc� come�ar� do inicio novamente (o
437kill mais recente).
438
439>> Mate uma linha, mova por ai, mate mais uma linha.
440   Agora digite C-y para colar a segunda linha matada.
441   Agora digite M-y e ele vai ser trocado pelo primeiro kill.
442   Faca mais alguns M-y's e veja o que voc� tem. Faca isso ate que o
443   segundo kill volte, e depois mais alguns.
444   Se voc� preferir, voc� pode tentar dar argumentos positivos e
445   negativos.
446
447
448* DESFAZENDO (UNDO)
449-------------------
450
451Se voc� fizer uma mudan�a no texto, e ent�o decidir que isso foi um
452erro, voc� pode desfazer com o comando de desfazer (undo), C-x u.
453
454Normalmente, C-x u desfaz as mudan�as feitas por um comando; se voc�
455repetir C-x u diversas vezes em uma linha, cada repeti��o desfar�
456um comando adicional.
457
458Mas tem duas exce��es: comandos que n�o trocam o texto n�o contam (isso
459inclui o movimento do cursor e a barra de rolagem), e caracteres
460auto-inseridos s�o usualmente cuidados em grupos de mais de 20 (Isso e
461para reduzir o numero de C-x u's que voc� deve digitar para desfazer a
462inser��o de um texto.).
463
464>> Mate essa linha com C-k, ent�o digite C-x u e isso vai re-aparecer.
465
466C-_ � um comando alternativo para desfazer; ele funciona exatamente como
467o C-x u, mas � mais f�cil de digitar diversas vezes em uma linha. A
468desvantagem de C-_ � que alguns teclados ele n�o � t�o obvio para
469digitar. � exatamente por isso que o C-x u � fornecido. Em alguns
470terminais, voc� pode digitar C-_ digitando / enquanto segurando o
471CONTROL.
472
473Um argumento num�rico para C-_ ou C-x u age como um contador de
474repeti��o.
475
476Voc� pode desfazer a dele��o de texto da mesma maneira que voc� pode
477desfazer o kill de um texto. A distin��o entre matar e remover alguma
478coisa afeta se voc� pode colar com C-y; isso n�o faz diferen�a para o
479desfazer (undo).
480
481
482* ARQUIVOS
483----------
484
485Para poder fazer o texto que voc� edita permanente, voc� precisa
486coloc�-lo em um arquivo. Ou ent�o, isso ser� perdido quando o seu Emacs
487for fechado. Para colocar seu texto em um arquivo, voc� precisa
488"encontrar" o arquivo antes de digitar o texto (Isso tamb�m � chamado
489"visitar" um arquivo.).
490
491Encontrando um arquivo significa que voc� ver� o conte�do de um arquivo
492com o Emacs. De diversas maneiras, isso � como se voc� estivesse
493editando o arquivo. De qualquer maneira, as mudan�as que voc� fizer
494utilizando o Emacs n�o se tornar�o permanente ate que voc� "salve" o
495arquivo. Isso e para que voc� evite deixar um arquivo meio-modificado no
496sistema enquanto voc� n�o quer isso. Mesmo quando voc� salva, o Emacs
497deixa o arquivo original sobre um arquivo de nome alterado no caso que
498voc� mais tarde decida que aquelas mudan�as foram um erro.
499
500Se voc� olhar no rodap� da tela voc� ver� a linha que come�a e termina
501com tra�os e inicia com "--:-- TUTORIAL.pt_BR" ou algo parecido com
502isso. Essa parte da tela normalmente mostra o nome do arquivo que voc�
503esta visitando. Agora mesmo, voc� esta visitando um arquivo chamado
504"TUTORIAL.pt_BR" que � sua pr�pria c�pia do tutorial do Emacs. Quando
505voc� encontra um arquivo com o Emacs, o nome do arquivo aparecer� nesse
506lugar espec�fico.
507
508Algo especial para se dizer sobre o comando de encontrar arquivo e que
509voc� tem que dizer qual nome do arquivo voc� quer. Dizemos que o comando
510"l� um argumento do terminal" (nesse caso, o argumento e o nome do
511arquivo). Depois que voc� digitar o comando
512
513       C-x C-f  Encontrar um arquivo
514
515O Emacs pede para voc� digitar o nome do arquivo. O nome do arquivo
516aparece no rodap� da tela. A linha de rodap� � chamada de minibuffer
517quando � utilizada para esse tipo de introdu��o de dados. Voc� pode
518utilizar os comandos padr�es do Emacs para editar o nome do arquivo.
519
520Enquanto voc� estiver digitando o nome do arquivo (ou qualquer outro
521tipo de dado para o minibuffer), voc� pode cancelar o comando com a
522tecla C-g.
523
524>> Digite C-x C-f, ent�o digite C-g. Isso cancelar� o minibuffer, e
525   tamb�m cancelar� o comando C-x C-f que estava sendo utilizado no
526   minibuffer. Para que voc� n�o procure nenhum arquivo.
527
528Quando voc� terminar de digitar o nome do arquivo, digite <Return> para
529terminar. Ent�o o comando C-x C-f executar�, e encontrar� o arquivo
530que voc� escolheu. O minibuffer desaparece quando o comando C-x C-f e
531finalizado.
532
533Em pouco tempo o conte�do do arquivo aparece na tela, e voc� poder�
534editar o conte�do dele. Quando voc� terminar de fazer suas altera��es
535permanentes digite o comando
536
537       C-x C-s  Salve o arquivo
538
539Isso copia o texto do Emacs para o arquivo. A primeira vez que voc�
540fizer isso, o Emacs vai renomear o arquivo original para um novo nome
541para que voc� n�o o perca. O nome novo e feito adicionando "~" no fim do
542nome original do arquivo.
543
544Quando o salvamento for conclu�do, Emacs imprimir� o nome do arquivo
545escrito. Voc� deve salvar o conte�do do seu arquivo regularmente, para
546que voc� n�o perca muito trabalho caso o sistema caia por um algum
547motivo.
548
549>> Digite C-x C-s, salvar� a c�pia do seu tutorial.
550   Isso imprimir� "Wrote ...TUTORIAL.pt_BR" no fim da tela.
551
552NOTA: Em alguns sistemas, digitar C-x C-s travar� a tela e voc� n�o
553ver� sa�da do Emacs. Isso indica que um "recurso" do sistema operacional
554chamado "controle de fluxo" (flow control) esta interceptando o C-s e
555n�o deixando que passe pelo Emacs. Para destravar a tela, digite
556C-q. Ent�o, leia na se��o "Spontaneous Entry to Incremental Search" no
557manual do Emacs para uma dica de como lidar com esse "recurso".
558
559Voc� pode encontrar um arquivo j� existente, para v�-lo ou edit�-lo. Voc�
560tamb�m pode encontrar um arquivo que ainda n�o existe. Essa � a maneira
561de criar um arquivo com o Emacs: encontre o arquivo, que iniciar�
562vazio, ent�o come�e a inserir o texto para o arquivo. Quando voc� pedir
563para "salvar" o arquivo, o Emacs perguntar� se voc� realmente quer
564criar o arquivo com o texto que voc� acabou de inserir. De agora em
565diante, voc� pode considerar que esta editando um arquivo j� existente.
566
567
568* BUFFERS
569---------
570
571Se voc� encontrar um segundo arquivo com C-x C-f, o primeiro continuara
572dentro do Emacs. Voc� pode voltar para ele encontrando-o novamente com
573C-x C-f. Dessa maneira voc� pode ter um grande numero de arquivos dentro
574do Emacs.
575
576>> Crie um arquivo chamado "foo" digitando C-x C-f foo <Return>.
577   Depois digite algum texto, edite-o, e salve "foo" digitando C-x C-s.
578   Finalmente, digite C-x C-f TUTORIAL.pt_BR <Return> para voltar ao
579   tutorial.
580
581O Emacs guarda cada texto de um arquivo em um objeto chamado
582"buffer". Encontrar um arquivo cria um novo buffer dentro do Emacs. Para
583ver uma lista dos buffers que existem no servi�o do seu Emacs, digite
584
585        C-x C-b  Lista os buffers
586
587>> Tente C-x C-b agora.
588
589Veja como cada buffer tem um nome, e ele tamb�m pode ter um nome de
590arquivo para o conte�do de arquivo que ele armazena. Alguns buffers n�o
591correspondem a arquivos. Por exemplo, o buffer chamado "*Buffer List*"
592n�o tem nenhum arquivo. Esse � o buffer que contem a lista de buffers
593que foi feito com C-x C-b. QUALQUER texto que voc� ver numa janela do
594Emacs e sempre parte de algum buffer.
595
596>> Digite C-x 1 para sair da lista dos buffers.
597
598Se voc� fizer mudan�as no texto de um arquivo, ent�o encontrar um novo
599arquivo, isso n�o salva o conte�do do primeiro arquivo. As mudan�as
600continuam dentro do Emacs, nos buffers de arquivo. A cria��o ou edi��o
601do buffer do segundo arquivo n�o tem nenhum efeito no buffer do primeiro
602arquivo. Isso � muito �til, mas tamb�m significa que voc� precisa de uma
603maneira conveniente de salvar o buffer do primeiro arquivo. Seria
604inconveniente ter que voltar para ele com C-x C-f para salv�-lo com C-x
605C-s. Por isso temos
606
607        C-x s     Salve alguns buffers
608
609C-x s pergunta a voc� sobre cada buffer que contem modifica��o e voc�
610n�o salvou. Ele te pergunta, para cada buffer, se voc� quer salvar.
611
612>> Insira uma linha de texto, ent�o digite C-x s.
613   Isso deve te perguntar se voc� quer salvar o buffer chamado
614   TUTORIAL.pt_BR.
615   Responda sim para a pergunta digitando "y".
616
617
618* ESTENDENDO O COMANDO SET
619--------------------------
620
621Existem mais, muito mais comandos que o Emacs poderia possivelmente ser
622colocado em todos os control e caracteres meta. O Emacs faz isso com o
623comando X (estender). Que vem em duas vers�es:
624
625        C-x     Extensor de caractere. Seguido por um caractere.
626        M-x     Extensor de nome de comando. Seguido por um longo nome.
627
628Esses comandos que s�o geralmente �teis mas pouco usados que os comandos
629que voc� j� aprendeu. Voc� j� viu dois deles: os comandos de arquivos
630C-x C-f para Encontrar e C-x C-s para Salvar. Outro exemplo de um
631comando para finalizar a sess�o do Emacs - esse � o comando C-x C-c (N�o
632se preocupe em perder as mudan�as que voc� fez; C-x C-c oferece salvar
633cada arquivo modificado antes de matar o Emacs.).
634
635C-z � o comando para sair do Emacs *temporariamente* - ent�o voc� pode
636voltar para a mesma se��o do Emacs depois.
637
638Em sistemas que permitem isso, C-z "suspende" o Emacs; isso e, retorna
639ao shell mas n�o destr�i o Emacs. Nos shells mais comum, voc� pode
640resumir o Emacs com o comando 'fg' ou com '%emacs'.
641
642Nos sistemas que n�o implementam suspens�o, C-z cria um subshell rodando
643sobre o Emacs para dar a voc� a chance de rodar outros programas e
644retornar ao Emacs depois; isso n�o "sai" verdadeiramente do Emacs. Nesse
645caso, o comando shell 'exit' � o comando usual para voltar ao Emacs do
646subshell.
647
648A hora de usar o C-x C-c � quando voc� esta prestes a sair do sistema
649operacional. � tamb�m a maneira correta de sair do Emacs quando chamado
650atrav�s de um cliente de e-mail ou outros utilit�rios, porque eles n�o
651controlam a suspens�o do Emacs. Em outras circunst�ncias, se voc� n�o
652estiver saindo do sistema operacional, � melhor suspender o Emacs com
653C-z ao inv�s de sair do Emacs.
654
655Existem diversos comando C-x. Aqui esta uma lista dos que voc� aprendeu:
656
657	C-x C-f		Encontrar arquivo.
658	C-x C-s		Salvar arquivo.
659	C-x C-b		Listar buffers.
660	C-x C-c		Sair do Emacs.
661	C-x 1		Remover todas menos a janela atual.
662	C-x u		Desfazer.
663
664O extensor de nome de comando � usado menos ainda, ou comandos que s�o
665usados apenas em alguns modos. Um exemplo � o comando replace-string,
666que globalmente troca uma string por outra. Quando voc� digita M-x, o
667Emacs te pergunta no rodap� da tela M-x e voc� deve digitar o nome do
668comando; nesse caso, "replace-string". Apenas digite "repl s<TAB>" e o
669Emacs completar� o nome. (<TAB> � a tecla Tab, usualmente encontrando
670abaixo do CapsLock ou Shift bem na extremidade do teclado.). Termine o
671comando com <Return>.
672
673O comando replace-string requer dois argumentos - a string para ser
674trocada, e a string que a substituir�. Voc� precisa terminar cada
675argumento com <Return>.
676
677>> Mova o cursor para a linha branca duas linhas abaixo dessa.
678   Digite ent�o M-x repl s<Return>mudou<Return>alterado<Return>.
679
680   Note como essa linha mudou: voc� substituiu a palavra m-u-d-o-u por
681   "alterado" quando ocorreu, apos a posi��o inicial do cursor.
682
683
684* SALVAMENTO AUTOM�TICO
685-----------------------
686
687Quando voc� fizer mudan�as em um arquivo, mas voc� ainda n�o tiver
688salvo, elas podem ser perdidas se o seu computador der algum problema.
689Para proteger voc� disso, o Emacs periodicamente escreve um arquivo "auto
690salvo" para cada arquivo que voc� estiver editando. O nome do arquivo
691auto salvo tem um # no inicio e no fim; por exemplo, se o seu arquivo
692tiver o nome "ola.c", o nome do arquivo auto salvo dele ser�
693"#ola.c#". Quando voc� salvar o arquivo da maneira normal, o Emacs
694remover� os arquivos auto salvos.
695
696Se o computador der problema, voc� pode recuperar suas modifica��es auto
697salvas abrindo o arquivo normalmente (o arquivo que voc� estava
698editando, n�o o arquivo auto salvo) e ent�o digitar M-x recover
699file<Return>. Quando for pedida a confirma��o, digite yes<Return>
700para ir em frente e recuperar os dados auto salvos.
701
702
703* �REA DE SA�DA (ECHO AREA)
704---------------------------
705
706Se o Emacs ver que voc� esta digitando comandos multi-caractere
707lentamente, ele os mostrar� para voc� no fim da tela numa �rea chamada
708�rea de Sa�da ou Echo Area. A �rea de sa�da contem a linha de rodap� da
709tela.
710
711
712* MODE LINE
713-----------
714
715A linha imediatamente acima da �rea de sa�da � chamada de "mode line". O
716mode line diz algo algo mais ou menos assim:
717
718--:**  TUTORIAL.pt_BR    (Fundamental)--L670--58%----------------
719
720Essa linha da informa��es �teis sobre o status do Emacs e o texto que
721voc� esta editando.
722
723Voc� j� sabe o que o nome do arquivo significa -- � o arquivo que voc�
724encontrou. -NN%-- indica sua posi��o no arquivo texto; significa que NN
725porcento do texto esta acima do topo da tela. Se o topo do arquivo
726estiver na tela, ele mostrar� --Top-- ao inv�s de --00%--. Se o rodap� do
727texto estiver na tela, ele mostrar� --Bot--. Se voc� estiver olhando um
728texto muito pequeno que cabe todo na tela, o mode line mostrar�
729--All--.
730
731O L s�o d�gitos e indicam a posi��o de uma outra maneira: eles mostram a
732linha corrente do ponto.
733
734Os asteriscos pr�ximo ao inicio significam que voc� fez mudan�as no
735texto. Logo ap�s voc� visitar um arquivo ou salvar um arquivo, essa
736parte do mode line n�o mostrar� asteriscos, apenas tra�os.
737
738A parte do mode line dentro do par�nteses lhe diz quais modos voc� esta
739utilizando. O modo padr�o � o Fundamental que � o que voc� esta
740utilizando agora. � um exemplo de um "modo majorit�rio".
741
742O Emacs tem diversos diferentes modos majorit�rios. Alguns deles s�o
743para edi��o de diferentes linguagens de programa��o e/ou tipos de texto,
744como modo Lisp, modo Texto, etc. Em qualquer momento um � apenas um modo
745majorit�rio e ativo, e seu nome pode ser encontrado no mode line
746exatamente onde o "Fundamental" esta agora.
747
748Cada modo majorit�rio faz com que alguns comandos operem de modo
749diferente. Por exemplo, existem comandos para criar coment�rios nos
750programas, e desde que cada linguagem de programa��o tem uma id�ia
751diferente de como um coment�rio deve ser, cada modo majorit�rio tem que
752inserir seus coment�rios individualmente. Cada modo majorit�rio � o nome
753de um comando estendido, e � assim que voc� pode mudar para determinado
754modo. Por exemplo, M-x fundamental-mode � o comando para trocar para o
755modo Fundamental.
756
757Se voc� vai editar texto em Portugu�s, como neste arquivo, voc� pode
758utilizar o modo Texto.
759
760>> Digite M-x text mode<Return>.
761
762N�o se preocupe, nenhum dos comandos do Emacs que voc� aprendeu
763mudar�o. Mas voc� pode observar que o M-f e o M-b tratam os ap�strofos
764como parte das palavras. Anteriormente, no modo Fundamental, M-f e M-b
765trataram os ap�strofos como separadores de palavras.
766
767Modos majorit�rios fazem usualmente modifica��es como esta: a maioria
768dos comandos fazem "a mesma coisa" em cada modo majorit�rio, mas eles
769trabalham um pouquinho diferente.
770
771Para ver a documenta��o do seu modo majorit�rio, digite C-h m.
772
773>> Utilize C-u C-v uma ou mais para trazer essa linha pr�xima ao topo da
774   tela.
775>> Digite C-h m, para ver como o modo texto difere do modo Fundamental.
776>> Digite C-x 1 para remover a documenta��o da tela.
777
778Modos majorit�rios s�o chamados de majorit�rios porque tamb�m existem
779modos minorit�rios. Modos minorit�rios n�o s�o alternativos aos modos
780majorit�rios, apenas uma modifica��o minorit�ria deles. Cada modo
781minorit�rio pode ser ligado ou desligado por ele mesmo, independente de
782todos os outros modos minorit�rios, � independente do modo
783majorit�rio. Ent�o voc� pode n�o utilizar modos minorit�rios, ou um modo
784minorit�rio, ou qualquer combina��o de modos minorit�rios.
785
786Um modo minorit�rio que � bastante �til, especialmente para editar texto
787em Portugu�s, � o modo Auto Fill. Quando ele esta ligado, o Emacs quebra
788a linha entre as palavras automaticamente quando voc� inserir um texto e
789criar uma linha muito comprida.
790
791Voc� pode ligar o modo Auto Fill fazendo M-x auto fill
792mode<Return>. Quando o modo estiver ligado, voc� pode deslig�-lo
793novamente fazendo M-x auto fill mode<Return>. Se o modo estiver
794desligado, esse comando o liga, e se ele estiver ligado, este comando o
795desligara. Nos dizemos que o comando inverte seu status.
796
797>> Digite M-x auto fill mode<Return> agora. Ent�o insira uma linha de
798   "asdf " diversas vezes ate que voc� veja dividir em duas linhas. Voc�
799   precisa colocar espa�os entre as palavras porque o modo Auto Fill
800   quebra apenas nos espa�os.
801
802A margem � usualmente definida com 70 caracteres, mas voc� pode
803modific�-la com o comando C-x f. Voc� deve dar a margem que voc� quer
804como um argumento num�rico.
805
806>> Digite C-x f com um argumento de 20. (C-u 20 C-x f).
807   Ent�o digite algum texto e veja o Emacs encher linhas com ate 20
808   caracteres. Ent�o, volte a definir a margem para 70 utilizando C-x f.
809
810Se voc� fizer uma mudan�a no meio de um par�grafo, o modo Auto Fill n�o
811re-preencher� para voc�. Para re-preencher o par�grafo, digite M-q
812(Meta-q) com o cursor dentro do par�grafo.
813
814>> Mova o cursor dentro do par�grafo anterior e digite M-q.
815
816
817* PESQUISANDO
818-------------
819
820O Emacs pode fazer pesquisas por strings (esses sao grupos de caracteres
821ligados ou palavras) tanto para frente do texto ou para traz. Pesquisar
822por uma string e um comando de movimento do cursor; ele move o cursor
823para o pr�ximo lugar onde a string aparece.
824
825O comando de pesquisa do Emacs � diferente dos comandos de pesquisa da
826maioria dos editores, porque � uma pesquisa "incremental". Isso
827significa que a pesquisa acontece enquanto voc� digita uma string para
828pesquisar.
829
830O comando para iniciar a pesquisa � C-s para pesquisa para frente ou C-r
831para pesquisa inversa. MAS ESPERE! N�o tente fazer agora.
832
833Quando voc� digitar C-s voc� percebera que uma string "I-search"
834aparecer� como prompt na �rea de sa�da. Isso diz para voc� que o Emacs
835esta no que chamamos de pesquisa incremental esperando que voc� digite o
836que voc� quer procurar. <Return> termina a pesquisa.
837
838>> Agora digite C-s para iniciar a pesquisa. DEVAGAR, uma letra por vez,
839   digite o caractere 'cursor', pausando cada vez que voc� digitar um
840   caractere, perceba o que acontece com o cursor. Agora que voc�
841   pesquisou por "cursor", uma vez.
842>> Digite C-s novamente, para pesquisa a pr�xima ocorr�ncia de "cursor".
843>> Agora digite <Delete> quatro vezes e veja como o cursor move.
844>> Digite <Return> para terminar a pesquisa.
845
846Voc� viu o que aconteceu? O Emacs, em uma pesquisa incremental, tenta ir
847para a ocorr�ncia que voc� digitou ate o momento. Para ir para pr�xima
848ocorr�ncia de 'cursor' apenas digite C-s novamente. Se nenhuma
849ocorr�ncia existir, o Emacs bipa e te diz que a pesquisa atual
850falhou. C-g tamb�m termina a pesquisa.
851
852NOTA: Em alguns sistemas, digitar C-s trava a tela e voc� n�o ver� a
853sa�da do Emacs. Isso indica que um "recurso" do sistema operacional
854chamado "controle de fluxo" (flow control) esta interceptando o C-s e
855n�o deixando que passe pelo Emacs. Para destravar a tela, digite
856C-q. Ent�o, leia na se��o "Spontaneous Entry to Incremental Search" no
857manual do Emacs para uma dica de como lhe dar com esse "recurso".
858
859Se voc� estiver no meio de uma pesquisa incremental e digitar <Delete>,
860voc� perceber� que o �ltimo caractere da pesquisa ser� apagado e a
861pesquisa voltar� para o �ltimo lugar da pesquisa. Por exemplo, imagine
862que voc� tenha digitado "c", para pesquisar a primeira ocorr�ncia de
863"c". Agora se voc� digitar "u", o cursor mover� para a primeira
864ocorr�ncia de "cu". Agora digite <Delete>. Isso apagar� o "u" da
865string de pesquisa, e o cursor mover� de volta para a primeira
866ocorr�ncia de "c".
867
868Se voc� estiver no meio de uma pesquisa e digitar um caractere control
869ou meta (com algumas exce��es--caracteres que s�o especiais em uma
870pesquisa, como C-s e C-r), a pesquisa � terminada.
871
872O C-s inicia uma pesquisa que procura por qualquer ocorr�ncia da string
873de pesquisa AP�S a posi��o corrente do cursor. Se voc� quiser pesquisar
874por alguma coisa anterior no texto, digite C-r ao inv�s. Tudo que nos
875dissemos sobre C-s tamb�m implica para C-r, tirando a dire��o da
876pesquisa que � reversa.
877
878
879* M�LTIPLAS JANELAS
880-------------------
881
882Um dos recursos mais interessantes do Emacs � que voc� pode mostrar mais
883de uma janela na tela ao mesmo tempo.
884
885>> Mova o cursor para essa linha e digite C-u 0 C-l (isso � control-L,
886   n�o control-1).
887
888>> Agora digite C-x 2 que vai dividir a tela em duas janelas.
889   As duas janelas v�o mostrar esse tutorial. O cursor fica na janela
890   do topo.
891
892>> Digite C-M-v para rolar para o fim da janela.
893   (Se voc� n�o tiver uma tecla Meta de verdade, digite ESC C-v.).
894
895>> Digite C-x o ("o" para "outra") para mover o cursor para o rodap�
896   da janela.
897>> Use C-v e M-v no rodap� da janela para rod�-la.
898   Continue lendo essas dire��es na janela do topo.
899
900>> Digite C-x o novamente para mover o cursor de volta para a janela
901   do topo.
902   O cursor na janela do topo esta exatamente como estava antes.
903
904Voc� pode continuar usando C-x o para alternar entre as janelas. Cada
905janela tem sua pr�pria posi��o de cursor, mas apenas uma janela mostra o
906cursor. Todos os comandos mais comuns de edi��o aplicam para a janela
907que o cursor esta. Chamamos isso de "janela selecionada".
908
909O comando C-M-v � muito �til para quando voc� estiver editando o texto
910em uma janela e utilizando a outra janela para referencia. Voc� pode
911manter o cursor sempre na janela que voc� estiver editando, e avan�ar
912pela outra janela seq�encialmente utilizando C-M-v.
913
914C-M-v � um exemplo de um caractere CONTROL-META. Se voc� tiver uma tecla
915META real, voc� pode digitar C-M-v segurando ambos CONTROL e META
916enquanto digitar v. N�o importa se CONTROL ou META "vem primeiro,"
917porque ambas as teclas agem modificando o caractere que voc� digita.
918
919Se voc� n�o tiver um tecla META real, voc� pode utilizar ESC ao inv�s, a
920ordem n�o importa: voc� precisa digitar ESC seguido por Control-v,
921porque Control-ESC v n�o funcionar�. Isso porque ESC � um caractere
922com seu pr�prio direito, n�o � uma tecla de modifica��o.
923
924>> Digite C-x 1 (na janela do topo) para fugir da janela do rodap�.
925
926(Se voc� tivesse digitado C-x 1 na janela do rodap�, voc� fugiria da
927janela do topo. Pense neste comando como "Mantenha apenas uma janela--a
928janela que estou dentro.")
929
930Voc� n�o precisa mostrar o mesmo buffer nas duas janelas. Se voc�
931utilizar C-x C-f para encontrar um arquivo em outra janela, a outra
932janela n�o mudara. Voc� pode encontrar um arquivo em cada janela
933independentemente.
934
935Aqui esta uma maneira de utilizar duas janelas para mostrar coisas
936diferentes:
937
938>> Digite C-x 4 C-f seguido pelo nome de um dos seus arquivos.
939   Termine com <Return>. Veja o arquivo especificado aparece na janela
940   do rodap�. O cursor ir� para l�, tamb�m.
941
942>> Digite C-x o para voltar a janela do topo, e C-x1 para remover a
943   janela de rodap�.
944
945
946* N�VEIS RECURSIVOS DE EDI��O
947-----------------------------
948
949Algumas vezes voc� entrar� no que chamamos de "n�vel de edi��o
950recursiva". Isso � indicado por colchetes no mode line, envolvendo os
951par�nteses em volta do nome do modo majorit�rio. Por exemplo, voc� pode
952ver [(Fundamental)] ao inv�s de (Fundamental).
953
954Para sair desses n�veis recorr�veis de edi��o, digite ESC ESC ESC. Isso
955e um comando de todos os prop�sitos "saia". Voc� pode tamb�m utilizar
956para eliminar janelas extras, e sair de um minibuffer.
957
958>> Digite M-x para entrar no minibuffer; ent�o digite ESC ESC ESC para
959   sair.
960
961Voc� n�o pode utilizar C-g para sair de um n�vel de edi��o
962recursiva. Isso porque o C-g � utilizado para cancelar comandos e
963argumentos COM o n�vel de edi��o recursiva.
964
965
966* CONSEGUINDO MAIS AJUDA
967------------------------
968
969Neste tutorial nos tentamos suprimir informa��es suficientes para que
970voc� comece a utilizar o Emacs. Existe tanto dispon�vel sobre Emacs que
971seria imposs�vel explicar tudo aqui. De qualquer maneira, voc� pode
972querer aprender mais sobre Emacs mesmo porque ele tem muitos outros
973recursos �teis. O Emacs proporciona comandos para leitura de
974documenta��o sobre comandos do Emacs. Esses comandos de "ajuda" iniciam
975com o caractere Control-h, que � chamado de "o caractere de ajuda".
976
977Para utilizar os recursos de ajuda, digite o caractere C-h, e ent�o um
978caractere dizendo que tipo de ajuda voc� quer. Se voc� REALMENTE estiver
979perdido, digite C-h ? e o Emacs lhe dir� que tipo de ajuda ele pode
980lhe dar. Se voc� digitar C-h e decidir que voc� n�o quer nenhuma ajuda,
981apenas digite C-g para cancelar.
982
983(Alguns sistemas mudam o significado do caractere C-h. Eles n�o deveriam
984fazer isso para todos os usu�rios, ent�o voc� deve reclamar com o
985administrador do sistema. Enquanto isso, se C-h n�o mostrar a mensagem
986sobre ajuda no rodap� da tela, tente digitar a tecla F1 ou M-x help
987<Return>.)
988
989O recurso de ajuda mais b�sico � o C-h c. Digite C-h, e o caractere c, �
990um comando de caractere ou seq��ncia; ent�o o Emacs mostrar� uma breve
991descri��o do comando.
992
993>> Digite C-h c C-p
994   A mensagem deve ser algo assim
995
996	C-p roda o comando linha-anterior
997
998Isso diz a voc� "o nome da fun��o". Nome de fun��es s�o utilizados
999basicamente para personalizar o estender o Emacs. Mas desde que nomes de
1000fun��es s�o utilizados para indicar que o que o comando faz, eles podem
1001servir tamb�m como uma breve documenta��o--suficiente para lembrar voc�
1002os comandos que voc� j� aprendeu.
1003
1004Comandos multi-caractere como C-x C-s e (se voc� n�o tiver a tecla META
1005ou EDIT ou ALT) <ESC>v � tamb�m permitido depois de C-h c.
1006
1007Para ter mais informa��o sobre um comando, utilize C-h k ao inv�s de C-h
1008c.
1009
1010>> Digite C-h k C-p.
1011
1012Isso mostra a documenta��o da fun��o, assim como seu nome, em uma janela
1013do Emacs. Quando voc� terminar de ler a sa�da, digite C-x 1 para sair da
1014sa�da do texto de ajuda. Voc� n�o precisa fazer isso imediatamente
1015apos. Voc� pode fazer alguma edi��o enquanto utilizando como referencia
1016o texto de ajuda, e ent�o digite C-x 1.
1017
1018Aqui est�o algumas outras op��es �teis do comando C-h:
1019
1020   C-h f	Descreve a fun��o. Digite o nome da fun��o.
1021
1022>> Tente digitar C-h f previous-line<Return>
1023   Isso imprimir� toda informa��o que o Emacs tem sobre a fun��o que
1024   implementa o comando C-p.
1025
1026   C-h a        Comando Apropos. Digite uma palavra chave e o Emacs
1027                listar� todos os comandos que o nome contem essa
1028                palavra. Esses comandos podem ser chamados com
1029                Meta-x. Para alguns comandos, o comando Apropos
1030                tamb�m listar� um ou dois caracteres de seq��ncia que
1031                roda o mesmo comando.
1032
1033>> Digite C-h a file<Return>.
1034
1035Isso mostra em uma outra janela a lista de todos os comandos M-x com
1036"arquivo" em seus nomes. Voc� ver� comandos-caractere como C-x C-f
1037listados ao lado do comando correspondente assim como o find-file.
1038
1039>> Digite C-M-v para rolar a janela de ajuda. Faca isso algumas vezes.
1040
1041>> Digite C-x 1 para remover a janela de ajuda.
1042
1043
1044* CONCLUS�O
1045-----------
1046
1047Lembre, para sair permanentemente do Emacs utilize C-x C-c. Para sair
1048para um shell temporariamente, para que voc� possa voltar ao Emacs mais
1049tarde, utilize C-z.
1050
1051Esse tutorial foi feito para ser entend�vel para todos os novos
1052usu�rios, ent�o se voc� encontrou algo que parece n�o estar claro, n�o
1053sente e se culpe - reclame!
1054
1055
1056* C�PIA
1057-------
1058
1059Esse tutorial descende de uma longa linha de tutoriais do Emacs
1060iniciando com um escrito por Stuart Cracraft para o Emacs original.
1061
1062Essa vers�o do tutorial foi originalmente traduzida por Marcelo Toledo
1063<marcelo@gnu.org> e como o GNU Emacs, tem um copyright, e vem
1064com uma permiss�o de distribui��o de c�pias nas seguintes condi��es:
1065
1066Copyright (C) 2004, 2005, 2006, 2007  Free Software Foundation, Inc.
1067
1068   Permiss�o � garantida a qualquer um para fazer ou distribuir c�pias
1069   integrais deste documento como recebido, em qualquer meio, deixando
1070   dispon�vel e preservados o aviso de copyright e o aviso de permiss�o,
1071   e o distribuidor garante que a permiss�o para distribui��es
1072   posteriores permitam o mesmo que esta nota.
1073
1074   Permiss�o garantida para distribuir vers�es modificadas deste
1075   documento, ou partes dele, sobre as condi��es acima, sempre que elas
1076   tenham uma nota vis�vel de quem foi o �ltimo a alter�-lo.
1077
1078As condi��es para copiar o Emacs especificamente s�o mais complexas, mas
1079no mesmo esp�rito. Por favor, leia o arquivo COPYING e d� c�pias do GNU
1080Emacs para seus amigos. Ajude a erradicar o obstrucionismo de software
1081("propriet�rio") usando, escrevendo, e compartilhando software livre!
1082
1083;;; Local Variables:
1084;;;   coding: latin-1
1085;;;   sentence-end-double-space: nil
1086;;; End:
1087
1088;;; arch-tag: 8ea256d6-2c4a-49ee-ac08-0ea6ef25bf8d
1089