:TITLE: Introdução
;#
;# rcsid: $header: /usr/home/clif/cvs/tclxexample/lsn.0,v 1.9 1995/08/02 03:22:03 clif exp $
;# Copyright (c) 1995 Clif Flynt
;# 9300 Fleming Rd.
;# Dexter, MI  48130
;# clif@cflynt.com
;# Veja o arquivo "AVISO" com os termos da licença.
;#
;#*********************************************************
;# Portuguese translation: Lucio Agostinho Rocha
;# E-mail: outrosdiasvirao@yahoo.com.br
;# Last update: 13/12/2005
;#*********************************************************
:LESSON_TEXT_START_LEVEL 0:
Bem-vindo ao tutorial Tcl.
<P>Esse nível de detalhe é para o programador experiente que precisa
aprender uma outra linguagem de programação. As descrições serão sucintas,
algumas vezes com apenas uma referência ao manual. Sinta-se à vontade para
selecionar a opção <B>Usuário</B> no botão <B>Nível</B> a qualquer momento
que você precisar de explicações mais detalhadas.
<P>
O código da janela pode ser editado utilizando o mouse, barra de espaços e
teclas de exclusão. Você pode movimentar-se ao longo do texto da janela com
as seqüências emacs de teclas de controle:
<UL>
<UL>
<LI>^N .... Próxima linha
<LI>^P .... Linha anterior
<LI>^A .... Início da linha
<LI>^E .... Fim da linha
<LI>^F .... Move o cursor para frente em um caracter
<LI>^B .... Move o cursor para trás em um caracter
</UL>
</UL>
O botão <B>Executar exemplo</B> irá executar o script na janela de código.
<P>
A saída do script será exibida na janela abaixo. Se o script tiver erros,
a primeira linha com um erro será destacada na janela <B>Exemplo de Código</B>,
e a janela <B>Saída</B> irá exibir a saída que foi gerada antes do erro, 
seguida por uma mensagem de erro.
<P>
A qualquer momento neste tutorial, você pode visualizar uma página de manual
(se você tiver o programa tkman instalado no seu sistema).
Clique duas vezes em uma palavra na janela Lição ou na janela Código, e o
TclTutor irá tentar chamar uma cópia do <B>tkman</B> ou a Ajuda On-Line Microsoft 
para exibir a página apropriada do manual. Se a página do manual não existe, 
<B>tkman</B> irá exibir a apropriada mensagem de erro.
:TEXT_END:
<P>
:LESSON_TEXT_START_LEVEL 1:
Bem-vindo.
<P>
Este é um Auxiliador Computacional para a aprendizagem da linguagem Tcl.
<P>
Este nível de detalhe é para o estudante que está familiarizado com 
sistemas de computador baseados em janela, mas com pouca experiência em 
programação. Se você achar esse nível muito repetitivo, tente selecionar
o nível de programador <B>Experiente</B> do menu <B>Nível</B>.
<P>
Mas se você achar as explicações muito complicadas, ou se o texto assume
que você sabe alguma coisa que você não sabe, sinta-se à vontade para
mover o cursor para o botão rotulado <B>Nível</B>, pressione e solte o
mouse rapidamente. Isso irá exibir três níveis de experiência. Selecione
o nível <B>Iniciante</B> para explicações mais detalhadas.
<P>
Neste tutorial você será levado a conhecer um conjunto de descrições da
linguagem Tcl, com exemplos mostrando aspectos particulares da linguagem.
O texto de instruções estará nesta janela e os exemplos irão aparecer na
janela do meio.
<P>
A qualquer momento neste tutorial, você pode visualizar uma página de manual
(se você tiver o programa tkman instalado no seu sistema).
Clique duas vezes em uma palavra na janela Lição ou na janela Código, e o
TclTutor irá tentar chamar uma cópia do <B>tkman</B> ou a Ajuda On-Line 
Microsoft para exibir a página apropriada do manual. Se a página do manual 
não existe, <B>tkman</B> irá exibir a apropriada mensagem de erro.
<P>
Você pode executar o código do exemplo a qualquer momento clicando no botão
<B>Executar exemplo</B> com o botão direito do mouse. Toda a saída do
exemplo aparecerá na última janela.
<P>
Se o <B>Exemplo de código</B> contém um erro, a linha com o primeiro erro
será destacada na janela de Código. A janela de Saída irá conter a saída 
que foi produzida antes do erro ocorrer, seguida por uma breve mensagem de
erro.
<P>
Há um script na janela do meio agora. Depois que você clicar no botão
<B>Executar exemplo</B> a janela mais abaixo irá conter a string
"A próxima linha tem um erro", seguida por uma mensagem de erro.
<P>
Clique no botão <B>Executar exemplo</B> agora (se você não o fez ainda),
para ver o que acontece quando você tem um script com um erro.
<P>
Você pode editar o código na janela do meio movendo o cursor para o 
caracter que você quer mudar e clicar com o botão direito do mouse.
Neste momento, você pode editar um novo texto, ou apagar caracteres com
as teclas de exclusão.
<P>
Você pode também editar a janela de Código com as seqüências emacs de
teclas de controle:
<UL>
<UL>
<LI>^N .... Próxima linha
<LI>^P .... Linha anterior
<LI>^A .... Início da linha
<LI>^E .... Fim da linha
<LI>^F .... Move o cursor para frente em um caracter
<LI>^B .... Move o cursor para trás em um caracter
</UL>
</UL>
Tente adicionar aspas duplas (") no fim da segunda linha, e clique no
Botão <B>Executar exemplo</B> novamente.
<P>
Quando você terminar de brincar um pouco com as janelas, barras de
rolagem e botões, você estará pronto para a próxima lição.
:TEXT_END:
<P>
:LESSON_TEXT_START_LEVEL 2:
Bem-vindo ao tutorial Tcl
<P>
Este tutorial é designado para permitir a você aprender a linguagem Tcl
de acordo com sua própria velocidade e conveniência. Este nível de detalhe 
é para o estudante com muito pouca experiência com computadores. Se você achar
esse nível tedioso, selecione o nível <B>Usuário</B> no botão <B>Nível</B>
do menu.
<P>
No lado direito das janelas de texto há uma barra vertical 
chamada de barra de rolagem. Se você colocar o cursor na parte de cima
da porção colorida da barra, e segurar o botão esquerdo ou o botão do meio 
do mouse, você pode movimentar aquela porção colorida para baixo, 
e exibir mais do texto. Se você movimentá-la para cima, será exibido 
qualquer texto anterior.
Clicando nos triângulos de cima e de baixo com o botão esquerdo do mouse 
movimentará o texto uma linha naquela direção.
<P>
A tela é dividida em quatro áreas: os botões de controle, o texto de instrução, 
o exemplo de código, e a saída do exemplo de código executado.
<P>
As instruções para a lição TCL estará sempre nesta janela.
<P>
Acima desta seção está uma linha de botões. Esses botões controlam a
Forma com que o programa funciona. Eles são:
<P>
<B>Arquivo </B>: Selecione lições, edite fontes e cores, e a opção de sair do programa.
<P>
<B>Nível </B>: Selecione a quantidade de detalhes e explicações.
<P>
<B>Próxima lição </B>: Exibe a próxima lição.
<P>
<B>Lição anterior </B>: Revisa a lição anterior.
<P>
<B>Executar exemplo </B>: Executa o código da janela Exemplo de código
<P>
<B>Ajuda/Sobre </B>: Exibe uma tela de ajuda, e a informação sobre o TclTutor.
<P>
Esses botões podem ser ativados movendo o cursor para o botão que você 
deseja ativar (que irá então mudar de cor) e pressionar o botão esquerdo
do mouse brevemente.
<P>
Quando você clica nos botões <B>Próxima lição</B>, <B>Lição anterior</B> ou 
<B>Executar exemplo</B> o programa TclTutor irá imediatamente realizar a ação. 
Quando você pressiona o botão <B>Próxima lição</B> ou <B>Nível</B>, você será 
presenteado com um menu de novas escolhas. Você pode acessar essas novas 
seleções da mesma forma que anteriormente, movendo o cursor do mouse sobre 
a seleção, e clicando com o botão esquerdo.
<P>
Quando você seleciona o botão de menu <B>Arquivo</B> você verá essas escolhas:
<P>
<B>Lições</B>: Seleciona a lição atual da tabela de conteúdo.
<P>
<B>Cursos</B>: Seleciona qual série de lição você deseja ver.
<P>
<B>Alterar Tamanho da Fonte</B>: Permite tornar o texto maior ou menor.
<P>
<B>Alterar cores</B>: Permite selecionar as cores para a exibição do TclTutor.
<P>
<B>Sair</B>: Sair do programa TclTutor
<P>
<B>Permite/Desativa Atividade de Log</B>: Em sistemas suportados, TclTutor 
pode criar um arquivo de log de quando você entra e deixa lições e executa exemplos. 
Isso pode ser usado por pessoas que utilizam o TclTutor como uma ferramenta de 
ensino para monitorar o progresso do estudante.
<P>
<B>Permite/Desativa Log de Envio de Mensagens</B>: Em sistemas suportados, 
TclTutor pode enviar o log de atividade para Clif Flynt, autor desse programa. 
Ele utiliza esses logs para verificar quais lições estão consumindo mais tempo, 
quais exemplos ocasionaram erros, entre outros, para descobrir quais lições 
precisam ser melhoradas ou alteradas.
<P>
Se você achou esse nível de explicação muito repetitivo, mova o cursor para 
o botão rotulado <B>Nível</B>, então pressione e solta o botão esquerdo 
rapidamente. Isso irá exibir os três níves de experiência. Os níveis são 
listados em ordem de experiência.
<P>
Se você clicar duas vezes em uma palavra na janela <B>Lição</B> ou 
<B>Exemplo de código</B>, TclTutor irá tentar chamar uma cópia do <B>tkman</B> 
ou a janela de Ajuda Microsoft para exibir a página do manual para aquela 
palavra. Se a página do manual não existe, então <B>tkman</B> irá exibir a 
apropriada mensagem de erro.
<P>
A larga seção do meio da janela exibe o exemplo de código que ilustra os 
conceitos que estão sendo discutidos na janela de texto do topo. Algumas 
vezes este script estará incompleto, ou terá erros intencionais. <B>Não 
se aborreça com as mensagens de erro.</B>
<P>
A última janela  exibe a saída do código na janela <B>Exemplo de código</B>. 
Se há uma erro no código, esta janela irá conter a saída da correta 
porção do script, seguido por uma pausa de erro, e a mensagem de erro. 
Quando um erro ocorre, a linha com o erro é destaca na janela <B>Exemplo de código</B>.
<P>
Há um código na janela <B>Exemplo de código</B> agora. Clique com o botão 
esquerdo do mouse no botão <B>Executar exemplo</B>, e você verá as palavras 
"A próxima linha tem um erro" seguidas por uma mensagem de erro na última 
janela janela.A segunda linha na janela <B>Exemplo de código</B> será destacada.
<P>
Você pode editar o código na janela <B>Exemplo de código</B> movendo o cursor 
para o caracter que você quer mudar e clicando com o botão esquerdo do mouse. 
Neste ponto, você verá uma linha vertical piscando onde o ponteiro do mouse 
está. Você pode digitar um novo texto, o qual será inserido na linha com o 
cursor piscante, apagar o caracter à esquerda do cursor com a tecla backspace, 
ou apagar o caracter à direita do cursor piscante com a tecla delete.
<P>
Tente adicionar aspas duplas (") no final da segunda linha, e clique no 
botão <B>Executar exemplo</B> novamente.
<P>
Quando você terminar de brincar um pouco com as janelas, barras de 
rolagem e botões, você estará pronto para a próxima lição.
:TEXT_END:
<P>
:CODE_START:
puts "A próxima linha contém um erro"
puts "Essa linha precisa de aspas duplas no seu final
:TEXT_END:
<P>
