Commit 36ff2a02 authored by Robert Sprowson's avatar Robert Sprowson
Browse files

Docs improvement

Mention how to release the sprite area when called as a library.
Use TRUE/FALSE for things that are notionally documented as booleans.

Version 1.62. Tagged as 'ChangeFSI-1_62'
parent 1294a015
...@@ -225,6 +225,9 @@ memory claimed during processing can't be released on completion (as using ...@@ -225,6 +225,9 @@ memory claimed during processing can't be released on completion (as using
the CLEAR keyword would clear the variables of the calling program too), the CLEAR keyword would clear the variables of the calling program too),
leading to a memory leak for multiple library calls. leading to a memory leak for multiple library calls.
When used with spritearea% = -1, the resulting sprite area can be released
after use with PROCremovearea.
System variables System variables
================ ================
......
/* (1.61) /* (1.62)
* *
* This file is automatically maintained by srccommit, do not edit manually. * This file is automatically maintained by srccommit, do not edit manually.
* Last processed by srccommit version: 1.1. * Last processed by srccommit version: 1.1.
* *
*/ */
#define Module_MajorVersion_CMHG 1.61 #define Module_MajorVersion_CMHG 1.62
#define Module_MinorVersion_CMHG #define Module_MinorVersion_CMHG
#define Module_Date_CMHG 24 Feb 2018 #define Module_Date_CMHG 30 Sep 2018
#define Module_MajorVersion "1.61" #define Module_MajorVersion "1.62"
#define Module_Version 161 #define Module_Version 162
#define Module_MinorVersion "" #define Module_MinorVersion ""
#define Module_Date "24 Feb 2018" #define Module_Date "30 Sep 2018"
#define Module_ApplicationDate "24-Feb-18" #define Module_ApplicationDate "30-Sep-18"
#define Module_ComponentName "ChangeFSI" #define Module_ComponentName "ChangeFSI"
#define Module_ComponentPath "mixed/RiscOS/Sources/Apps/ChangeFSI" #define Module_ComponentPath "mixed/RiscOS/Sources/Apps/ChangeFSI"
#define Module_FullVersion "1.61" #define Module_FullVersion "1.62"
#define Module_HelpVersion "1.61 (24 Feb 2018)" #define Module_HelpVersion "1.62 (30 Sep 2018)"
#define Module_LibraryVersionInfo "1:61" #define Module_LibraryVersionInfo "1:62"
...@@ -292,19 +292,16 @@ IF task% THEN ...@@ -292,19 +292,16 @@ IF task% THEN
ENDCASE ENDCASE
UNTIL FALSE UNTIL FALSE
ELSE ELSE
Q%=HIMEM Q%=HIMEM:REM Remember memory size
REM Remember memory size END=&4000000:REM Grab all the memory
END=&4000000
REM Grab all the memory
ON ERROR ON ERROR OFF:OSCLI"Set ChangeFSI$ReturnCode "+REPORT$+" (code "+ STR$ERL+")":PROCremovearea:CLEAR:END=Q%:END ON ERROR ON ERROR OFF:OSCLI"Set ChangeFSI$ReturnCode "+REPORT$+" (code "+ STR$ERL+")":PROCremovearea:CLEAR:END=Q%:END
foo%=0 foo%=0
REM Call program REM Call program
A%=FNChangeFSI(A$,-1,-1,0,-1,-1,foo%,TRUE) A%=FNChangeFSI(A$,-1,-1,0,TRUE,TRUE,foo%,TRUE)
PROCremovearea PROCremovearea
OSCLI"unset ChangeFSI$ReturnCode" OSCLI"unset ChangeFSI$ReturnCode"
CLEAR CLEAR
END=Q% END=Q%:REM Return it all again
REM Return it all again
ENDIF ENDIF
END END
: :
...@@ -510,7 +507,7 @@ DEF PROCcallFSI ...@@ -510,7 +507,7 @@ DEF PROCcallFSI
SYS "Wimp_SlotSize",originalslot%,-1 SYS "Wimp_SlotSize",originalslot%,-1
PROCremovearea PROCremovearea
IF fast% SYS "OS_UpdateMEMC",&300,&700 TO oldmemc IF fast% SYS "OS_UpdateMEMC",&300,&700 TO oldmemc
A%=FNChangeFSI(A$,-1,-1,nextlocation%,0,0,sar%,0) A%=FNChangeFSI(A$,-1,-1,nextlocation%,FALSE,FALSE,sar%,FALSE)
IF fast% SYS "OS_UpdateMEMC",oldmemc,&700 IF fast% SYS "OS_UpdateMEMC",oldmemc,&700
IF scrap% scrap%= FALSE :SYS "OS_File",6,F$ IF scrap% scrap%= FALSE :SYS "OS_File",6,F$
IF A%<2 AND sar%<>0 THEN IF A%<2 AND sar%<>0 THEN
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment