# Documentation at bottom of file
# Le spiegazioni sono in fondo a questo file
2796   -cVII/258/vv06&-out.all=1 veron13.txt
2797   -fI/297/out&-out.all=1 nomad.txt
2798   -cI/305/out&-out.all=1 gsc23.txt
2799   -fII/294/sdss7&-out.all=1&mode==1 sdss7.txt
2800   -fI/252/out&-out.all=1 usno_a2.txt
2801   -fI/315/out&-out.all=1 ucac3viz.txt
# 2802   -fVII/233/out&-out.all=1 2masx.txt
2802   -fI/317/out&-out.all=1 ppmxl.txt
2803   -fII/311/wise&-out.all=1 wise.txt
end
   Comments can be added freely after this point,  or before it if they're
prefaced with a '#'.

   Adding your own downloadable datasets is slightly tricky. You must
first choose an 'action number' from 2796 to 2895, a range reserved for
this purpose.  (As you can see,  though, actions 2796 to 2800 are now
in use.)  You then specify '-f' followed by the VizieR directory from
which data are to be taken.  ('f' means a FITS download.  I started out
allowing text downloads with '-c',  but realized that this can,  in
some situations,  lead to oversized downloads.  'f' is safer.)

   Finally,  the name of the file to which the data is to be appended
is given.

   After this,  you need to edit 'toolbar.dat' and add the action code
in question to the file.  See the examples for actions 2796 to 2799 to
get the feel of how this works.  Don't forget that when you add new
buttons to 'toolbar.dat',  the number at the top of the file specifying
the number of buttons in the file has to be increased.

   Also,  you need to create a TDF to display the dataset in question.
The TDF must include the keyword 'volatile',  telling Guide that the
data is apt to change unexpectedly (i.e.,  the user will do things
such as download more data or click on "clear the data" in More Info).
See 'vizier.tdf' for an example.

      ------------- Italiano: ----------

   Si possono aggiungere liberamente dei commenti dopo questo punto,
oppure facendoli precedere, su ogni riga, dal simbolo '#'.

   Per aggiungere dei propri gruppi di dati scaricabili da internet,
occorre un po' di accortezza. Occorre prima scegliere un 'numero di
comando' compreso tra 2796 e 2895, un intervallo riservato proprio
a questo scopo. (Come si puo' vedere, tuttavia, i numeri da 2796 a
2801 sono gia' in uso). Successivamente, va specificato '-f' seguito
dalla cartella di VizieR da cui si scaricheranno i dati. ('-f'
significa che si tratta di dati FITS. Avevo iniziato con lo scaricare
file di testo con l'opzione '-c', ma mi accorsi che, in certe
situazioni, si arrivava a chiedere di scaricare file troppo grandi.
L'opzione '-f'  meglio).

   Infine viene dato il nome del file su cui i dati andranno accodati.

   Dopo di ci, occorre modificare il file 'toolbar.dat' aggiungendovi
il codice del comando in questione. Vedendo gli esempi dei comandi da
2796 a 2801 si puo' capire come funziona questo procedimento. NON va
dimenticato che, quando si aggiunge un nuovo bottone al file 'toolbar.dat',
va anche aumentato di conseguenza il numero sulla prima riga del file,
che indica il numero totale dei bottoni.

   Inoltre, occorre preparare anche un file TDF (in italiano IDF) per
visualizzare il gruppo di dati in questione. Il file TDF deve includere
la parola chiave 'volatile', per dire al programma Guide che i dati
potrebbero cambiare in modo inaspettato (cioe', l'utente potrebbe
scaricare altri dati che si accoderanno, oppure fare clic sulle parole
"fare clic qui" per cancellare i dati, nella finestra "Altre informazioni").
Si puo' vedere il file 'vizier.tdf', o in italiano 'vizier.idf', come
esempio.
