		========================================
			Agenda - verso 2.3 beta	
		              OS/2 - Warp
		      autor: Geraldo M. Fontes Jr
	            contato: gfontes@tropical.com.br
		========================================

Introduo:
-----------

	Se voc chegou at aqui  porque pelo menos se interessou em experimentar
meu progrma. Obrigado.
	AGENDA , como se pode deduzir pelo nome, uma pequena agenda de compromissos
e telefones. Roda em modo texto, tanto em tela cheia como em janela. Tem a
interessante caracterstica de mostrar um compromisso marcado para o dia
assim que se liga (ou se re-inicia) o computador, bastando para isso um nico
parmetro de linha de comando no startup.cmd ou na janela "Inicializao". Veremos mais
adiante como colocar isso para funcionar.
	Esse programa foi originariamente escrito para o DOS, usando o Turbo Pascal.
Posteriormente foi portado para o OS/2, tendo sido utilizado o Free Pascal para
compil-lo. Com poucas modificaes no cdigo fonte, tambm  possvel rodar a
AGENDA em outros sistemas operacionais, desde que uma verso do Free Pascal esteja
disponvel para o mesmo.


Instalao:
-----------

	Uma vez que a AGENDA est ainda em fase beta, no h nenhum programa para
efetuar a instalao da mesma. Mas com pouqussimo trabalho, poderemos fazer a insta-
lao manual do programa. Vejamos:
1) Em um diretrio qualquer, suponhamos C:\RASCUNHO, descompacte o arquivo AGENDA.ZIP:
   UNZIP AGENDA.ZIP

2) Crie um diretrio para os arquivos da AGENDA. Suponhamos "C:\AG":
   MD C:\AG

3) Copie os arquivos "agenda.exe" e "agenda.ico" para esse diretrio:
   COPY C:\RASCUNHO\AGENDA.EXE C:\AG
   COPU C:\RASUNHO\AGENDA.ICO C:\AG"

4) Crie um objeto-programa para o arquivo AGENDA.EXE na pasta "Inicializao" (em ingls
   deve ser "Startup" ou algo assim. Meu Warp  em portugus e eu nunca vi a verso em
   ingls, por isso estou supondo que o nome da pasta seja esse).

5) Na linha "Parmentros" do bloco de notas "Definies" desse objeto-programa, coloque
   "/v" (sem as aspas).

6) Em alguma outra pasta ou diretamente no Ambiente de Trabalho, crie outro objeto-pro-
   grama para a AGENDA, mas no coloque nenhum parmetro na linha "Parmetros".

7) Os campos "Diretrio de trabalho" de ambos os objetos-programas devem apontar para o
   diretrio da AGENDA. Em nosso exemplo, C:\AG.

	Pronto! Est conluda a instalao da AGENDA. Para utiliz-la, abra o
objeto-programa criado no passo 6 acima. A  s marcar seus compromissos e anotar os
telefones dos amigos.
	Quando o sistema for iniciado, o objeto-programa que est em "Inicializao"
(passo 4), entrar em ao, verificando se h algum compromisso para a data atual.
Somente se houver algum,  que a AGENDA ser aberta mostrando o compromisso.


Utilizao:
----------

	Nessa fase no tenho ainda condies de disponibilzar um manual completo da
AGENDA. Por essa razo, vou dar somente algumas dicas para tirar mais proveito da mesma.
	Na tela de Incluso de Compromissos, basta somente teclar ENTER para abrir a
data atual. Os compromissos podem ser digitados linha-a-linha, teclando ENTER ao final de
cada uma. Para eliminar uma linha inteira, teclar ESC.
	Na tela de alterao de Telefones e Endereos, vale o que foi descrito acima, ou
seja, ENTER para mudar de campo, ESC para eliminar o contedo de um campo. A eliminao
do campo NOME, elimina todo o registro, mas ser emitido um prompt de confirmao.
	A Pesquisa de Telefones e Endereos poder ser feita pelo nome ou pelo telefone,
bastando digitar qualquer desses campos para efetuar a pesquisa. O primeiro nome ou tele-
fone que atender ao critrio digitado, ser mostrado.
	Use a consulta geral para ver todos os nomes e telefones arquivados pelo programa.


Compilando a AGENDA:
--------------------

	Junto com o programa, voc est recebendo tambm o cdigo-fonte completo do mesmo.
Para compilar o mesmo, ser necessrio ter instalado em seu sistema o Free Pascal, verso
1.0.4 ou superior. O comando para compilar  o seguinte:

   PPC386 AGENDA

	No h nenhum MAKEFILE, j que uma nica linha basta para fazer todo o servio pesado.
Se fizer qualquer modificao no cdigo-fonte, peo que me envie uma cpia, mostrando o que
foi mudado, para que eu tambm possa tirar proveito da sua cratividade. Acrescentarei ao
"cdigo oficial" as mudanas que forem julgadas importantes e disponibilizarei a nova verso
ao pblico.


Outros Idiomas e Sistemas Operacionais:
---------------------------------------

	Por enquanto, o nico sistema em que a AGENDA foi testado  o OS/2 e o nico idioma
em que est disponvel  o portugus. No tenho condies de trabalhar em mais idiomas e
sistemas, embora ache que seja interessante disponibilizar o programa particularmente em
ingls e para outros sistemas (Linux, Amiga etc). Algum se habilita? Voluntrios so bem
vindos.


Licena de Cpia e Utilizao:
------------------------------

	Agenda pode ser livremente copiada e distribuda, desde que no sejam alteradas as
mensagens de propriedade contidas no cdigo original, bem como, nenhum arquivo seja retirado
do arquivo ZIP original. No h nenhuma restrio ou licena em particular a ser adotada, mas
creio que a filosofia da GNU-GPL seja aplicvel aqui. Use e abuse, mas disponibilize o cdigo
alterado para o pblico. Em especial, no se esquea de me enviar uma cpia.


Crticas e Sugestes:
---------------------

	Se voc testou o programa, deve ter alguma crtica a fazer, um comentrio qualquer,
uma sugesto, ou, at mesmo, um elogio. Sinta-se  vontade para entrar em contato
comigo.
	No vou prometer que colocarei em prtica todas as sugestes, j que isso iria
demandar um tempo maior do que eu tenho. Isso sem falar que no sou programador profissional
e portanto, no tenho aquela experincia que seria desejvel. Mas vou, pelo menos tentar
colocar em prtica. Quanto s crticas, aceitarei todas com humildade, porque sei que s
iro nos beneficiar a todos.

				Um grande abrao a todos que se dispuseram a testar a AGENDA

							Geraldo M. Fontes Jr									      Vila Velha - ES - Brasil