Merge pull request #41 from RISC-OS-Community/develop

Cumulative set of merges from Develop to Main branch

Author: pzaino

.rocog/scripts/ros2win

@@ -0,0 +1,52 @@
+#!/bin/bash
+
+###################
+#        name: ros2win
+# description: Simple script to generate a MS Windows firendly source
+#              file from a RISC OS source file.
+#      author: Paolo Fabio Zaino
+#     license: Copyright by Paolo Fabio Zaino, all rights reserved
+#              distributed under CDDL v1.1
+# 
+# Long description:
+# This script can be used to generate a MS Windows friendly source file
+# from a RISC OS source file, where the \n is enriched with \r.
+# This is useful when you want to use a Windows editor to edit
+# RISC OS source files.
+####################
+
+path1="$1"
+path2="$2"
+
+# Display command usage:
+function usage()
+{
+    echo "Usage: ros2win [path1] [path2]"
+    echo "path1: path to the file to convert"
+    echo "path2: path to the converted file"
+    echo "Example: ros2win ./src/!Mk/Makefile ./src/!Mk/Makefile"
+    echo ""
+    echo "If path2 is not specified then the converted file will be"
+    echo "saved in the same directory as path1 with the same name"
+}
+
+if [ "${path1}" == "" ]
+then
+    usage
+    exit 1
+fi
+
+if [ ! -f "${path1}" ]
+then
+    echo "Error: ${path1} is not a file"
+    exit 1
+fi
+
+if [ "${path2}" == "" ]
+then
+    path2="${path1}"
+fi
+
+awk 'sub("$", "\r")' ${path1} > ${path2}
+
+exit $?

.rocog/scripts/win2ros

@@ -0,0 +1,52 @@
+#!/bin/bash
+
+###################
+#        name: win2ros
+# description: Simple script to generate a RISC OS firendly source
+#              file from a Windows source file.
+#      author: Paolo Fabio Zaino
+#     license: Copyright by Paolo Fabio Zaino, all rights reserved
+#              distributed under CDDL v1.1
+# 
+# Long description:
+# This script can be used to generate a RISC OS friendly source file
+# from a Windows source file, where the \n\r is replaced with \n.
+# This is useful when you want to use a Windows editor to edit
+# RISC OS source files.
+####################
+
+path1="$1"
+path2="$2"
+
+# Display command usage:
+function usage()
+{
+    echo "Usage: win2ros [path1] [path2]"
+    echo "path1: path to the file to convert"
+    echo "path2: path to the converted file"
+    echo "Example: win2ros ./src/!Mk/Makefile ./src/!Mk/Makefile"
+    echo ""
+    echo "If path2 is not specified then the converted file will be"
+    echo "saved in the same directory as path1 with the same name"
+}
+
+if [ "${path1}" == "" ]
+then
+    usage
+    exit 1
+fi
+
+if [ ! -f "${path1}" ]
+then
+    echo "Error: ${path1} is not a file"
+    exit 1
+fi
+
+if [ "${path2}" == "" ]
+then
+    path2="${path1}"
+fi
+
+awk '{ sub("\r$", ""); print }' ${path1} > ${path2}
+
+exit $?

README.md

@@ -19,6 +19,8 @@ This repository is organised in multiple "levels":
 
 Everyone is welcome to help us to improve this repository and the resources list (as well as proposing more ideas for the meetings!). Also, we are always seeking for people willing to provide courses, presentations and/or sharing your experience coding on RISC OS.
 
+More info and details [here](docs/RISCOSCodingHowToMakeVideos.md) for who wish to help us with the videos.
+
 ### How to contribute
 
 Follow the general instructions [here](CONTRIBUTING.md) and update the documents in `doc` directory as you feel appropriate. When done open a `Pull Request` to the `develop` branch and ask for a review from `RISC-OS-Community/code-reviews-team` so we can review your changes and approve them, thanks!