Update docs about load shell cmd

doc/fluidsynth.1

@@ -13,7 +13,7 @@
 .\" along with this program; see the file LICENSE.  If not, write to
 .\" the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 .\"
-.TH FluidSynth 1 "Jan 1, 2025"
+.TH FluidSynth 1 "Feb 2, 2025"
 .\" Please update the above date whenever this man page is modified.
 .\"
 .\" Some roff macros, for reference:
@@ -155,8 +155,10 @@ Quit the synthesizer
 .TP
 .B SOUNDFONTS
 .TP
-.B load filename
-Load a SoundFont
+.B load filename [reset] [bankofs]
+Load a SoundFont onto the SoundFont stack. If reset is 1 (which is the implicit default), all currently in-use SoundFont presets will be re-evaluated with the newly loaded SoundFont taken into account.
+Optionally, you can specify a non-zero bank offset for the new SoundFont. For example the command
+load soundfont.sf2 0 10 will load the soundfont.sf2 with a bank offset of 10 without re-evaluating the presets.
 .TP
 .B unload number
 Unload a SoundFont. The number is the index of the SoundFont on the stack.

src/bindings/fluid_cmd.c

@@ -120,7 +120,7 @@ static const fluid_cmd_t fluid_commands[] =
     },
     {
         "load", "general", fluid_handle_load,
-        "load file [reset] [bankofs] Loads SoundFont (reset=0|1, def 1; bankofs=n, def 0)"
+        "load file [reset] [bankofs] Loads SoundFont (reset=0|1, def=1; bankofs=n, n!=0)"
     },
     {
         "unload", "general", fluid_handle_unload,
@@ -985,11 +985,21 @@ fluid_handle_load(void *data, int ac, char **av, fluid_ostream_t out)
     if(ac == 2)
     {
         reset = atoi(av[1]);
+        if (reset != 0 && reset != 1)
+        {
+            fluid_ostream_printf(out, "load: invalid reset argument %d, only 1 or 0 are allowed\n", reset);
+            return FLUID_FAILED;
+        }
     }
 
     if(ac == 3)
     {
         offset = atoi(av[2]);
+        if (offset == 0)
+        {
+            fluid_ostream_printf(out, "load: only non-zero bank offsets are allowed, omit this parameter if zero was intended\n", offset);
+            return FLUID_FAILED;
+        }
     }
 
     /* Load the SoundFont without resetting the programs. The reset will
@@ -1003,7 +1013,7 @@ fluid_handle_load(void *data, int ac, char **av, fluid_ostream_t out)
     }
     else
     {
-        fluid_ostream_printf(out, "loaded SoundFont has ID %d\n", id);
+        fluid_ostream_printf(out, "loaded SoundFont has ID %d and bankofs=%d\n", id, offset);
     }
 
     if(offset)