#################################################################
# DO NOT EDIT!
#
# This file is automatically generated from files in the Text/ subdirectory
#
#  TkRat software and its included text is Copyright 1996-2002 by
#  Martin Forssen
#
#  The full text of the legal notices is contained in the file called
#  COPYRIGHT, included with this distribution.
#


# The following is the function which does the actual work
proc init_help_it {} {
global help
set help(title,intro) Introduzione
set help(intro) {                        Sistema d'aiuto per TkRat


  Introduzione

TkRat e' un programma di posta elettronica (MUA da Mail User Agent), che può
gestire, ricevere e spedire messaggi email.

La finestra principale di TkRat e' la "finestra cartella". Questa e' la
finestra che appare all'avvio di TkRat. La barra dei menu e una linea di
stato che descrive la cartella attiva si trovano in alto alla finestra. Al
di sotto e' visualizzata la lista dei messaggi contenuti nella cartella, che 
possono essere selezionati con il mouse per vederne il contenuto nella parte
inferiore della finestra. Sotto la lista dei messaggi c'e' un'altra linea di
stato e una fila di bottoni. Infine, il contenuto del messaggio selezionato
viene mostrato nella zona inferiore.

Prima di spedire un messaggio e' necessario scriverlo. Ci sono vari modi per
raggiungere la finestra di composizione. Se vuoi creare un nuovo messaggio,
devi premere sul bottone Componi. Se invece vuoi rispondere al messaggio
corrente, premi uno dei bottoni di risposta.

Normalmente la finestra cartella mostra la tua INBOX, cioe' la cartella dove
viene messa la posta in arrivo. Quando hai letto (e forse risposto) ad un
messaggio, magari vuoi salvarlo da qualche altra parte, per mantenere
"ordinata" la tua INBOX. Per fare ciò bisogna muovere il messaggio in
un'altra cartella.

Se un nuovo messaggio arriva mentre il programma e' iconizzato, una piccola
finestra di "osservazione" appare.

TkRat e' un programma molto complesso. Nonostante abbia cercato di renderlo
facile da usare, la complessità viene dimostrata dalle varie opzioni che e'
possibile personalizzare. Tutte le varie opzioni dovrebbero avere valori
standard "ragionevoli".

  Maggiori informazioni

Informazioni riguardo la versione più recente, ecc. si possono trovare all'URL

 http://www.TkRat.org/
}
set help(title,deleting) {Cancellare messaggi}
set help(deleting) {				Cancellare messaggi

La cancellazione dei messaggi avviene in due tempi. Prima i messaggi vengono
contrassegnati per la cancellazione, e poi, più tardi, i messaggi vengono
rimossi fisicamente dalla cartella.

I messaggi contrassegnati per la cancellazione sono indicati da una 'D'
nella lista dei messaggi. Per contrassegnare un messaggio per la
cancellazione e' sufficiente premere il bottone "Cancella". Tutte le normali
operazioni sono possibili su tali messaggi fino a che non vengono rimossi
definitivamente dalla cartella.

E' possibile rimuovere il segno 'D' dal messaggio corrente selezionando la
voce "Annulla cancella" dal menu "Messaggi".

La cancellazione fisica dei messaggi contrassegnati avviene quando si
sincronizza o aggiorna la cartella (tramite gli opportuni comandi del menu
"Amministrazione", o quando si chiude la cartella (aprendo un'altra cartella
chiude la cartella corrente. Ciò accade anche quando si esce da TkRat).
}
set help(title,grouping) {Raggruppare i messaggi}
set help(grouping) {				Raggruppare i messaggi

Raggruppare i messaggi e' un modo conveniente per eseguire certe operazioni
su più messaggi contemporaneamente.

Il gruppo corrente consiste in tutti i messaggi selezionati nella cartella
corrente. I messaggi selezionati sono contrassegnati da una 'F' nella lista
dei messaggi (la F fa parte dello stato del messaggio, cosi' se il formato
della lista non contiene %S, non sarà visibile). I messaggi rimangono
selezionati anche dopo un'operazione.

Al momento le seguenti operazioni sono ammesse su un gruppo (tramite il menu
"Gruppo"):
  * Cancella	- Contrassegna i messaggi per la cancellazione
  * Annulla cancella - Recupera i messaggi contrassegnati per la cancellazione
  * Muovi       - Muove i messaggi in un'altra cartella    

Ci sono cinque modi differenti per aggiungere/rimuovere messaggi da un
gruppo:

  * Usando il comando "Cancella selezione di gruppo" dal menu "Gruppo".
    Questa opzione deseleziona tutti messaggi contrassegnati dalla 'F'.

  * Premendo il tasto destro del mouse su un messaggio nella lista dei
    messaggi. Questo seleziona/deseleziona il messaggio.

  * Usando il comando "Crea in finestra..." dal menu "Gruppo"
    Verrà aperta una finestra a parte che contiene una lista di tutti i
    messaggi della cartella corrente in cui e' possibile selezionare e/o
    deselezionare messaggi. Premendo Ok i messaggi selezionati verrano
    raggruppati.

  * Usando il comando "Crea con chiave..." dal menu "Gruppo".
    Verrà aperta una finestra dove e' possibile inserire una chiave secondo
    la quale verranno selezionati i messaggi.

  * Usando il comando "Usa chiavi salvate" dal menu "Gruppo". Questo menu
    contiene un sottomenu con le chiavi salvate in precedenza.
}
set help(title,folders) Cartelle
set help(folders) {                            Folders

A folder is a collection of zero or more messages. There are a lot of
different ways of storing and accessing the messages in a folder. TkRat
currently understands four different types of folders.

To open a folder, you need to know which type it is, and some additional type-
specific data about it. To help you, TkRat has something called Virtual folders
(also known as vfolders). When you define a vfolder, you have to specify a
name, type, and all other data about the folder. This name will then appear in
the "Folders" and "Move" menus for easy selection and message insertion.

  The following types of folders are supported

* UNIX mailbox
  A UNIX mailbox consists of a flat text file where the messages are separated
  by a certain marker line (which starts with "From " or "^A^A^A"). This is the
  normal way of handling mail on UNIX systems.
  Data needed: The name of the file

* IMAP4
  IMAP (version 4) is a protocol for accessing mailboxes over a network.
  One user can have multiple IMAP mailboxes on one host. If you wish to use
  rimap-style authentication, you should make the port number field empty.
  Data needed: The name of the server
	       Which user to access the folder as
	       A password (asked for when opening the folder)
	       The name of the mailbox

* Disconnected
  A disconnected folder is a local copy of an IMAP folder. These folders
  are then synchronized so that any changes made to one of them are mirrored
  in the other. This is very useful for reading and answering your mail
  offline.
  Data needed: The name of the server
	       Which user to access the folder as
	       A password (asked for when opening the folder)
	       The name of the mailbox

* POP3
  POP (version 3) is a protocol for accessing mailboxes over a network.
  Each user can have a maximum of one POP mailbox on one host.
  Data needed: The name of the server
	       Which user to access the folder as
	       A password (asked for when opening the folder)

* Database
  A database folder is a collection of messages where each message has
  keywords associated with it. Opening the database is equivalent to
  searching it (you can search for attributes other than the keywords).
  Messages can also have an expiration time, and when this time is reached,
  something happens to the message (it may, for example. be deleted). Every
  user can have one database each (you can only access your own database).
  Data needed: A search expression
	       Expiration time and type (for insertion)

* Dynamic
  This is a special form of the File folder. It is specified as a directory,
  and when you insert messages into it, the message is actually placed in
  a file folder in that directory. The name of the file folder is the first
  part of the sender's email address. When you open a dynamic folder, you will
  see a list of the files in that directory.
  Data needed: The name of the directory
}
set help(title,folderdef) {Definizione cartelle virtuali}
set help(folderdef) {				Defining folders

TkRat lets you organize your folders in a tree-like structure. This structure
is then used to build the Folders and Move menus. When you call "New/Edit
folder" the vfolderdef window will appear. This window lets you modify the
structure, add/edit/delete folders, etc.

One important fact to remember is that the structure only exists within TkRat
and does not necessarily reflect the actual layout on disk.

The "Define virtual folder" window is divided into two parts. The left part
shows the tree and the right part shows details about the currently selected
node in the tree. The tree has two nodes at the top level, one which contains
all your IMAP servers and one which contains all the folders. You can drag and
drop folders in the folder part of the tree. And, pressing the right
mousebutton gives you a small context menu which, among other things, allows
you to delete the current node.

One of the folders has the string 'INBOX' to the right of it, this is the
designated inbox. It means that this is the folder TkRat opens by default when
starting. It may also be used when expiring the database. You can have only
one INBOX.

Folders can be used to store outgoing messages. The folder to store the
messages in can be configured separately for each role in the Preferences 
window (see also 'Roles').

  Importing folders

For some folder types (file, imap and mh) you can import an entire structure
of folders. To do this, select the appropriate Import-type of a folder. Then,
provide the path to the folders that will be imported. What you have to write
here depends on the mailbox type and server, common good values are nothing
and the full path to your home directory. For IMAP imports you can also
specify if the folders should be imported as disconnected folders (which means
that TkRat will keep a local copy of them).

The next field to fill in is the pattern. The pattern limits which folders to
actually import. Only folders matching the pattern will be imported. There are
two wildcards which may be useful. A '*' matches everything and will cause the
import to descend into matching subdirectories. A '%' matches all files but
does not descend into subfolders. You can also limit the import to only
subscribed folders.

Hint: If you are trying to import your IMAP folders from another program, you
should probably try with the 'Subscribed folders only' option enabled
first. Another tip is that, when you are unsure what you actually will import,
then try with pattern '%' to avoid recursing your entire file system. 

It may be worthwhile to note that the structure of imported folders is
read-only. That is, you can not drag and drop among imported folders. Also,
any changes you make to the layout on disk will be picked up the next time
you re-import the folder.
}
set help(title,dbase) {Il Database}
set help(dbase) {				Il database

Il database e' un metodo per salvare messaggi. Ciascun messaggio e' associato
con alcune parole chiave e una data di scadenza (che può essere infinita).

Quando un messaggio viene inserito nel database, e' possibile assegnarvi le
seguenti informazioni:
  * parole chiave       - una lista di parole chiave (opzionale)
  * data di scadenza    - una data in cui il messaggio verrà considerato
			  scaduto. La data viene indicata con un segno "+"
			  e un numero di giorni. Il campo può rimanere vuoto:
			  in questo caso il messaggio non scadrà mai.
  * azione di scadenza  - cosa accade quando il messaggio scade. Le scelte sono:
        * Rimouvi              - rimuove il messaggio
        * Inserisci in entrata - muove il messaggio nella cartella in entrata
        * Muovi in archivio    - muove il messaggio in qualche formato
				 d'archivio

Quando si vuole prelevare i messaggi dal database e' possibile effettuare una
ricerca sui seguenti campi: a, da, copia, soggetto, parole chiave e l'intero
messaggio. E' possibile prelevare messaggi che corrispondono a tutti i criteri
di ricerca o solo a uno.
}
set help(title,notification) Notifiche
set help(notification) {				Notifiche

	Cosa sono le notifiche

Le notifiche (il termine tecnico e' Delivery Status Notifications (DSN))
permette di sapere quando un messaggio e' stato consegnato al destinatario.
DSN lavora a livello SMTP, per cui e' necessario usare SMTP per spedire i
messaggi e, poiche' DSN e' un'estensione al protocollo, non tutti i server
SMTP lo supportano. Nella finestra delle preferenze vi e' un bottone "Prova"
che verifica il supporto DSN sul sistema locale. Tutti i sistemi che si
trovano tra il mittente e il destinatario devono supportare DSN perche'
questo funzioni.

	La finestra notifiche

La finestra notifiche contiene una lista di tutti i messaggi per cui e'
stata richiesta una notifica spediti negli ultimi sette giorni (il lasso di
tempo e' configurabile). Per ogni messaggio viene indicata la data di
spedizione, il soggetto e i destinatari. Prima di ogni destinatario vi e' un
indicatore dello stato corrente. Ci sono sei diversi stati:

-		- Significa che TkRat non sa ancora niente.
Fallito	        - Significa che il messaggio non ha potuto raggiungere il
		  destinatario.
Consegnato	- Il messaggio e' stato consegnato, ma ciò non implica che sia
		  stato letto.
Trasferito	- Il messaggio e' stato trasferito ad un server (MTA) che non
		  supporta le notifiche.
Espanso		- Il messaggio e' stato consegnato, ma la destinazione era un
		  alias che e' stato espanso a uno o più indirizzi diversi.
In attesa	- Il messaggio non e' ancora stato consegnato, ma ulteriori
		  tentativi verranno effettuati.

E' possibile ottenere più informazioni, clickando con il pulsante destro
del mouse sulla linea del destinatario. In questo modo apparirà una
finestra contenente maggiori dettagli.

	Il dettaglio delle notifiche

La finestra dei dettagli sulle notifiche contiene del testo leggibile, che
descrive cosa ha causato la notifica. Al di sotto vi sono dei campi che
possono aiutare ulteriormente a capire cosa e' andato storto (oppure no). Il
pulsante "Mostra altro del messaggio di ritorno" mostrerà altro testo
utile contenente le porzioni del messaggio originale ritornate nella
notifica.

Per maggiori informazioni tecniche riguardo le notifiche, vedere gli RFC
1891, 1893 e 1894.
}
set help(title,userproc) {Procedure Utente}
set help(userproc) {			User defined procedures

User defined procedures are a way for the user to have more control over
certain features. The procedures are ordinary tcl procedures (i.e. they are
written in tcl7.5). None of the procedures must exist, they will be used
only if they exist.

The user may define procedures in the ~/.ratatosk/userproc file (or
whatever the userproc option is set to). If the procedures need any global
variables, these must start with "ratUP_". The following procedures may
be defined:

RatUP_IsMe mailbox domain personal adl
        mailbox  -      Mailbox name
        domain   -      The domain part
        personal -      The personal name phrase (if any)
        adl      -      At-domain-list source route
    This procedure should determine if the address is pointing to me or not.
    It should return a boolean value, which should be true if the address
    is pointing at me.

RatUP_Translate mailbox domain personal adl
        mailbox  -      Mailbox name
        domain   -      The domain part
        personal -      The personal name phrase (if any)
        adl      -      At-domain-list source route (probably empty)
    When we are replying to a message, all addresses we are sending to
    are run through this procedure. It is expected to return a list with
    four elements {mailbox domain personal adl}.

RatUP_Signature message
	message -	The name of a global array which may contain
			information about the message the signature will be
			appended to
    This function should return a text string which will later be
    appended to the first text part of the message. The message argument is
    the name of a global array which MAY contain information about the message.
    See the section on RatSend in the interface file). Note that this routine
    gets called before the user has had any chance to edit the message so
    there will not be any interesting information available at all for
    new messages.  It only contains interesting things for replies and
    forwards.

RatUP_Bell
    This function should notify the user that new mail has arrived. If
    this function does not exist, then the terminal bell is rung.

RatUP_ShowURL url
        url -   A URL to show
    This function may get called when the user presses the left mousebutton
    over a URL in a message. It is expected to invoke a browser (in the
    background).

RatUP_Citation message
        message -       The handler for the message which is being cited
    This function should return a string which will be prepended to all
    lines in the body of the cited message. It will be called when you reply
    to a message.

RatUP_NetsyncFolder spec user prot
        spec -  A network folder specification {host:port}mailbox
        user -  User to connect as
        prot -  Protocol (currently always imap)
    This function should return a boolean value which indicates if
    the disconnected folder given as an argument should be synchronized
    at this moment or not. That means that this function will be called
    once for each disconnected mailbox when you select "Network sync"
    from the menu. It will NOT be called when you select "Network sync. folder"
    from the Admin menu to synchronize the current folder.
}
set help(title,bugreport) {Rapporto malfunzioni}
set help(bugreport) {				Rapporto malfunzioni

Si dovrebbero spedire malfunzionamenti a maf@TkRat.org. Il modo
migliore per fare ciò e' di selezionare "Spedisci malfunzione..." dal menu
d'Aiuto (della finestra cartella). In tal modo verrà aperta una finestra di
composizione con uno schema di malfunzione. Il destinatario e' già
inserito, cosi' come parte del soggetto. Si deve completare il soggetto e
scrivere una descrizione dettagliata di cosa ha causato la malfunzione (e la
malfunzione stessa) nel corpo del messaggio.

TkRat include automaticamente un allegato contenente informazioni riguardo
la configurazione. Questo allegato contiene l'output di "uname -a" del
sistema, la versione e la data di TkRat, la versione di tcl/tk e una copia
di tutte le preferenze selezionate.

Se si vuole vedere esattamente cosa viene spedito si può guardare il file
~/.ratatosk/send/rat.X.Y (e' probabilmente l'ultimo file). Questo file viene
creato quando si seleziona "Spedisci malfunzione..." e viene rimosso quando
la malfunzione viene spedita.
}
set help(title,roles) Roles
set help(roles) {                              Roles

The Roles feature is a way for you to have different identities. Associated
with each role is address info and also settings on how to send email. You can
then always change the role and the selected role will affect composed
messages. You can also associate roles with folders so that, when working with
a particular folder, you use a particular role.

Roles are defined in the Preferences window. To create a new role, select
'Roles' in the tree and then press 'Create new role.' This will create a new
role in the tree and you can then edit it as much as you want.

In the 'Save outgoing' field, you may define a folder in which messages sent
using this role should be saved by default.
}
}
#
# DO NOT EDIT!
# This file is automatically generated from files in the Text/ subdirectory
##############################################################################


