Fixed documentation.

Author: spotlessmind1975

ugbc/src/targets/common/begin_storage.c

@@ -45,11 +45,11 @@
  * @param _name Name of the storage
  */
 /* <usermanual>
-@keyword BEGIN STORAGE
+@keyword BEGIN STORAGE...END STORAGE
 
 @english
 
-The ''BEGIN STORAGE'' allows to begin describing 
+The ''BEGIN STORAGE..END STORAGE'' allows to begin describing 
 the content of a storage media. The syntax of this command
 allows to define up to two parameter. The first parameter,
 ''name'', refers to the internal name of the storage.
@@ -58,6 +58,20 @@ that will contain the "image" of the storage. If omitted,
 the program filename will be used, and an additional incremented
 number will be appended, one for each storage media.
 
+Note that, for some targets, a special toolchain is needed to
+manage this keyword. In particular, for ''cpc'' target you need to 
+install and use the correct version of the ''z88dk-appmake'' application. 
+Starting from version 1.15.3 of ugBASIC, that is, since 
+''BEGIN STORAGE'' was implemented for ''cpc'', it is necessary to use a 
+patched version of the z88dk toolchain. The version that can be
+obtained from the official release is not powerful enough to include 
+external files in the disk image that is created for that target.
+
+You can find out the empowered version looking for a fork of that project, 
+or as a module inside ugBASIC. You should recompile it on a specific branch 
+(''ugbasic'' branch, precisely). On ugBASIC website and on the UGBASIC-IDE
+there is a precompiled version from that version, that can be directly
+used.
 
 @italian
 Il comando ''BEGIN STORAGE'' consente di iniziare a descrivere 
@@ -71,20 +85,55 @@ nome del file del programma e verrà aggiunto un numero
 incrementato aggiuntivo, uno per ciascun supporto di 
 memorizzazione.
 
-@syntax BEGIN STORAGE [name] [AS filename]
-@syntax STORAGE [name] [AS filename]
+Nota che per alcuni target è necessaria una toolchain speciale per
+gestire questa parola chiave. In particolare, per il target ''cpc'' devi
+installare e usare la versione corretta dell'applicazione ''z88dk-appmake''.
+A partire dalla versione 1.15.3 di ugBASIC, ovvero, poiché
+''BEGIN STORAGE'' è stato implementato per ''cpc'', si deve usare una
+versione patchata della toolchain z88dk. La versione che può essere
+ottenuta dalla release ufficiale non è abbastanza potente da includere
+file esterni nell'immagine disco creata per quel target.
+
+E' possibile trovare la versione migliorata cercando un fork di quel progetto,
+o come modulo all'interno di ugBASIC. Dovresti ricompilarla su un ramo specifico
+(ramo ''ugbasic'', per essere precisi). Sul sito web di ugBASIC e in UGBASIC-IDE
+c'è una versione precompilata di quella versione, che può essere
+utilizzata direttamente.
+
+@syntax BEGIN STORAGE name [AS filename] ... END STORAGE
+@syntax STORAGE name [AS filename] ... END STORAGE
 
 @example BEGIN STORAGE "dischetto"
 @example ...
 @example ENDSTORAGE
 
 @usedInExample storage_example_01.bas
 
-@alias STORAGE
-@seeAlso ENDSTORAGE
+@alias STORAGE...END STORAGE
 
 @target atari c128 c64 c64reu coco coco3 cpc msx1 vic20 
 </usermanual> */
+/* <usermanual>
+@keyword STORAGE...END STORAGE
+
+@english
+
+@italian
+
+@syntax STORAGE name [AS filename] .. END STORAGE
+@syntax STORAGE name [AS filename] .. END STORAGE
+
+@example BEGIN STORAGE "dischetto"
+@example ...
+@example ENDSTORAGE
+
+@usedInExample storage_example_01.bas
+
+@alias BEGIN STORAGE...END STORAGE
+
+@target atari c128 c64 c64reu coco coco3 cpc msx1 vic20 
+</usermanual> */
+
 void begin_storage( Environment * _environment, char * _name, char * _file_name ) {
 
     if ( _environment->currentStorage ) {

ugbc/src/targets/common/end_storage.c

@@ -44,16 +44,6 @@
  * @param _environment Current calling environment
  * @param _value Value to the return
  */
-/* <usermanual>
-@keyword STORAGE...ENDSTORAGE
-
-@english
-To conclude the definition of a mass memory, the ENDSTORAGE command can be used.
-
-@italian
-Per concludere la definizione di una memoria di massa si può utilizzare il comando ENDSTORAGE.
-
-</usermanual> */
 void end_storage( Environment * _environment ) {
 
     if ( ! _environment->currentStorage ) {