$VER: Documentazione sintetica di DATARIO 1.2


Per visualizzare correttamente questo documento bisogner aprirlo con un
editore MS-DOS (tipo EDIT).


------------------------------------------------------------------------
          DATARIO 1.2 (c)1997 Copyright di Giovanni Iacobelli
                                
                         Software per MS-DOS

                           F R E E W A R E
------------------------------------------------------------------------
                               INDICE

. Che cos' Datario?

. Installazione

. Uso

. Requisiti

. Distribuzione

. Autore (scheda biografica)

. Comunicazioni per gli utenti

------------------------------------------------------------------------






Che cos' DATARIO?

Quando ho  acquistato il mio Pentium mi  stato dato in dotazione  vario
software tra cui  un 'agenda  elettronica.  Tale  agenda  funziona sotto
Windows    ha  caratteristiche   sorprendenti:  gestisce  appuntamenti,
obiettivi, invia fax, gestisce  la contabilit, etc.. Il fatto  che non
mi consente di  avere un diario,  ossia  delle pagine in cui mettere ci
che ho fatto  durante  la giornata e quindi  ho sentito la  necessit di
crearmi un programma che faccia proprio e solo questo.

DATARIO  appunto un diario.

Caratteristiche principali:

1. un'intuitiva interfaccia utente (in semigrafica);

2. un potente Diario Editor;

3. un'utilissima Vista Mese;

4. la memorizzazione dell'archivio in modo RANDOM;

5. richiede circa 120 Kbytes di Ram e computer con processore 286;

6. pieno supporto mouse;

7. una rubrica telefonica che pu gestire fino a 255 nominativi;

------------------------------------------------------------------------



Installazione

DATARIO non richiede una  particolare installazione:  basta  copiare  il
file binario 'DATARIO.EXE' nella directory voluta.
Il programma alla  prima partenza provveder automaticamente a creare le
sub cartelle e i files necessari per il suo funzionamento.



------------------------------------------------------------------------






USO

DATARIO  dispone  di  un' interfaccia  in  semigrafica  composta  da tre
finestre principali: nella  pi  grossa   visualizzato il calendario; a
destra del calendario vi  una quadro informativo contenente notizie sul
programma, sull' autore  e  la  lista  dei  tasti  rapidi; infine c' la
Console dei Comandi.


 gadget di chiusura
  
             caldendario                         Quadro Informativo
ĳĳĿ
[]                                                                    
  ͻ  Oggi 24  GIUGNO 1997 Martedi   
   Ŀ                                                            
   Vista  [+]GIUGNO[-]   [+]1997[-]  Ŀ  
                                Datario v1.2 -> FREEWARE <-   
   Lun  Mar  Mer  Gio  Ven  Sab  Dom                                 
  ĺ  Autore: Giovanni Iacobelli    
                            1            Via Viole n.1         
  ĺ          82032 Cerreto S.      
    2   3   4   5   6   7   8            Benevento - ITALIA    
  ĺ                                
    9  10  11  12  13  14  15    Questo software dovr essere  
  ĺ  distribuito gratuitamente.    
   16  17  18  19  20  21  22    L'autore ne conserva tutti i  
  ĺ  diritti.  Non  data nessuna  
   23  24  25  26  27  28  29      
  ĺ  Ŀ    Ŀ    Ŀ   
   30                            Vai a    Salva    Reset   
  ĺ             
                                       Ŀ  
                                       \>                            
                Orario > 23:57:20                                  
  ͼ    
                                                   Orario > 23:57:20  
ĳ
                                              
                                      Console dei Comandi


Nel calendario    visualizzato  il mese e il giorno corrente. Il giorno
corrente, alla partenza,  preso dalla data del Sistema.





COME CAMBIARE LA DATA CORRENTE ?

