Hi Rony,

Thanks for putting this together. What was in the release I uploaded has the 
functionality promised but it looks like I only pushed the final commit to bump 
the version and update the tutorial and README to the SourceForge Git mirror 
and not to GitHub. As a result the version in the 1.32 release shows as 
1.31.2.6 and the package does not include the documentation updates. I’m really 
sorry for this oversight and I have now corrected the release on Github and on 
SourceForge. I don’t think it’s necessary to refresh what you have as it’s 
functionally identical (bar the new conditional breakpoint demo in the 
tutorial) to what is already in the release bundle but I thought I should let 
you know in case you want to do so.

—Dom


> On 1 Dec 2024, at 21:14, Rony Flatscher via groups.io 
> <rony.flatscher=wu.ac...@groups.io> wrote:
> 
> This is a refresh of the net-oo-rexx package, a single zip archive containing 
> ooRexx, NetRexx, oorexxshell, rexxdebugger and many more useful things for 
> Rexx/ooRexx/NetRexx programmes.
> 
> Location:
> 
> https://wi.wu.ac.at/rgf/rexx/tmp/net-oo-rexx-packages/
> 
> Readme files:
> 
> https://wi.wu.ac.at/rgf/rexx/tmp/net-oo-rexx-packages/readme.txt
> https://wi.wu.ac.at/rgf/rexx/tmp/net-oo-rexx-packages/readme_net-oo-rexx.txt
> After having read the readme files it should be "brain-dead-easy" to use 
> these portable zip archives. They allow to use and test ooRexx with 
> oorexxshell or rexxdebugger exploiting the ooRexx-Java bridge or use and test 
> NetRexx (and even combining ooRexx with NetRexx and vice versa)!
> 
> ---rony
> 
> 
> 
> On 25.07.2024 13:21, Rony Flatscher wrote:
>> This is the follow-up to the "oorexx-packages" bundle that got introduced to 
>> the community about a month ago.
>> 
>> This time the latest ooRexx, oorexxshell, oorexx-debugger, and - as a bit of 
>> surprise and favor to the community - NetRexx is on board!
>> 
>> Needed steps: you download it, de-quarantine (see note # 1 below) the zip 
>> archive, unzip, and run "setup," and off you go!
>> 
>> It cannot get easier for interested programmers, so there is no excuse for 
>> anyone not to check it out as soon as possible!
>> 
>> Currently, the following 64-bit net-oo-rexx bundles are readily available 
>> for the most important operating systems (in alphabetic order):
>> 
>> net-oo-rexx.macos.arm64-portable-release-20240724.zip
>> net-oo-rexx.macos.x86_64-portable-release-20240724.zip
>> net-oo-rexx.ubuntu2004.x86_64-portable-release-20240724.zip
>> net-oo-rexx.windows.x86_64-portable-release-20240724.zip
>> Here the temporary download link: 
>> <https://wi.wu.ac.at/rgf/rexx/tmp/net-oo-rexx-packages/> 
>> <https://wi.wu.ac.at/rgf/rexx/tmp/net-oo-rexx-packages/>
>> Here the content of the readme_net--oo-rexx.txt file:
>> 
>> "net-oo-rexx packages"
>> ======================
>> 
>> This is the readme file for "net-oo-rexx", a bundling ready to use that
>> gives immediate access to a number of Rexx packages, like:
>> 
>> - bsf4oorexx (ooRexx-Java bridge for all operating systems)
>> - dbus4oorexx (ooRexx-DBus bridge for Linux)
>> - executor packages (see oorexxshell)
>> - log4rexx (logging for ooRexx)
>> - netrexx (Java in the clothes of Rexx)
>> - nrws (NetRexx Workspace, a NetRexx shell)
>> - oorexx (open object Rexx)
>> - oorexxshell (a rexxtry.rex kind of shell for ooRexx)
>> - regex (powerful regular expression implementation in ooRexx)
>> - rexxdebugger (an ooRexx debugger, exploits the Java bindings on Unix)
>> 
>> ========================
>> Directions in a nutshell
>> ========================
>> 
>> - download the latest "NetRexx, ooRexx with packages with oorexxshell"
>>   (net-oo-rexx-packages) zip archive from
>>   https://wi.wu.ac.at/rgf/rexx/tmp/net-oo-rexx-packages/
>> 
>> - de-quarantine the zip archive (see NOTE # 1 below)
>> 
>> - unzip the archive
>> 
>> - change into the unzipped directory and enter in the system shell
>> 
>>   Windows                  Unix                    Comment
>>   -------                  ----                    +------
>>   setup.cmd                ./setup.sh              | creates two scripts
>> 
>>   This will create the two scripts:
>> 
>>   run.cmd                  run                     | allows to run 
>> net-oo-rexx programs
>>   setenv.cmd               setenv                  | allows to set 
>> environment to net-oo-rexx in Terminal
>> 
>>   
>> ----------------------------------------------------------------------------------------
>> 
>>   ---> use the generated 'run.cmd/run' script
>> 
>>   Windows                  Unix                      Comment
>>   -------                  ----                      +------
>>   run oorexxshell          ./run oorexxshell         | runs oorexxshell (a 
>> script)
>> 
>>   run rexx testoorexx.rex  ./run rexx testoorexx.rex | use ooRexx to run 
>> testoorexx.rex
>>   run rexx which_rexx.rex                            | use ooRexx to run 
>> which_rexx.rex
>> 
>>   run nrc -exec which_rexx.rex                       | use NetRexx to run 
>> which_rexx.rex
>> 
>> 
>>   
>> ----------------------------------------------------------------------------------------
>>   ---> use the generated 'setenv.cmd/setenv' script
>> 
>>   Windows                  Unix                    Comment
>>   -------                  ----                    +------
>>    setenv.cmd              source ./setenv         | sets the environment in 
>> the Terminal to net-oo-rexx
>> 
>>    the following commands will work on Windows as well as on Unix:
>> 
>>    oorexxshell                                     | runs oorexxshell
>> 
>>    rexx testoorexx.rex                             | use ooRexx to run 
>> testoorexx.rex
>>    rexx which_rexx.rex                             | use ooRexx to run 
>> which_rexx.rex
>> 
>>    rexxdebugger packages/rexxdebugger/tutorial.rex | use ooRexx to run the 
>> rexxdebugger with its tutorial.rex
>> 
>>    nrc -exec which_rexx.rex                        | use NetRexx to run 
>> which_rexx.rex
>> 
>>    nrc which_rexx.rex                              | use NetRexx to compile 
>> which_rexx.rex to which_rexx.class
>>    java which_rexx                                 | use Java to run 
>> which_rexx.class (note: no ".class" extension!)
>> 
>> 
>> 
>> ======================
>> Additional information
>> ======================
>> 
>> To learn about the functionality of oorexxshell, take a few minutes and see 
>> the
>> asciinema demos at [4].
>> 
>> First feedback
>> --------------
>> 
>>  - "install this bundle, you run a small, trivial setup program, and, poof,
>>    you have immediate access to a real trove of packages -- no additional
>>    installation needed"
>>    (JMB)
>> 
>>  - "I even was able to load the JDOR handler, then "address JDOR", and then
>>    construct one of the JDOR samples step-by-step, by manually writing the
>>    (quoted) JDOR commands.  This is very impressive, and very useful too,
>>    from a pedagogical point of view, since it provides immediate incremental
>>    visual feedback for the JDOR commands.  You just have to move the Java
>>    window besides the command window and you have a fantastic experience."
>>    (JMB)
>> 
>> -------------------------------------------------------------------------------
>> 
>> =====
>> NOTES
>> =====
>> 
>> ---------------------------------------
>> NOTE # 1: Microsoft and Apple do not allow programs from the Internet to run
>>           if they are not signed using their fee-based service citing 
>> "security
>>           reasons".
>> 
>>       Therefore, before installing or unzipping open source projects you need
>>       to "de-quarantine" (remove the respective attributes) the zip archives
>>       before unzipping.
>> 
>>       Windows: after downloading, open with a right-mouse click the property
>>                menu, mark the "unblock" check mark and click "apply".
>>                Thereafter you can install or unzip the file. Or open a
>>                command line window and run (change 'filename' to the name of
>>                the downloaded file):
>> 
>>                 powershell Unblock-File filename
>> 
>>              e.g.,
>> 
>>                 powershell Unblock-File 
>> net-oo-rexx.windows.x86_64-portable-release-20240707.zip
>> 
>>       macOS: after downloading, open a Terminal window and run "xattr 
>> filename"
>>              to see the extended attributes of the downloaded file (replace
>>              'filename' with the name of the zip archive), then issue  
>> (again,
>>              change 'filename' to the name of the downloaded file):
>> 
>>                 xattr -d com.apple.quarantine filename
>> 
>>              e.g.,
>> 
>>                 xattr -d com.apple.quarantine 
>> net-oo-rexx.macos.x86_64-portable-release-20240707.zip
>> 
>> ---------------------------------------
>> NOTE # 2 for Unix versions.
>> 
>>       In case the execution bit of shell scripts and executables got removed,
>>       run the supplied script makeAllExecutable.sh from the unzipped
>>       directory:
>> 
>>             sh ./makeAllExecutable.sh
>> 
>> ---------------------------------------
>> NOTE # 3: Dual Installations (Linux & Windows)
>> 
>>           You can use the same set of installed files to run the net-oo-rexx
>>           bundle under both Windows and Linux, including the Windows 
>> Subsystem
>>           for Linux (WSL2) and other mechanisms like VirtualBox shared 
>> folders.
>> 
>>           Once you have run the necessary initializer scripts (setup.cmd 
>> under
>>           Windows, and ./setup under Linux/WSL), you will be able to use the
>>           other scripts (run/setenv) under both operating systems.  For 
>> example,
>>           you can test a program under Windows, then use the "wsl" command to
>>           switch to Ubuntu, and test the same program under Ubuntu, while 
>> sharing
>>           the same net-oo-rexx installation.
>> 
>>           About WSL, cf. 
>> <https://learn.microsoft.com/en-us/windows/wsl/about> 
>> <https://learn.microsoft.com/en-us/windows/wsl/about>
>> 
>> ---------------------------------------
>> NOTE # 4: rerun the "setup.cmd" (Windows)/"setup" (Unix) script each time the
>>           portable files get relocated or, if on a USB stick, each time you
>>           plug in the USB stick. This will recreate on Windows the "run.cmd"
>>           and "setenv.cmd"  scripts, on Unix the "run" and "setenv" scripts,
>>           thereby adjusting them to their new location.
>> 
>> ---------------------------------------
>> NOTE # 5: bsf4oorexx (ooRexx-Java bridge)
>> 
>>           In order to load and run bsf4oorexx programs you need to have
>>           Java/OpenJDK on your computer and either have PATH point to the
>>           directory where the binary file java.exe (Windows)/java (Unix) can 
>> be
>>           found or set the environment variable JAVA_HOME to point to the 
>> Java
>>           home directory in which the Java subdirectories 'bin', 'lib' and 
>> the
>>           like are located.
>> 
>>           You can download Java/OpenJDK from the Internet (usually for free),
>>           e.g., from Amazon, azul, bellsoft, IBM, Microsoft, ORACLE, SAP, and
>>           many more sites (all distributions use the same Java/OpenJDK source
>>           code).
>> 
>>           Please make sure to pay attention to the following two important
>>           points:
>> 
>>           - download the "full version" respectively the version that 
>> includes
>>             "JavaFX", otherwise the interesting bsf4oorexx JavaFX samples 
>> cannot
>>             run
>> 
>>           - download the Java/OpenJDK version matching your operating system
>>             and the machine type of your computer, e.g., a 64-bit Intel 
>> (machine
>>             type "x86_64") Windows version download the "x86_64" (Intel, AMD)
>>             Windows Java/OpenJDK installation package or zip archive. If you
>>             use macOS or Linux then download the respective full Java/OpenJDK
>>             versions.
>> 
>>           It is possible to have different versions of Java/OpenJDK present 
>> on
>>           your computer at the same time. The environment variable JAVA_HOME
>>           can then be used to point to the Java/OpenJDK directory that you 
>> wish
>>           to use in your current session/terminal/command line window. This 
>> way
>>           you can develop and test bsf4oorexx programs for different versions
>>           of Java/OpenJDK on the same computer.
>> 
>>           To see what becomes possible with bsf4oorexx, check out the samples
>>           in packages/bsf4oorexx/samples which all get briefly described in 
>> the
>>           index.html file located there as well.
>> 
>>           bsf4oorexx programs can be executed directly with rexx[.exe] or via
>>           Java using the shell scripts "rexxjh.cmd" (Windows)/"rexxjh.sh" 
>> (Unix),
>>           e.g.,
>> 
>>              cd packages/bsf4oorexx/samples
>> 
>>              rexxjh.cmd 1-040_list_charsets.rxj    -- Windows: Java loads 
>> ooRexx to run script
>>              rexxjh.sh  1-040_list_charsets.rxj    -- Unix: Java loads 
>> ooRexx to run script;
>> 
>>              rexx       1-040_list_charsets.rxj    -- Rexx loads Java to run 
>> script
>> 
>>            Apple users please note: if running any bsf4oorexx script that 
>> creates a GUI, then
>>            you must use the scripts rexxjh.sh to run them.
>> 
>> ---
>> 
>> 
>> If you have any questions or comments please communicate via the RexxLA 
>> member's
>> mailing list (cf. https://www.RexxLA.org <https://www.rexxla.org/>).
>> 
>> Alternatively, communicate via the ooRexx developer list (cf. [2], [3]).
>> 
>> [1] Portable ooRexx 5.1.0: 
>> <https://sourceforge.net/projects/oorexx/files/oorexx/5.1.0beta/portable/> 
>> <https://sourceforge.net/projects/oorexx/files/oorexx/5.1.0beta/portable/>
>> 
>> [2] ooRexx mailing list subscription page: 
>> <https://sourceforge.net/p/oorexx/mailman/> 
>> <https://sourceforge.net/p/oorexx/mailman/>
>> 
>> [3] ooRexx web mail interface to the developer mailing list:
>>     <https://sourceforge.net/p/oorexx/mailman/oorexx-devel/> 
>> <https://sourceforge.net/p/oorexx/mailman/oorexx-devel/>
>> 
>> [4] Jean Louis Faucher's asciinema demos, at the top the demos for 
>> ooRexxShell:
>>     <https://jlfaucher.github.io/executor.master/demos/index.html> 
>> <https://jlfaucher.github.io/executor.master/demos/index.html>.
>>     Please note that these demos may use experimental extensions of Jean 
>> Louis
>>     executor (a special version based on ooRexx 4.2) which are not present
>>     in the regular versions of ooRexx.
>> 
>> --------------
>> as of 20240725
>> Please give us feedback on what you think about this project; it has taken 
>> some time and effort to improve, extend, and test, hoping that it benefits 
>> each Rexx developer!
>> 
>> Cheers
>> 
>> ---rony
>> 
> 
> _._,_._,_
> Groups.io Links:
> You receive all messages sent to this group.
> 
> View/Reply Online (#2298) <https://groups.io/g/rexxla-members/message/2298> | 
> Reply to Group 
> <mailto:rexxla-memb...@groups.io?subject=Re:%20net-oo-rexx%20refresh%202024-12-01%20%28Re%3A%20%5Brexxla-members%5D%20A%20real%20Rexx%20user%27s%20treasure%20grove%3A%20introducing%20%22net-oo-rexx%22%2C%20ready%20for%20download%20and%20use%20within%20one%20minute%21>
>  | Reply to Sender 
> <mailto:rony.flatsc...@wu.ac.at?subject=Private:%20Re:%20net-oo-rexx%20refresh%202024-12-01%20%28Re%3A%20%5Brexxla-members%5D%20A%20real%20Rexx%20user%27s%20treasure%20grove%3A%20introducing%20%22net-oo-rexx%22%2C%20ready%20for%20download%20and%20use%20within%20one%20minute%21>
>  | Mute This Topic <https://groups.io/mt/109869211/8160722> | New Topic 
> <https://groups.io/g/rexxla-members/post>
> 
> ----------
> RexxLA relies on donations to cover costs. Please consider donating at: 
> https://donorbox.org/donations-to-rexx-language-association
> Your Subscription <https://groups.io/g/rexxla-members/editsub/8160722> | 
> Contact Group Owner <mailto:rexxla-members+ow...@groups.io> | Unsubscribe 
> <https://groups.io/g/rexxla-members/leave/12970826/8160722/1145871411/xyzzy> 
> [dominicjw...@gmail.com]
> _._,_._,_

_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel

Reply via email to