############################################################
#::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.