E' possibile cambiare la data  corrente agendo con il mouse o premendo i
seguenti tasti:

        Cursore sinistro       sposta di un giorno indietro;
        Cursore destro         sposta di un giorno avanti;
        Cursore gi            sposta di una settimana in avanti;
        Cursore su             sposta di una settimana indietro;
        Home                   porta la data al primo giorno del mese;
        End                    porta la data all'ultimo giorno del mese;
        Ctrl + W               sposta di un mese in avanti;
        Ctrl + Q               sposta di un mese indietro;
        Ctrl + X               sposta di un anno in avanti;
        Ctrl + Z               sposta di un anno indietro;

Se si utilizza il mouse, per cambiare il mese e l'anno si dovr agire sui
gadget [+] e [-].  Per cambiare il giorno  basta cliccare col mouse nella
casella del giorno desiderato (il doppio click o cliccando  sulla casella
gi selezionata far richiamare il Diario Editor).

In alternativa   possibile utilizzare la Console dei Comandi premendo il
tasto F7 o cliccando col mouse sul gadget [VAI A] e quindi  immettendo la
data rispettando la sintassi gg/mm/aaaa, ad esempio:

        \> 19/06/1998   e battendo il tasto [Return]

Cambiare  la  data  mediante  la Console  dei Comandi risulta molto utile
quando la data desiderata  molto distante da quella corrente.

Cambiare  la  data corrente non significa cambiare la data del Sistema a
meno che non lo si voglia.

Se si vuole riportare la data del  diario a quella del Sistema Operativo
baster premere il tasto funzione F3 o cliccare sul gadget [RESET].

Se si vuole riportare  la data  del  diario  a quella precedente baster
premere il tasto funzione F4;

E' possibile  accedere  ai  vari  gadget  della  schermata attraverso la
tastiera:  una  volta  aver  portato  il cursore  sul  gadget desiderato
mediante il tasto TAB e SHIFT+TAB, si dovr premere il tasto RETURN.





SE SI VUOLE CAMBIARE LA DATA DEL SISTEMA...

Per  cambiare  la  data  del  Sistema,  dopo  averla spostata nel giorno
desiderato,  baster premere  il tasto  funzione F2 o cliccare il gadget
[SALVA]. DATARIO,  prima  di procedere, chieder  conferma attraverso un
Request.




COME FUNZIONA IL REQUEST ?

Mediante i tasti cursore (freccia sinistra e freccia destra)  possibile
selezionare l'azione desiderata.  Dopo  di ci si dovr premere il tasto
Return.  Col mouse  basta  cliccare sul gadget corrispondente all'azione
desiderata.





COME FUNZIONA IL QUADRO INFORMATIVO ?

Il Quadro Informativo  visualizzato in un finestra scorrevole, pertanto
per  poter  visionare  l'intero  contenuto  si  dovr  far  scorrere  la
finestra. Se si opera  con il mouse,  si dovr agire sullo slider  posto
nel bordo dx.  In alternativa,  mediante i tasti PGDN e PGUP  possibile
far scorrere il testo.





SE SI VUOLE SAPERE IL NUMERO DI GIORNI TRA DUE DATE ?

Nella parte inferiore del  calendario   visualizzato il numero di giorni
trascorsi  dalla  data precedente a quella corrente.  Questa informazione
ci consente di conoscere il numero di giorni intercorrenti tra due date.
Se ad esempio si vuole sapere quanti giorni ci sono tra il 25 Giugno 1997
e  il 1 Gennaio 2000,  si dovr  portare il calendario prima al giorno 25
Giugno 1997 e poi al giorno 1 Gennaio 2000 (o viceversa).





COME SI FA PER USCIRE DAL PROGRAMMA ?

Quando  visualizzata la schermata  principale basta cliccare sul gadget
di chiusura  o  premere  il tasto Esc.  Prima  di  uscire  sar  chiesta
conferma mediante un Request.





COME FUNZIONA IL DIARIO ?

Dopo aver portato il giorno corrente nel giorno desiderato, per accedere
alla corrispondente  pagina del diario,  si  dovr  cliccare  sul gadget
DIARIO o  in  alternativa  effettuare  un doppio click sulla casella del
giorno oppure premendo il tasto funzione F6
La pagina del diario  verr aperta nell'Diario Editor che ci consente di
leggerla o di modificarla.





