		========================================
			Agenda - verso 2.3 beta 3	
		              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 e em letra minscula).

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 disponibilizar 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 TAB ou SHIT+TAB
ao final de cada uma. Tambm  possvel navegar entre as linhas ustilizando-se as setas.
Para eliminar uma linha inteira, teclar ESC. ENTER finaliza a edio de um dia.
	Na tela de alterao de Telefones e Endereos, vale o que foi descrito acima,
ou seja, TAB e SHIFT+TAB mudar de campo, ENTER para finalizar a edio e 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, 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 criatividade. 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, que 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.


Garantia
--------

	O programa  fornecido como est. No h nenhuma garantia explcita ou implcita com
relao ao mesmo. Use-o por sua conta e risco.
	Sob nenhuma hiptese eu deverei ser responsabilizado por qualquer dano causado pela
utilizao do software.


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