-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 CHANGES-0.1.0.txt 0.0.16 UTF-8 2023-05-08 *---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|--* AN NFOTOOLS COMING ATTRACTION ============================= CHANGES MADE FOR RAYLIB APP 0.1.0 --------------------------------- This file provides tracking of changes made to VCrayApp as part of developing VCrayApp 0.1.0 (beta) as the successor of VCrayApp 0.0.0 (alpha). These changes are documented in the release information at . Further information on the development of VCrayApp 0.1.0 can be found at the GitHub project, , and nfoTools issues, . CHANGES IN 0.1.0 **************** BREAKING: The VCrayApp.bat API has changed dramatically. The name of the project exe is required on the command line before the project code will be compiled and optionally ran. Modifications of VCrayApp.bat are no longer required and are definitely not recommended. IMPORTANT: With this change, VCrayApp-0.1.0 is not a simple drop-in replacement for VCrayApp-0.0.0. The workflow within which VCrayApp is used must be adjusted for the changed VCrayApp.bat command prompt API, VCrayApp [+] ? VCrayApp [+] [*] [-c] [[-r] exe [src]] Note 1: The value supplied for exe need not reflect the name of any of the project source files; any one (and exactly one) of those files must provide the external main() definition. There may not be any spaces in the chosen .exe name. Remember to include ".exe" in the name. Note 2: The default API src value, "src\*.c" is special. The use of src\ for *.c and *.h files of the project is recommended. When explicit src parameters are supplied on the VCrayApp.bat command line, absolute filepaths must be used, whether or not with wild cards. There must not be any spaces in the full-path names. ADVANCED TECHNIQUES: Quotation of the src parameter and use of spaces in the value will be taken as multiple src locations. Advanced need for includes and libraries for the standalone application should be handled by modification of the environment variables available for that purpose under the Visual Studio Native Command Prompt. It may be valuable to use VCrayApp.bat from a command script that accomplishes that, embedding the use of VCrayApp. For examples, see . NEW FEATURES VCrayApp will detect and report the version of raylib and of VS Command Prompt being used each time the cache is built. There is checking on known recent releases of raylib that fail with the Microsoft VC/C++ compiler. Those raylib versions won't be used. VCrayApp detects and reports when in-progress -dev versions of raylib are being used, rather than recommended official releases. VCrayApp failure messages all have FAILCODE numbers and each message has links to details under . CHANGES-0.1.0.txt is included in the VCrayApp-0.1.0.zip file and is also one of the release pages for consultation without downloading the full package. Use of VCrayApp embedded in a larger project with VCrayApp.bat called from a higher "host" script has been improved. Environment variable VCrayAppHost can now be set by the host to have it be accounted for by VCrayApp. The host can also set VCrayAppHostURL for reporting as a source of additional information. CHANGES VCrayConfirm.c has been extended to report more about the VCrayApp settings and the readiness for use of the cache with particular VC and raylib versions. VCrayApp compiles and uses program cache\VCrayVerCheck.c every time the cache is about to be filled. This assists in determination of the raylib version. VCrayApp will compile and run the cache\VCrayConfirm.c program every time the cache of raylib code is created, providing additional confirmation that the cache is built and operational with the version of raylib being used. Reporting by VCrayApp is abbreviated when "+" is set for embedded-operation. This should only be done when calling from another script that takes charge by setting VCrayAppHost and commanding VCrayApp. Otherwise, there is warning. VCrayApp no longer PAUSES after a successful run, with or without execution of any code. VCrayApp no longer employs app\ for anything but compiling the project code. All compiles of the VCrayApp helper programs that are part of cache\ will be compiled into cache\ in a manner that does not interfere with use of cache\ for precompiled raylib components. In case of problems with unpredictable results related to population of the cache\, whether FAILCODE4 or FAILCODE5, VCrayApp will automatically attempt to rebuild the cache on the next usage, with or without option "-c". CORRECTION: When executed as embedded (option "+"), VCrayApp.bat no longer sets LOCAL. The caller must do so as appropriate. This exposes variables set by VCrayApp.bat to the host, including %VCRAYVER%, the version of raylib determined when the cache is built as part of the VCrayApp run. An embedded VCrayApp does not EXIT on success, it does a :FALLOUT off the end of the script. On any FAILCODE, VCrayApp does force EXIT. *---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|--* Copyright 2023 Dennis E. Hamilton Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. *---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|--* ATTRIBUTION Hamilton, Dennis E. Changes Made for VCrayApp 0.1.0. nfoTools text file version 0.0.16 dated 2023-05-08, available on the Internet as a version of *---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|--* 0.0.16 2023-05-08T01:51Z Touch-ups aligned with releases candidate 0.0.15 2023-05-04T16:38Z Touch-ups 0.0.14 2023-05-03T16:46Z Adjust for the new VCrayApp-0.1.0 API. 0.0.12 2023-04-28T19:19Z Touch-ups 0.0.12 2023-04-17T16:32Z More information on failures and cache rebuilding 0.0.11 2023-04-13T20:15Z Include error-message cleanups and links 0.0.10 2023-04-06T18:24Z Reflect CHANGES-0.1.0 name change, make touch-ups 0.0.9 2023-04-05T15:51Z Touch-ups 0.0.8 2023-03-28T20:42Z Adjustments for 0.1.0 and latest handling of hosting 0.0.7 2023-03-26T17:48Z Touch-ups 0.0.6 2023-03-26T02:09Z Reflect embedding changes confirmed by VCrayVerify. 0.0.5 2023-03-11T23:01Z Include VCrayApp no longer pausing on successful run 0.0.4 2023-03-09T17:55Z Catch up with changes already made to the code. 0.0.3 2023-03-08T20:21Z Breaking Changes about GAME_EXE and SRC, now a VCAPPEXE and VCAPPSRC. 0.0.2 2023-03-03T21:11Z Changes about VCrayAppHost and VCrayAppURL. 0.0.1 2023-03-02T19:27Z Reflect introduction of VCrayAppHost 0.0.0 2023-03-02T17:19Z Placeholder draft ***** end of CHANGES.txt ***** -----BEGIN PGP SIGNATURE----- iQFGBAEBCAAwFiEEBNBDIpebhN4QdwM0+W6J/9RWYooFAmRYVl8SHG9yY21pZEBh cGFjaGUub3JnAAoJEPluif/UVmKKRPsH/juGPNbuA5jdiw6fSw9PQVUqPtZiiD6U y6dTw0b2/sArsNnGtDcQM2YOLPknZn8PlcgO1iJjo4I0tbA/wjvMxD49ypWdfRJB zAGIjKTor8BOzz6eVl/A1SDAVojaamxmxR13SHfyHctrD1IlkO1qdYbtgOY8jjeO LEc7018TekRzwmUR5t1RM3BK+Tiy/wgq6S0D249xZOVFh2Z6TIOTpM5B/ihu1S8g PK/ByNjFMFNUQ8Mc0WOepDwjGWjnrZI0w18CPP0iETq5WYZHv6/Y5r6QN9lSwni2 Wxw2/OGHM1A4sTU+qTI/DDWdFHG2fHhjz4KR9b7MaSPlT2Cq3Fastu0= =tj7U -----END PGP SIGNATURE-----