COME FUNZIONA IL DIARIO EDITOR ?

Il Diario Editor  un editore di pagina.
E' composto da una barra dei men  dov' visualizzata la data corrente e
e la  modalit  di  scrittura  (inserimento  o sovrascrittura);
Sotto  c' la barra  dei  messaggi  dove  vengono appunto visualizzati i
messaggi;
Poi c' l'Area  Diario che  l'area in cui si potr digitare il testo.
L'Area Diario  composta da 20 righe di 80 caratteri ciascuna;


 gadget di chiusura              Area Diario                      modalit
                          men                                      
ĳĳĿ
[] File  Editore  Varie  <           24  GIUGNO  1997 Martedi    INS 
ĳĴ
       barra dei messaggi >                                    11:05 
ͳʹ
Mio annomastico.                                                      
                                                                  orario
DATARIO: ho lavorato ai vari gadgets della schermata principale;        
         ho corretto alcune anomalie del mouse nel Diario Editor;       
                                                                        
Ho effettuato lo scandisk del disco fisso.                              
                                                                        
                                                                        
                                                                        
                                                                        
                                                                        
                                                                        
                                                                        
                                                                        
ʹ     
                         B             F         
  
                                                              
 barra dei caratteri semigrafici         colore fondo      colore testo




    Il Diario Editor  provvisto di 3 menu:


    Men File

        Rilegge            rilegge la pagina del diario dal disco;
                          
        Salva              salva la pagina del diario sul disco;

        Salva & Esce       salva e ritorna alla schermata principale;

        Stampa             stampa su carta la pagina del diario;

        Help               visualizza un finestra d'aiuto contenete
                           la lista dei tasti rapidi;

        Esce               ritorna alla schermata principale;



    Men Editore

        Pulizia video        cancella tutti i caratteri presenti nell'
                             Area Diario;

        Cancella linea       cancella la linea posta sotto il cursore;

        Cancella fine linea  cancella la linea dal carattere sotto il
                             cursore alla fine della riga;

        Centra linea         porta la linea posta sotto il cursore al
                             centro dello schermo;
        
        Taglia               rimuove e copia la linea sotto il cursore
                             nel buffer;

        Copia                copia la linea sotto il cursore nel buffer;

        Incolla              inserisce il contenuto del buffer nella
                             posizione corrente ( sensibile alla
                             modalit corrente di inserimento);


    Men Varie

        Esporta come ascii   salva la pagina del diario in un file ascii

        Cambia modalit      passa da inserimento a sovrascrittura e
                             viceversa;

        Attiva/Disattiva Orario   Attiva e disatttiva la visualizzazione
                                  dell'orario nel diario editore.


    Per  accedere  ai  men  si  pu  agire  mediante il mouse o tramite
    tastiera utilizzando le combinazione:

        ALT + F         attivazione men File;

        ALT + E         attivazione men Editore;
        
        ALT + V         attivazione men Varie;

    Per selezionare una voce del men con la tastiera si dovr agire con
    i tasti cursore e il tasto Return per azionarla.
    Col mouse  basta  cliccare sulla voce desiderata: la prima volta per
    selezionarla e la seconda volta per azionarla.

    Tutte le funzioni  sono  corredate  da  uno speciale  tasto o da una
    combinazione di tasti che ci permettono di richiamarle velocemente:

    Tasti Rapidi                    DESCRIZIONE

    Ins             cambia modalit (passa dalla modalit inserimento
                    alla modalit sovrascrittura e viceversa);

    Cursore Gi     sposta il cursore di una linea verso il basso;

    Cursore Su      sposta il cursore di una linea verso l'alto;

    Cursore Dx      sposta il cursore di una colonna verso destra;

    Cursore Sx      sposta il cursore di una colonna verso sinistra;

    Home            sposta il cursore all'inizio della linea;

    End             sposta il cursore alla fine della linea;

    PgDn            sposta il cursore all'ultima riga della pagina;

    PgUp            sposta il cursore alla prima riga della pagina;

    Ctrl + Y        cancella la linea posta sotto il cursore;

    Ctrl + D        ripulisce l'intera pagina;

    Alt +  C        porta al centro dello schermo la linea posta
                    sotto il cursore;

    Ctrl + F        cancella la linea dal carattere sotto il cursore
                    alla fine della linea;

    Ctrl + X        rimuove e copia la linea sotto il cursore nel buffer;

    Ctrl + K        copia la linea sotto il cursore nel buffer;

    Ctrl + V        inserisce il contenuto del buffer nella posizione
                    corrente;

    Alt + S         salva il diario in un file testo di formato ASCII;

    Alt + 1         cambia il colore del testo in bianco;

    Alt + 2         cambia il colore del testo in rosso;

    Alt + 3         cambia il colore del testo in nero;

    Alt + 8         cambia il colore del fondo in blu;

    Alt + 9         cambia il colore del fondo in rosso;

    Alt + 0         cambia il colore del fondo in nero;

    F2              salva il diario e ritorna alla schermata
                    principale;

    F3              salva il diario;

    F4              rilegge la pagina del diario;

    F5              Attiva/Disattiva la visualizzazione dell'orario;

    F10             stampa la pagina del diario su carta;

    Esc             esce dal Diario Editor.


