############################################################
#::editor_hlp::
#                       A janela do Editor
#
############################################################

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
O que � uma janela do editor ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

� uma janela onde � poss�vel trabalhar com um texto dentro
do tcltexed. Cada janela do editor contem um texto. Dois
atributos importantes que podemos identificar s�o quando
trabalhamos com varias janelas de editores:

-> Primeiro plano (focos)
-> E uma marca que indica que aquela janela � a do documento
  principal.

>> Primeiro plano

A janela do editor que tem o focos � aquela que ira receber
os comandos dados fora da janela do editor. Ela � a ultima
janela que estava em "foreground". Um exemplos de a��o pode
ser procurar por uma sequencia de texto; Uma maneira de dar
o focos para uma janela � atrav�s dos bot�es do "mouse".

>> Janela do documento principal

Se voc� fez a janela do editor a janela principal, todas as
chamadas para programas externos como o latex, xdvi e gv
s�o direcionadas para esse documento. neste caso somente a
janela do documento principal � compilada, caso n�o seja
definida a janela principal cada janela atua como se ela
fosse a �nica.

>> A janela � composta pelos seguintes componentes:

  -> uma barra de menu/popupbar ( somente a janela )
  -> uma barra de bot�es
  -> e um campo de entrada

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Uso da barra de bot�es
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Da esquerda para a direita:

uma "figura", Salvar, Salvar como, latex, xdvi, dvips,
ghostview, ispell, Syntax, Sair e finalmente "L.C. ?.?"

>> "figura"

A figura mostra os atributos da janela do editor. Caso a
janela em quest�o tenha o focos voc� ver� na figura algumas
ondas circulares. Se ela esta colorida ( amarela e vermelha
) ela esta marcada para ser o documento principal. Voc�
pode fazer um documento o documento principal "clickando"
na figura, um segundo click remove o atributo de janela
principal.

>> Salvar

Esse voc� j� sabe, simplesmente salva o documento no
arquivo especificado na janela do editor. Se n�o h� nenhum
arquivo especificado "Salvar como" ser� executado.

>> Salvar como

Salva o documento dentro de um arquivo que voc� deve
especificar para a janela de documento atual.

>> latex

Salva o documento para esta janela. Somente esse documento
ser� salvo. E ent�o o programa "latex" ser� executado para
o arquivo especificado. Caso esteja especificado quem � o
documento principal ent�o ser� executado o latex para o
documento principal ao inv�s do arquivo dessa janela.
O latex produzira um arquivo com a extens�o dvi e a sa�da
de erro do latex ser� mostrada no arquivo de ajuda do
tcltexed caso esteja ativada a op��o mostrar log no menu de
op�es.
Para facilitar a cria��o de �ndices, com os comandos do
latex \makeindex \index etc. o programa makeindex � chamado
automaticamente se existe um arquivo com extens�o idx.

>> xdvi

Executa o xdvi ( ou um outro visualizador ) para ver a
sa�da do ultimo comando latex executado. normalmente o
visualizador recarrega o documento atual se voc� produz um novo
arquivo dvi, ent�o voc� apenas precisa executa-lo uma vez.

>> dvips

Produz uma sa�da a partir do arquivo dvi para uma
impressora ghostscript. A sa�da ira ser gravada em um
arquivo com extens�o ps.

>> ghostview

Executa o ghostview, um visualizador para arquivos
ghostscript que foram podem ser gerados com o comando
anterior.

>> ispell

Salva o documento para essa janela do editor. Somente esse
documento ser� salvo. E ent�o ispell, um "shell" interativo
para checagem ortogr�fica � executado e a sa�da ser�
novamente carregada na janela do editor.

>> Sintaxe

Realce de sintaxe, todas sequencias de texto come�ando por
\ s�o entendidos para ser comandos de Latex.
Se este comando � conhecido essas letras ficam verdes, caso
contr�rio ficam vermelhas. Mas tome cuidado, ele n�o olha
atr�s dos n�meros de colchetes ap�s os comandos ( latex ira
fazer isso para voc� ! )
Se o texto � para ser ignorado ( come�ando por % ), ele
ficara azul. Para muitos dos comandos marcados em verde
existe uma breve descriss�o.

>> Sair

Fecha esta janela. Se ela foi modificada ele pergunta se
gostaria de sair sem salvar realmente.

>> "L.C ?.?"

Mostra a posi��o do cursor (linha e coluna).
Uma linha � definida como um n�mero de letras seguidas por
um "ENTER", n�o o n�mero real de linhas mostrada pela
janela do editor.
Se voc� clicar neste bot�o aparecera uma janela onde voc�
pode definir a posi��o do cursor manualmente por n�meros.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Uso da barra de menus/popupbar

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Essa barra de menu somente existe se voc� usa Windows e
tcl/tk 8.x Elas implementam as mesmas fun�es. pressionando
o bot�o direito do mouse abrira a "popupbar". De cima para
baixo ( esquerda para a direita ):

-> Desfazer
-> Recortar
-> Copiar
-> Limpar
-> Bloco
-> + %
-> - %


>> Desfazer

Para desfazer a maioria das suas ultimas a�es com o texto.
( Pelo menos � o que penso ) Na falta de infinita mem�ria
n�o � poss�vel desfazer tudo.

>> Recortar, copiar, colar e limpar

Apaga o texto selecionado guardando-o em outra �rea na
mem�ria (recortar) , copia o texto selecionado para outra
�rea de mem�ria (copiar), copia dessa outra �rea da mem�ria
para a janela do editor(colar), e finalmente apaga o texto
selecionado sem salva-lo.

>> Spell

Marcas todas as palavras n�o escritas corretamente no seu
texto em vermelho.

>> Nearly

Marca a palavra que o cursor esta pr�ximo e mostra uma
lista de palavras que est�o pr�ximas.

>> Bloco

Faz um texto selecionado um "Bloco - aria" ala Borland.

>> + %

Insere no come�o da linha % somente se no come�o da linha
n�o existe %.
-> uma maneira f�cil de comentar regi�es em latex.

>> - %

mesmo que "+ %"

>> ...

Procura por comandos do Latex que coincidem com as letras
entre a �ltima "\" e o cursor. somente os comandos sobre
"Options -> packages" ser�o listados.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Como usar o campo de entrada
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Ei esta � a parte que cada editor tem, n�o fa�a perguntas
bobas. ( olhe por editor-keymap por algumas combina�es de
teclas. )

>> Spelling

Se voc� deseja registrar uma palavra como corretamente
digitado voc� deve colocar o cursor sobre ela e dar um click
duplo no bot�o esquerdo do seu mouse.

-> Exemplos para o auto preenchimento com comandos do Latex

\fra    --->    \frac{}{}
\enumerate      --->
       \begin{enumerate}
        \item
       \end{enumerate}

Auto-preenchimento de parentesis

{       --->    {}
$       --->    $$

--> Para \begin e \end o nome do ambiente ser� inserido
como mostrado a seguir.

\beg    --->
       \begin{}
       \end{}
\bege   --->
       \begin{e}
       \end{e}
\begenum        --->
       \begin{enum}
       \end{enum}

-> Caso algum texto seja selecionado pelo mouse e
pressionando "\" ele n�o ser� deletado como de costume mas
ser� inserido colchetes ao redor do texto.