2c3f0e9dfae3fa6a785a53f016a1284d34288583 — octaspire 20 days ago v0.485.0
Update documentation

* Update build instructions for Microsoft Windows
  using MSVC. The previous .bat file is replaced
  with a python script that will download, extract
  and set up all the headers and libraries needed for building
  Dern plugins in Windows (for example SDL2, SDL2_image,
  SDL2_ttf, SDL2_mixer, PDCurses).

  Sadly, this adds Python 2.7.x as a tool dependency for Windows,
  but it makes building Dern in Windows _much_ easier. In most
  other systems the required libraries can be installed
  simply and quickly by giving a short command, but in
  Windows the number of steps required is quite overwhelming.

  So instead of printing user lines and lines of instructions
  on how to download required headers and libraries, extract them,
  copy some files, generate .lib files, and so on, we just do it
  using python; the script does everything and the user doesn't
  have to do anything.
M dev/doc/book/dern-manual.htm => dev/doc/book/dern-manual.htm +19 -3
@@ 525,11 525,12 @@ in the <b>Command Prompt</b> window (NOT in the Git Bash window).
    </p>
  
-   <h3>Windows using MSVC and Git</h3>
+   <h3>Windows using MSVC, Python 2.7 and Git</h3>
  
    <p>
-     Download and install <b>Visual Studio 2017 (Community edition)</b> and
-     <b>Git</b>.
+     Download and install <b>Visual Studio 2017 (Community edition)</b>,
+     <b>Git</b> and <b>Python 2.7.x</b>. The installation script
+     is tested with python version 2.7.15.
    </p>
  
    <p>


@@ 549,6 550,21 @@     .INCLUDE: dev/doc/book/examples/sh/windows-msvc.bat
  
+   <p>
+     Please note, that you might have to change the path
+     for the python executable in the instructions above;
+     depending where you installed it.
+     Or, if the python executable can be found from <i>PATH</i>,
+     you can leave the path out.
+   </p>
+ 
+   <p>
+     The python script will download, extract and set up all the
+     libraries that are needed for Dern plugins. Then it will
+     build all the Dern programs, plugins and examples and will give
+     you a summary how to run or test them.
+   </p>
+ 
    <h3>ReactOS</h3>
  
    <p>

M dev/doc/book/examples/sh/windows-msvc.bat => dev/doc/book/examples/sh/windows-msvc.bat +1 -1
@@ 1,4 1,4 @@ cd c:\
  git clone https://github.com/octaspire/dern.git
  cd dern\release
- how-to-build\windows-msvc.bat
+ C:\Python27\python.exe how-to-build\windows-msvc.py

M dev/include/octaspire/dern/octaspire_dern_config.h => dev/include/octaspire/dern/octaspire_dern_config.h +1 -1
@@ 18,7 18,7 @@ #define OCTASPIRE_DERN_CONFIG_H
  
  #define OCTASPIRE_DERN_CONFIG_VERSION_MAJOR "0"
- #define OCTASPIRE_DERN_CONFIG_VERSION_MINOR "484"
+ #define OCTASPIRE_DERN_CONFIG_VERSION_MINOR "485"
  #define OCTASPIRE_DERN_CONFIG_VERSION_PATCH "0"
  
  #define OCTASPIRE_DERN_CONFIG_VERSION_STR "Octaspire Dern version " \

M release/documentation/dern-manual.html => release/documentation/dern-manual.html +20 -4
@@ 587,11 587,12 @@ in the <b>Command Prompt</b> window (NOT in the Git Bash window).
    </p>
  
-     <h3>2.5 Windows using MSVC and Git</h3>
+     <h3>2.5 Windows using MSVC, Python 2.7 and Git</h3>
  
    <p>
-     Download and install <b>Visual Studio 2017 (Community edition)</b> and
-     <b>Git</b>.
+     Download and install <b>Visual Studio 2017 (Community edition)</b>,
+     <b>Git</b> and <b>Python 2.7.x</b>. The installation script
+     is tested with python version 2.7.15.
    </p>
  
    <p>


@@ 616,9 617,24 @@ <pre><span class="function">cd</span><span class="normal"> </span><span class="path">c:\</span>
  <span class="normal">git clone http</span><span class="path">s:</span><span class="symbol">//</span><span class="normal">github</span><span class="symbol">.</span><span class="normal">com</span><span class="symbol">/</span><span class="normal">octaspire</span><span class="symbol">/</span><span class="normal">dern</span><span class="symbol">.</span><span class="normal">git</span>
  <span class="function">cd</span><span class="normal"> dern</span><span class="symbol">\</span><span class="normal">release</span>
- <span class="normal">how</span><span class="symbol">-</span><span class="normal">to</span><span class="symbol">-</span><span class="normal">build</span><span class="symbol">\</span><span class="normal">windows</span><span class="symbol">-</span><span class="normal">msvc</span><span class="symbol">.</span><span class="normal">bat</span>
+ <span class="path">C:\Python27\python</span><span class="symbol">.</span><span class="normal">exe how</span><span class="symbol">-</span><span class="normal">to</span><span class="symbol">-</span><span class="normal">build</span><span class="symbol">\</span><span class="normal">windows</span><span class="symbol">-</span><span class="normal">msvc</span><span class="symbol">.</span><span class="normal">py</span>
  </pre>
  
+   <p>
+     Please note, that you might have to change the path
+     for the python executable in the instructions above;
+     depending where you installed it.
+     Or, if the python executable can be found from <i>PATH</i>,
+     you can leave the path out.
+   </p>
+ 
+   <p>
+     The python script will download, extract and set up all the
+     libraries that are needed for Dern plugins. Then it will
+     build all the Dern programs, plugins and examples and will give
+     you a summary how to run or test them.
+   </p>
+ 
      <h3>2.6 ReactOS</h3>
  
    <p>

M release/octaspire-dern-amalgamated.c => release/octaspire-dern-amalgamated.c +1 -1
@@ 26336,7 26336,7 @@ #define OCTASPIRE_DERN_CONFIG_H
  
  #define OCTASPIRE_DERN_CONFIG_VERSION_MAJOR "0"
- #define OCTASPIRE_DERN_CONFIG_VERSION_MINOR "484"
+ #define OCTASPIRE_DERN_CONFIG_VERSION_MINOR "485"
  #define OCTASPIRE_DERN_CONFIG_VERSION_PATCH "0"
  
  #define OCTASPIRE_DERN_CONFIG_VERSION_STR "Octaspire Dern version " \