Il Diario Editore  funziona  in  modo  analogo (quasi) a un  comune text
editor. Per creare una pagina di diario  basta inserire nell'Area Diario
il testo e salvare le modifiche  mediante la voce Salva o Salva&Esce del
men File.

Nella  parte bassa dello schermo vi  la barra dei colori e la barra dei
caratteri semigrafici.
La barra  dei colori serve per cambiare il colore del testo e del fondo:
attualmente sono supportati 3 colori per il testo e 3 per il fondo.
La barra  dei caratteri  semigrafici serve per facilitare la digitazione
di alcuni caratteri: basta cliccare col mouse sul carattere desiderato e
verr immediatamente stampato nella posizione corrente del cursore.
Per  visualizzare  la seconda  parte  dei caratteri semigrafici si dovr
cliccare sul gadget .






A CHE SERVE LA VISTA MESE ?

Se si vuole sapere  in  quali  giorni  del  mese   stato memorizzato il
diario, anzich  di aprire con  il Diario Editor tutti i giorni del mese
si potr ricorrere  alla Vista Mese.  Per chiamarla  si dovr premere il
gadget [VISTA] o i tasti ALT+M.

Nella  Vista  Mese  tutti  i  giorni  contrassegnati  dal  carattere ''
contengono il diario:


              ͻ
                                                               
                                M A G G I O                    
                                                                 V
                Lun    Mar    Mer    Gio    Ven    Sab    Dom  
              ĺ  I
                                   1     2     3     4   
                                                           S
              ĺ
                 5     6     7     8     9    10    11     T
                                                         
              ĺ  A
                12    13    14    15    16    17    18   
                                                     
              ĺ
                19    20    21    22    23    24    25     M
                                                  
              ĺ  E
                26    27    28    29    30    31         
                                                       S
              ĺ
                                                           E
                                                         
              ĺ
               1997 ͼ

                                                                        


Per  tornare  alla  schermata  principale  si  dovr  premere o la barra
spaziatrice o il tasto Esc o il tasto Return o un pulsante del mouse.





DOVE E COME VIENE MEMORIZZATO IL DIARIO ?

DATARIO non carica  tutto l'archivio in memoria ma legge e salva le note
direttamente  in un file.  Pertanto  il disco su cui il programma lavora
non deve essere protetto da scrittura.

Tutte le note vengono memorizzate  in un unico file posto nella cartella
DDATI e chiamato 120ASD12.DAT. DATARIO accede a tale file in modo RANDOM
grazie ad  un  secondo file chiamato 120ASD12.IND  che  contiene  i vari
indirizzi.

