From 9e77694945a73a66e311f0cb0679606ca84d2b7e Mon Sep 17 00:00:00 2001 From: Will Wray Date: Fri, 26 Mar 2021 08:37:53 -0400 Subject: [PATCH 1/2] Doc: bump cmake minimum required version to 3.18 --- CONTRIBUTING.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9711c9f9..3b8fd461 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,7 +1,8 @@ ### Getting Started & Building: 1. Prerequisites: - * CMake version 3.17.0+ -> Ubuntu systems seem to have a problem getting the latest version, please build from sources or use another package such as snap. - * [Ubuntu CMake update instructions](https://apt.kitware.com/) + * CMake version 3.18.0+ + * Ubuntu systems may have a problem getting the latest cmake version + * [Ubuntu CMake update instructions](https://apt.kitware.com/) * Ninja * Additional prerequisites for building the documentation: * python packages: sphinx, breathe, divio-docs-theme From 06f7263609be00eee6a88a780b242cf95296c485 Mon Sep 17 00:00:00 2001 From: Will Wray Date: Fri, 26 Mar 2021 10:17:08 -0400 Subject: [PATCH 2/2] Fix markdown lint warnings --- CONTRIBUTING.md | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3b8fd461..62b07aa7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,4 +1,5 @@ -### Getting Started & Building: +# Getting Started & Building + 1. Prerequisites: * CMake version 3.18.0+ * Ubuntu systems may have a problem getting the latest cmake version @@ -8,12 +9,15 @@ * python packages: sphinx, breathe, divio-docs-theme * doxygen 2. Checkout the repository: + ```sh # --recursive flag is needed to pull in the submodule git clone https://github.com/codereport/jsource.git --recursive ``` + 3. Build jconsole: * Run cmake: + ```sh cd jsource mkdir build @@ -21,27 +25,38 @@ # If you want documentation built, modify your cmake command to: cmake -G "Ninja Multi-Config" -B build -DDOCS:STRING=YES ``` + * To build debug: + ```sh ninja -C build ``` + * To build release: + ```sh ninja -C build -f build-Release.ninja ``` + 4. Run jconsole: * To run the debug build: + ```sh ./build/jsrc/Debug/jconsole ``` + * To run the release build: + ```sh ./build/jsrc/Release/jconsole ``` + 5. Run tests: + ```sh ninja -C build test ``` + * Filter tests: ```sh @@ -52,6 +67,7 @@ ``` Extra: Get JHS Web IDE -``` + +```sh ./build/jsrc/Debug/jconsole ./jlibrary/addons/ide/jhs/config/jhs.cfg ```