From 299a8a57228a04f3bcbeab8d812387c8c0f57870 Mon Sep 17 00:00:00 2001 From: "RNDr. Simon Toth" Date: Sat, 4 Feb 2023 09:43:18 +0100 Subject: [PATCH 1/4] Update README.md --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a98c87f..21cebfc 100644 --- a/README.md +++ b/README.md @@ -2,12 +2,13 @@ This repository contains the LaTeX source and C++ code samples for the book "A Complete Guide to Standard C++ Algorithms". -[Latest PDF release (v1.0.0)](https://github.com/HappyCerberus/book-cpp-algorithms/releases/download/v1.0.0/book_with_cover_v1.0.0.pdf) +[Latest PDF release (v1.0.1)](https://github.com/HappyCerberus/book-cpp-algorithms/releases/download/v1.0.1/a_complete_guide_to_standard_cpp_algorithms_v1_0_1.pdf) -[![Book Cover](static/book_cover.png)](https://github.com/HappyCerberus/book-cpp-algorithms/releases/download/v1.0.0/book_with_cover_v1.0.0.pdf) +[![Book Cover](static/book_cover.png)](https://github.com/HappyCerberus/book-cpp-algorithms/releases/download/v1.0.1/a_complete_guide_to_standard_cpp_algorithms_v1_0_1.pdf) ## Changelog +- `1.0.1` Small (mostly) formatting fixes. - `1.0.0` Content complete release with Compiler Explorer links. - `0.3.0` New chapter with ADL information and formatting cleanup. - `0.2.1` Fixed page numbering issue, small text changes. From fedf78f01606b3c0a4c88e9590b12d6f7c91a922 Mon Sep 17 00:00:00 2001 From: wxinix Date: Wed, 5 Apr 2023 08:48:14 -0400 Subject: [PATCH 2/4] Update READEME with additional info about alternative approach of building from sources using TexStudio. --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 21cebfc..c432bc0 100644 --- a/README.md +++ b/README.md @@ -31,3 +31,16 @@ The resulting PDF will be in the build folder. Most code files have wrapping main files that exercise both the build and also contain `assert` expressions that verify correctness of the code. The `verify.sh` shell script will build all (except for a few that don't compile with GCC 11) examples, and then run each of them to validate all asserts. + +## Alternative approach of building from sources + +If you're building from sources inside a virtual machine and the VSCode and Docker approach doesn't work for you, [TexStudio](https://www.texstudio.org/) provides an alternative solution for Windows users. Follow the steps below: + +- Install [Anaconda](https://www.anaconda.com/) and add `C:\Users\YourUserName\anaconda3\Scripts` to system path. Replace `YourUserName` with your actual user name. +- Install [TexStudio](https://www.texstudio.org/). +- Go to Texstudio menu "Options -> Configure Texstudio -> Commands -> XeLaTex", and enter the following command: `xelatex.exe -synctex=1 -interaction=nonstopmode -shell-escape -aux-directory=build -output-directory=build %.tex`. This command sets both the aux and output directories to ".\build". +- Go to Texstudio menu "Options -> Configure Texstudio -> Build -> Meta Commands -> Default Compiler", and enter `txs:///xelatex`. This switches the default compiler from `pdflatex` to `xelatex`. Then, enable the checkbox "Show Advanced Options". +- For Texstudio menu "Options -> Configure Texstudio -> Build -> Build Options -> PDF File", enter `build`. This tells the pdf previewer to look for the generated pdf file in the ".\build" directory. +- Finally, go to "Texstudio menu Options -> Configure Texstudio -> Commands -> Makeindex", and enter the following command: `makeindex.exe build%.idx` + +These steps will enable you to build from sources inside a virtual machine using TexStudio on Windows. From 68fe51a2c2770f5c767594c85c3b2de322f0bd6e Mon Sep 17 00:00:00 2001 From: wxinix Date: Wed, 5 Apr 2023 10:51:23 -0400 Subject: [PATCH 3/4] Update README to better clarify the alternative solution for building from sources using Texstudio inside a virtual machine on Windows. --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index c432bc0..e308e47 100644 --- a/README.md +++ b/README.md @@ -34,13 +34,15 @@ The `verify.sh` shell script will build all (except for a few that don't compile ## Alternative approach of building from sources -If you're building from sources inside a virtual machine and the VSCode and Docker approach doesn't work for you, [TexStudio](https://www.texstudio.org/) provides an alternative solution for Windows users. Follow the steps below: +This section was provided by [@wxinix](https://github.com/wxinix). Please direct any questions to him. + +[Texstudio](https://www.texstudio.org/) offers an alternative solution for Windows users who are building from sources within a virtual machine and are unable to use the VSCode and Docker approach. Follow the steps below: - Install [Anaconda](https://www.anaconda.com/) and add `C:\Users\YourUserName\anaconda3\Scripts` to system path. Replace `YourUserName` with your actual user name. -- Install [TexStudio](https://www.texstudio.org/). +- Install [Texstudio](https://www.texstudio.org/). - Go to Texstudio menu "Options -> Configure Texstudio -> Commands -> XeLaTex", and enter the following command: `xelatex.exe -synctex=1 -interaction=nonstopmode -shell-escape -aux-directory=build -output-directory=build %.tex`. This command sets both the aux and output directories to ".\build". - Go to Texstudio menu "Options -> Configure Texstudio -> Build -> Meta Commands -> Default Compiler", and enter `txs:///xelatex`. This switches the default compiler from `pdflatex` to `xelatex`. Then, enable the checkbox "Show Advanced Options". - For Texstudio menu "Options -> Configure Texstudio -> Build -> Build Options -> PDF File", enter `build`. This tells the pdf previewer to look for the generated pdf file in the ".\build" directory. - Finally, go to "Texstudio menu Options -> Configure Texstudio -> Commands -> Makeindex", and enter the following command: `makeindex.exe build%.idx` -These steps will enable you to build from sources inside a virtual machine using TexStudio on Windows. +These steps will enable you to build from sources inside a virtual machine using TexStudio on Windows. Ask @wxinix if you have any questions. From f81c7c49f4314a88924472b9569e4a981d60f44d Mon Sep 17 00:00:00 2001 From: wxinix Date: Wed, 5 Apr 2023 18:32:02 -0400 Subject: [PATCH 4/4] Update README with typo fixes to better explain the alternative solution for building from sources using TeXstudio in a virtual machine environment. --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index e308e47..e9d3208 100644 --- a/README.md +++ b/README.md @@ -36,13 +36,13 @@ The `verify.sh` shell script will build all (except for a few that don't compile This section was provided by [@wxinix](https://github.com/wxinix). Please direct any questions to him. -[Texstudio](https://www.texstudio.org/) offers an alternative solution for Windows users who are building from sources within a virtual machine and are unable to use the VSCode and Docker approach. Follow the steps below: +[TeXstudio](https://www.texstudio.org/) offers an alternative solution for those who are building from sources in a virtual machine environment and are unable to use the VSCode and Docker approach. Follow the steps below (assuming the Guest OS of the virtual machine is Windows): - Install [Anaconda](https://www.anaconda.com/) and add `C:\Users\YourUserName\anaconda3\Scripts` to system path. Replace `YourUserName` with your actual user name. -- Install [Texstudio](https://www.texstudio.org/). -- Go to Texstudio menu "Options -> Configure Texstudio -> Commands -> XeLaTex", and enter the following command: `xelatex.exe -synctex=1 -interaction=nonstopmode -shell-escape -aux-directory=build -output-directory=build %.tex`. This command sets both the aux and output directories to ".\build". -- Go to Texstudio menu "Options -> Configure Texstudio -> Build -> Meta Commands -> Default Compiler", and enter `txs:///xelatex`. This switches the default compiler from `pdflatex` to `xelatex`. Then, enable the checkbox "Show Advanced Options". -- For Texstudio menu "Options -> Configure Texstudio -> Build -> Build Options -> PDF File", enter `build`. This tells the pdf previewer to look for the generated pdf file in the ".\build" directory. -- Finally, go to "Texstudio menu Options -> Configure Texstudio -> Commands -> Makeindex", and enter the following command: `makeindex.exe build%.idx` +- Install [TeXstudio](https://www.texstudio.org/). +- Go to TeXstudio menu "Options -> Configure TeXstudio -> Commands -> XeLaTex", and enter the following command: `xelatex.exe -synctex=1 -interaction=nonstopmode -shell-escape -aux-directory=build -output-directory=build %.tex`. This command sets both the aux and output directories to ".\build". +- Go to TeXstudio menu "Options -> Configure TeXstudio -> Build -> Meta Commands -> Default Compiler", and enter `txs:///xelatex`. This switches the default compiler from `pdflatex` to `xelatex`. Then, enable the checkbox "Show Advanced Options". +- For TeXstudio menu "Options -> Configure TeXstudio -> Build -> Build Options -> PDF File", enter `build`. This tells the pdf previewer to look for the generated pdf file in the ".\build" directory. +- Finally, go to "TeXstudio menu Options -> Configure TeXstudio -> Commands -> Makeindex", and enter the following command: `makeindex.exe build%.idx` -These steps will enable you to build from sources inside a virtual machine using TexStudio on Windows. Ask @wxinix if you have any questions. +These steps will enable you to build from sources inside a virtual machine using TeXstudio. Keep in mind that the VSCode and Docker approach might not work in a virtual machine environment, because it requires extra set-up for [nested virtulization](https://stackoverflow.com/questions/39720254/can-i-run-docker-in-a-virtual-machine). Ask @wxinix if you have any questions.