I file 120ASD12.DAT e 120ASD12.IND, pertanto, non devono essere in alcun
modo modificati onde evitare un cattivo funzionamento del programma.

Nel caso  che si verifichi  un errato funzionamento del programma oppure
si voglia cancellare  tutte le pagine del  diario,  bisogner cancellare
entrambi i file.




COME FUNZIONA LA RUBRICA TELEFONICA ?

Per visualizzare la rubrica  telefonica basta premere  il tasto F10 o il
relativo gadget.  La rubrica pu  gestire fino a 255 nominativi e il suo
uso  semplicissimo ed immediato.
I dati  della  rubrica  vengono memorizzati  nel file 120ASD12.RUB posto
nella directory DDATI.
Nel caso  che si verifichi  un errato funzionamento della rubrica oppure
si voglia cancellare tutti i records, bisogner cancellare tale file.

------------------------------------------------------------------------




Requisiti

DATARIO  ha poche pretese:  funziona  su qualunque  macchina con sistema
MS-DOS e con processore 286.

In realt  non  ho avuto  modo  di testare  il funzionamento su macchine
diverse dalla  mia ma  secondo il mio compilatore quelle sopra descritte
sono le configurazioni minime.

Funziona correttamente  sul  DOS  di Windows 95  e su MS-DOS 6.20, spero
che funzioni altrettanto bene sulle versioni precedenti di MS-Dos.

------------------------------------------------------------------------





Distribuzione

DATARIO  appartiene  alla  categoria  FREEWARE  e  ci significa che pu
essere  copiato  e  distribuito  liberamente.  Per  esso  nessuno  potr
pretendere alcuna somma  di danaro  tranne un piccolo costo per le spese
di copia e di distribuzione.

DATARIO  potr  essere  distribuito  assieme  a raccolte di programmi di
PUBLIC DOMAIN e/o SHAREWARE su CD-Rom o su floppy;

PUO' essere distribuito ovunque via rete e via etere;

PUO' essere distribuito liberamente da Televideo - Personal Software;

PUO' essere distribuito liberamente dal canale Mcmicrocomputer sia su
supporto magnetico sia su MC-Link;

PUO' essere distribuito compresso in un archivio;

NON PUO'  essere  distribuito in  propri pacchetti commerciali senza una
previa autorizzazione scritta dell'autore. A tal proposito contattare l'
autore al recapito postale citato in calce a questa documentazione;

NON PUO' essere usato dalla popolazione militare;

DOVRA' essere distribuito  assieme  a questa documentazione la quale non
potr essere in alcun modo modificata.

L'autore  non offre  alcuna  garanzia  sul  programma  e  non si riterr
responsabile in ogni caso dei danni di qualsiasi genere che il programma
o il suo uso potrebbe recare:

 OGNUNO USI QUESTO SOFTWARE A PROPRIO RISCHIO E PERICOLO!!!

Inoltre non  garantito il perfetto funzionamento del programma.

Se tu non vuoi accettare le mie regole, cestina il programma...


N.B.
Le condizioni  di distribuzione valgono per chiunque tranne per l'autore
che pu fare del programma tutto ci che vuole.


------------------------------------------------------------------------







Scheda biografica

IACOBELLI GIOVANNI  nato a  Benevento il  19 febbraio 1971  l'autore di
DATARIO.

DATARIO  uno dei suoi primi lavori  su computer MS-DOS in quanto fino a
marzo del 1997  si  era  dilettato  a programmare  su computer AMIGA: le
prime  routine  del  programma  sono   state  create  proprio  su questa
piattaforma e la versione 1.0   stata compilata nel 1996 con un vecchio
compilatore DOS mandato in esecuzione su un emulatore MS-DOS per AMIGA.

Le prime esperienze di programmazione dell'autore risalgono al COMMODORE
64 nel lontano 1989  dove si cimentava  nella realizzazione di programmi
con  il lento e 'impotente'  interprete  residente  nella  ROM  di  tale
macchina.  Con  la  perdita   dell' amato  C64  per  via  di  un  guasto
irreversibile,  l'autore passava nel 1994 nel mondo  AMIGA dove inizi a
lavorare con vari compilatori BASIC dalle prestazioni straordinarie.
Con  l'acquisto  del compilatore  DICE C  per AMIGA  nel 1995,  l'autore
iniziava  le  sue prime  esperienze di programmatore C.  In  seguito  al
fallimento della Commodore,  a causa della irreperibilit dell'hardware,
del software e di documentazioni utili alla programmazione, l'autore nel
1997 decideva di cambiare piattaforma acquistando un Pentium 150.


------------------------------------------------------------------------






                      ----------------------------
                      Comunicazioni per gli utenti
                      ----------------------------

Attenzione! DATARIO  in continua evoluzione e pertanto la documentazione
potrebbe non essere adeguatamente aggiornata.
Se  desideri  disporre  di  una  versione  sempre  aggiornata di DATARIO,
spedisci mediante vaglia postale  al recapito citato in calce la somma di
lire 10.000:  riceverai  un  floppy  da  3.5  floppy  (alta  densit) con
l'ultima  versione  disponibile.  Nelle comunicazioni del mittente dovrai
indicare la versione di DATARIO che possiedi, invece,  se  in passato hai
gi effettuato  un  aggiornamento  potrai  indicare  solo  il  tuo codice
personale che ti verr comunicato al primo aggiornamento.

Se l'aggiornamento  tarda  ad arrivare,  significa che la versione di cui
disponi  l'ultima  disponibile  o ne differisce  di poco. Non disperare,
l'aggiornamento arriver appena sar disponibile una nuova versione.

La somma di lire 10.000 valgono per un unico aggiornamento e servono  per
ripagarmi  delle  spese di copia  (supporto magnetico)  e  di  spedizione
postale. In essa  compresa una piccola donazione che fai per invogliarmi
alla programmazione: DATARIO  gratuito!
In  cambio  riempir  lo spazio  rimasto libero del floppy con altri miei
programmi di minore importanza,  alcuni  di  essi  saranno  corredati dai
sorgenti in linguaggio C o C++.

P.S.
Suggerisco di chiedere l'aggiornamento ogni 6 mesi.




Aggiornamenti gratuiti
======================
Un utente che abbia  effettuato almeno un aggiornamento potr o non potr
ricevere degli aggiornamenti gratuiti.

L'aggiornamento  gratuito  potr  giungere  per  vari  motivi,  quali  la
propaganda  di  altro  software  prodotto  dall'autore  o  per invogliare
l'utente  ad  effettuare  in  futuro  altri  aggiornamenti  mostrando  le
numerose migliorie della nuova versione.
                               
Il floppy contenete l'aggiornamento gratuito conterr unicamente la nuova
versione di DATARIO e l'eventuale materiale propagandistico.

Nel caso in  cui  la redazione  di Mcmicrocomputer decida di recensire il
programma, ricever ad ogni nuova versione l'aggiornamento gratuito.



N.B.
Gli aggiornamenti appartengono  alla  categoria  FREEWARE e pertanto sono
liberamente   distribuibili   salvo  diverse   indicazioni  poste   nella
documentazione allegata.
Qualsiasi  altro  materiale  memorizzato  sul  supporto  magnetico  dell'
aggiornamento  segue  le norme di distribuzione specificate nella propria
documentazione: qualora il materiale risulta privo di tale documentazione
 da considerarsi FREEWARE.



---------------------------- AUTORE -------------------------------------

recapito postale:

                IACOBELLI GIOVANNI   '71

                Via Viole n.1

                82032 Cerreto Sannita (BN)

                ITALIA


telefono:       0824-861899
------------------------------------------------------------------------
Chiunque  voglia  mettersi  in   contatto  con  l'autore  per  commenti,
segnalazioni di bug, suggerimenti e etc., lo pu fare liberamente.

