<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Recent changes to Building_PLplot</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>Recent changes to Building_PLplot</description><atom:link href="https://sourceforge.net/p/plplot/wiki/Building_PLplot/feed" rel="self"/><language>en</language><lastBuildDate>Tue, 23 Jul 2019 15:32:42 -0000</lastBuildDate><atom:link href="https://sourceforge.net/p/plplot/wiki/Building_PLplot/feed" rel="self" type="application/rss+xml"/><item><title>Building_PLplot modified by Phil Rosenberg</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v19
+++ v20
@@ -24,7 +24,7 @@
 Things work best if all libraries, including dependencies of PLplot share the same install directory. Things can work even if this is not the case, but it generally makes life easier if all libraries are installed together. One notable exception is wxWidgets on windows (PLplot can be built with wxWidgets support). wxWidgets on Windows does not easily allow installation in the typical Linux directory structure. Instead you should install it wherever you feel and set the WXWIN environment variable to point the the source directory.

 ####Suitable Install Paths
-Every effort is made to ensure spaces in the install path cause no problems for PLplot. However, problems do occur with paths that include a space followed by a hyphen " -". These paths can get interpretted as flags instead of paths.  We therefore suggest that your installation folder does not include this pattern. One case where this is quite likely to occur is when using OneDrive for Business. The default OneDrive for Business folder is "OneDrive - &amp;lt;your name="" business=""&amp;gt;". So if you build in this directory then you will hit problems. One workaround my be to create a symlink to your installation folder to avoid the path with the unsupported pattern. Note that this problem will occur if you install PLplot in a path with the space-hyphen pattern or if any of the dependencies are installed in a path with the space-hyphen pattern.
+Every effort is made to ensure spaces in the install path cause no problems for PLplot. However, problems do occur with paths that include a space followed by a hyphen " -". These paths can get interpretted as flags instead of paths.  We therefore suggest that your installation folder does not include this pattern. One case where this is quite likely to occur is when using OneDrive for Business. The default OneDrive for Business folder is "OneDrive - Your Business Name". So if you build in this directory then you will hit problems. One workaround my be to create a symlink to your installation folder to avoid the path with the unsupported pattern. Note that this problem will occur if you install PLplot in a path with the space-hyphen pattern or if any of the dependencies are installed in a path with the space-hyphen pattern.

 ### &lt;a name="Generic_Unix_instructions_for_our_build_system"&gt;&lt;/a&gt;Generic Unix instructions for our build system

&amp;lt;/your&amp;gt;&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Phil Rosenberg</dc:creator><pubDate>Tue, 23 Jul 2019 15:32:42 -0000</pubDate><guid>https://sourceforge.net573c1e791091c8d20f42d0b752146d0339208ec7</guid></item><item><title>Building_PLplot modified by Phil Rosenberg</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v18
+++ v19
@@ -18,6 +18,14 @@

 After consulting that documentation, [install](http://www.cmake.org/HTML/Install.html) the appropriate package of [CMake](http://www.cmake.org) for your system platform. Note, you must use at least version 2.8.9 of CMake for your PLplot configuration, but our build system works with the latest version (3.0.2) of CMake as well.

+###Build Location
+We recommend that, whatever platform you use, you build your libraries in a Linux style directory structure. CMake will install your libraries in this type of structure. Typically this will be in a folder called usr/ or usr/local/, but in can be any other name. You can set your install directory by using the CMake option CMAKE_INSTALL_PREFIX. Typically you would put source code for PLplot (and other libraries) in a src subdirectory of your install directory, e.g. usr/src/plplot-x.y.z.  When you build and install PLplot it will create subdirectories, lib, bin, share within the installation directory if needed, then place apropriate content in these locations. You should add the bin directory to your path environment variable.
+
+Things work best if all libraries, including dependencies of PLplot share the same install directory. Things can work even if this is not the case, but it generally makes life easier if all libraries are installed together. One notable exception is wxWidgets on windows (PLplot can be built with wxWidgets support). wxWidgets on Windows does not easily allow installation in the typical Linux directory structure. Instead you should install it wherever you feel and set the WXWIN environment variable to point the the source directory.
+
+####Suitable Install Paths
+Every effort is made to ensure spaces in the install path cause no problems for PLplot. However, problems do occur with paths that include a space followed by a hyphen " -". These paths can get interpretted as flags instead of paths.  We therefore suggest that your installation folder does not include this pattern. One case where this is quite likely to occur is when using OneDrive for Business. The default OneDrive for Business folder is "OneDrive - &amp;lt;your name="" business=""&amp;gt;". So if you build in this directory then you will hit problems. One workaround my be to create a symlink to your installation folder to avoid the path with the unsupported pattern. Note that this problem will occur if you install PLplot in a path with the space-hyphen pattern or if any of the dependencies are installed in a path with the space-hyphen pattern.
+
 ### &lt;a name="Generic_Unix_instructions_for_our_build_system"&gt;&lt;/a&gt;Generic Unix instructions for our build system

 #### (Optional) set environment variables to help cmake find system components that are installed in non-standard locations
@@ -25,7 +33,7 @@
 Here is one particular example (which must be executed before the cmake invocation discussed below).

 `export CMAKE_INCLUDE_PATH=/home/software/shapelib/install/include`
-`export CMAKE_LIBRARY_PATH=`/home/software/shapelib/install/lib`
+`export CMAKE_LIBRARY_PATH=/home/software/shapelib/install/lib`
 `export PKG_CONFIG_PATH=/home/software/libLASi/install/lib/pkgconfig`

 For this particular example, &lt;tt&gt;CMAKE_INCLUDE_PATH&lt;/tt&gt; and &lt;tt&gt;CMAKE_LIBRARY_PATH&lt;/tt&gt; helps cmake to find the headers and library for &lt;tt&gt;shapelib&lt;/tt&gt; in a non-standard install location, and &lt;tt&gt;PKG_CONFIG_PATH&lt;/tt&gt; helps cmake to use the &lt;tt&gt;pkg-config&lt;/tt&gt; command internally to find a libLASi pkg-config module file that is installed in a non-standard location.  Use colon separation if more than one non-standard install location needs to be specified with &lt;tt&gt;CMAKE_INCLUDE_PATH&lt;/tt&gt; , &lt;tt&gt;CMAKE_LIBRARY_PATH&lt;/tt&gt;, and/or &lt;tt&gt;PKG_CONFIG_PATH&lt;/tt&gt;.  Also, although not used in the specific example above, the colon-separated environment variable &lt;tt&gt;PATH&lt;/tt&gt; helps cmake find executables that are installed in non-standard locations.
&amp;lt;/your&amp;gt;&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Phil Rosenberg</dc:creator><pubDate>Tue, 23 Jul 2019 15:31:26 -0000</pubDate><guid>https://sourceforge.netb1ed09ff128443e2da371e3eb3a4a467cda2ca2c</guid></item><item><title>Building_PLplot modified by Alan W. Irwin</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v17
+++ v18
@@ -91,4 +91,3 @@
 * Include the verbose results of your install (captured as make_install.out above) in your report.

 The content of this page is available under the [GNU Free Documentation License 1.2](http://www.gnu.org/copyleft/fdl.html).
-
&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alan W. Irwin</dc:creator><pubDate>Sun, 02 Dec 2018 21:16:21 -0000</pubDate><guid>https://sourceforge.net9be0376523c613b9a414e6ef5b884e0b571f1b85</guid></item><item><title>Building_PLplot modified by Alan W. Irwin</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v16
+++ v17
@@ -74,7 +74,7 @@
 #### Useful problem reports
 If you encounter a problem with the above, then it is important to report the problem with sufficient details (typically to either the plplot-general or plplot-devel mailing lists) so that those familiar with PLplot builds can help you.  This section lists the details that are typically required in a useful problem report.

-* Include all environment variables that were set in your report. (The easiest way to do this on Unix is to invoke the command 
+* Include all environment variables that were set in your report. (The easiest way to do this on Unix is to invoke the command
 `printenv &amp;gt; printenv.out`
 and  include printenv.out in your report.)

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alan W. Irwin</dc:creator><pubDate>Sun, 02 Dec 2018 20:11:45 -0000</pubDate><guid>https://sourceforge.net517b2236e50fd722a8d98859dabff031d87c013c</guid></item><item><title>Building_PLplot modified by Alan W. Irwin</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alan W. Irwin</dc:creator><pubDate>Thu, 01 Nov 2018 21:46:07 -0000</pubDate><guid>https://sourceforge.net45b8858c94224997b219e5c467a04ee6d7aff722</guid></item><item><title>Building_PLplot modified by Alan W. Irwin</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v14
+++ v15
@@ -1,3 +1,15 @@
+
+
 All PLplot builds are done with our CMake-based build system which gives good results on Linux, Mac OS X, and traditional Unices, and on Windows (Cygwin, MinGW, MinGW/MSYS, and MSVC). After reading this section you should consult [specifics for various platforms](Specifics for various platforms "wikilink") for more details. Also, after a build and install is completed you should follow up by [testing PLplot](testing PLplot "wikilink").

 ### Building PLplot with our CMake-based build system
&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alan W. Irwin</dc:creator><pubDate>Thu, 01 Nov 2018 21:40:37 -0000</pubDate><guid>https://sourceforge.net223473261cb6d2a1dceae69cf3d1025cc9c90b0b</guid></item><item><title>Building_PLplot modified by Alan W. Irwin</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v13
+++ v14
@@ -1,10 +1,10 @@
-With the exception of DJGPP on (Free)DOS (where you should follow the directions at sys/dos/djgpp/readme) all PLplot builds are done with our CMake-based build system which gives good results on Unix, Linux, and Mac OS X and Cygwin, MinGW, MinGW/MSYS, and bare windows. After reading this section you should consult [specifics for various platforms](Specifics for various platforms "wikilink") for more details. Also, after a build and install is completed you should follow up by [testing PLplot](testing PLplot "wikilink").
+All PLplot builds are done with our CMake-based build system which gives good results on Linux, Mac OS X, and traditional Unices, and on Windows (Cygwin, MinGW, MinGW/MSYS, and MSVC). After reading this section you should consult [specifics for various platforms](Specifics for various platforms "wikilink") for more details. Also, after a build and install is completed you should follow up by [testing PLplot](testing PLplot "wikilink").

 ### Building PLplot with our CMake-based build system

-Our CMake-based build system has been made available as part of our development releases of PLplot starting with version 5.7.0 and is now with the exception of the DJGPP platform our sole build system. It is important to consult the CMake documentation to get the most out of our build system. That documentation is quite thorough but tends to be a bit scattered so we have collected what we think are the best [general CMake documentation links](general CMake documentation links "wikilink") for your convenience.
+To get the most out of our build system, it is important to consult the CMake documentation. That documentation is quite thorough but tends to be a bit scattered so we have collected what we think are the best [general CMake documentation links](general CMake documentation links "wikilink") for your convenience.

-After consulting that documentation, [install](http://www.cmake.org/HTML/Install.html) the appropriate package of [CMake](http://www.cmake.org) for your system platform. Note, you must use at least version 2.6.0 of CMake for your PLplot configuration, but our build system works with the latest version (2.6.2) of CMake as well.
+After consulting that documentation, [install](http://www.cmake.org/HTML/Install.html) the appropriate package of [CMake](http://www.cmake.org) for your system platform. Note, you must use at least version 2.8.9 of CMake for your PLplot configuration, but our build system works with the latest version (3.0.2) of CMake as well.

 ### &lt;a name="Generic_Unix_instructions_for_our_build_system"&gt;&lt;/a&gt;Generic Unix instructions for our build system

@@ -12,13 +12,11 @@

 Here is one particular example (which must be executed before the cmake invocation discussed below).

-`export CMAKE_INCLUDE_PATH=/home/software/autotools/install/include:/home/software/cgmlib/cd1.3`
-`export CMAKE_LIBRARY_PATH=/home/software/autotools/install/lib:/home/software/cgmlib/cd1.3`
+`export CMAKE_INCLUDE_PATH=/home/software/shapelib/install/include`
+`export CMAKE_LIBRARY_PATH=`/home/software/shapelib/install/lib`
 `export PKG_CONFIG_PATH=/home/software/libLASi/install/lib/pkgconfig`

-For this particular example, &lt;tt&gt;CMAKE_INCLUDE_PATH&lt;/tt&gt; helps cmake to find the headers for &lt;tt&gt;libltdl&lt;/tt&gt; and &lt;tt&gt;libcd&lt;/tt&gt; in non-standard install locations; &lt;tt&gt;CMAKE_LIBRARY_PATH&lt;/tt&gt; helps cmake to find the &lt;tt&gt;libltdl&lt;/tt&gt; and &lt;tt&gt;libcd&lt;/tt&gt; libraries in non-standard install locations; and &lt;tt&gt;PKG_CONFIG_PATH&lt;/tt&gt; helps cmake to use the &lt;tt&gt;pkg-config&lt;/tt&gt; command internally to find a libLASi pkg-config module file that is installed in a non-standard location.
-
-In general, &lt;tt&gt;CMAKE_INCLUDE_PATH&lt;/tt&gt; helps cmake find headers and other files that are installed in non-standard locations; &lt;tt&gt;CMAKE_LIBRARY_PATH&lt;/tt&gt; helps cmake find libraries that are installed in non-standard locations; and &lt;tt&gt;PKG_CONFIG_PATH&lt;/tt&gt; helps pkg-config (either externally or internally from cmake) find pkg-config modules installed in non-standard locations. Finally, although not used in the specific example above, the colon-separated environment variable &lt;tt&gt;PATH&lt;/tt&gt; helps cmake find executables that are installed in non-standard locations.
+For this particular example, &lt;tt&gt;CMAKE_INCLUDE_PATH&lt;/tt&gt; and &lt;tt&gt;CMAKE_LIBRARY_PATH&lt;/tt&gt; helps cmake to find the headers and library for &lt;tt&gt;shapelib&lt;/tt&gt; in a non-standard install location, and &lt;tt&gt;PKG_CONFIG_PATH&lt;/tt&gt; helps cmake to use the &lt;tt&gt;pkg-config&lt;/tt&gt; command internally to find a libLASi pkg-config module file that is installed in a non-standard location.  Use colon separation if more than one non-standard install location needs to be specified with &lt;tt&gt;CMAKE_INCLUDE_PATH&lt;/tt&gt; , &lt;tt&gt;CMAKE_LIBRARY_PATH&lt;/tt&gt;, and/or &lt;tt&gt;PKG_CONFIG_PATH&lt;/tt&gt;.  Also, although not used in the specific example above, the colon-separated environment variable &lt;tt&gt;PATH&lt;/tt&gt; helps cmake find executables that are installed in non-standard locations.

 #### (Optional) set environment variables to specify the compilers and compiler flags

@@ -26,7 +24,7 @@

 `export CC="gcc -O2"`
 `export CXX="g++ -O2"`
-`export FC="g77 -O2"`
+`export FC="gfortran -O2"`

 If you don't set the environment variables above, then by default no compiler options (i.e., no optimization and no debugging symbols) are used for gcc-related compilers for our build system which makes for fast builds, but slow execution.

@@ -37,7 +35,7 @@
 `mkdir build_dir`
 `cd build_dir`
 `cmake -DCMAKE_INSTALL_PREFIX=/my/prefix \`
-`../plplot_cmake &amp;gt;&amp;amp; cmake.out`
+`../plplot.git &amp;gt;&amp;amp; cmake.out`

 (CMake is capable of generating builds within the source tree, but we have emphasized a build with a separate build tree here because of its fundamental advantage that the source tree remains clean with no generated files in it.)

@@ -45,17 +43,40 @@

 There are a large number of [CMake options for PLplot](CMake options for PLplot "wikilink") which can be set for cmake to personalize your build. Use the ccmake front end to cmake to obtain documentation of all these options. In the above case we have specified a particular install prefix "/my/prefix".

-Note in the above example an initially empty build directory (arbitrarily) named build_dir is used to insure a clean start, and ../plplot_cmake is the (arbitrary) name of the top-level directory of a freshly checked out source tree from our svn repository. If instead you use a freshly unpacked PLplot source distribution tarball "../plplot_cmake" will need to be replaced by "../plplot-5.9.2" (for our latest release at time of writing).
+Note in the above example an initially empty build directory (arbitrarily) named build_dir is used to insure a clean start, and ../plplot.git is the (arbitrary) name of the top-level directory of a freshly cloned git repository. If instead you use a freshly unpacked PLplot source distribution tarball "../plplot.git" will need to be replaced by "../plplot-5.10.0" (for our latest release at time of writing).

-To start a fresh build, simply execute "cd build_dir; rm -rf \*" before invoking cmake. Of course, "rm -rf \*" is an extremely dangerous command (since it removes everything in the current directory and all subdirectories), but you should be okay so long as you cd to the correct directory before executing the "rm" command.
+To start a fresh build, simply execute
+
+`cd build_dir`
+`rm -rf \*`
+
+before invoking cmake. Of course, that "rm" command is an extremely dangerous command (since it removes everything in the current directory and all subdirectories), but you should be okay so long as you cd to the correct directory before executing the "rm" command.

 #### Build and install

-`make &amp;gt;&amp;amp; make.out`
-`make install &amp;gt;&amp;amp; make_install.out`
+`make VERBOSE=1 &amp;gt;&amp;amp; make.out`
+`make VERBOSE=1 install &amp;gt;&amp;amp; make_install.out`

 Check make.out and make_install.out for any errors. Follow up by [testing PLplot](testing PLplot "wikilink").

+#### Useful problem reports
+If you encounter a problem with the above, then it is important to report the problem with sufficient details (typically to either the plplot-general or plplot-devel mailing lists) so that those familiar with PLplot builds can help you.  This section lists the details that are typically required in a useful problem report.
+
+* Include all environment variables that were set in your report. (The easiest way to do this on Unix is to invoke the command 
+`printenv &amp;gt; printenv.out`
+and  include printenv.out in your report.)
+
+* State the cmake command that was used in your report.
+
+* Include the cmake output (captured as cmake.out above) in your report
+
+* State the PLplot version that was used (e.g., commit ID if you are following the git master branch or release version number if you are using a release tarball) in your report.
+
+* Include the CMake cache file, CMakeCache.txt, in your report.
+
+* Include the verbose results of your build (captured as make.out above) in your report.
+
+* Include the verbose results of your install (captured as make_install.out above) in your report.

 The content of this page is available under the [GNU Free Documentation License 1.2](http://www.gnu.org/copyleft/fdl.html).

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alan W. Irwin</dc:creator><pubDate>Fri, 14 Nov 2014 17:43:55 -0000</pubDate><guid>https://sourceforge.netc0b993d55c5d7d844432284c44be4d47a43d56da</guid></item><item><title>Building_PLplot modified by Alan W. Irwin</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alan W. Irwin</dc:creator><pubDate>Sun, 05 Oct 2014 19:01:21 -0000</pubDate><guid>https://sourceforge.neta7c924a30661f751b7e5a23e45c0d571acbbdcc4</guid></item><item><title>Building_PLplot modified by Alan W. Irwin</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v11
+++ v12
@@ -6,7 +6,7 @@

 After consulting that documentation, [install](http://www.cmake.org/HTML/Install.html) the appropriate package of [CMake](http://www.cmake.org) for your system platform. Note, you must use at least version 2.6.0 of CMake for your PLplot configuration, but our build system works with the latest version (2.6.2) of CMake as well.

-### Generic Unix instructions for our build system
+### &lt;a name="Generic_Unix_instructions_for_our_build_system"&gt;&lt;/a&gt;Generic Unix instructions for our build system

 #### (Optional) set environment variables to help cmake find system components that are installed in non-standard locations

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alan W. Irwin</dc:creator><pubDate>Fri, 03 Oct 2014 22:55:38 -0000</pubDate><guid>https://sourceforge.net6d97cca2146969982a8e1b6a8d021673ba765061</guid></item><item><title>Building_PLplot modified by Alan W. Irwin</title><link>https://sourceforge.net/p/plplot/wiki/Building_PLplot/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v10
+++ v11
@@ -1,112 +1,61 @@
-With the exception of DJGPP on (Free)DOS (where you should follow the directions at sys/dos/djgpp/readme) all PLplot builds are done with our CMake-based build system which gives good results on Unix, Linux, and Mac OS X and Cygwin, MinGW, MinGW/MSYS, and bare windows. After reading this section you should consult [specifics for various platforms](Specifics for various platforms "wikilink") for more details.  Also, after a build and install is completed you should follow up by [testing PLplot](testing PLplot "wikilink").
+With the exception of DJGPP on (Free)DOS (where you should follow the directions at sys/dos/djgpp/readme) all PLplot builds are done with our CMake-based build system which gives good results on Unix, Linux, and Mac OS X and Cygwin, MinGW, MinGW/MSYS, and bare windows. After reading this section you should consult [specifics for various platforms](Specifics for various platforms "wikilink") for more details. Also, after a build and install is completed you should follow up by [testing PLplot](testing PLplot "wikilink").

 ### Building PLplot with our CMake-based build system

-Our CMake-based build system has been made available as part of our
-development releases of PLplot starting with version 5.7.0 and is now
-with the exception of the DJGPP platform our sole build system. It is
-important to consult the CMake documentation to get the most out of our
-build system. That documentation is quite thorough but tends to be a bit
-scattered so we have collected what we think are the best [general CMake
-documentation links](general CMake documentation links "wikilink") for
-your convenience.
+Our CMake-based build system has been made available as part of our development releases of PLplot starting with version 5.7.0 and is now with the exception of the DJGPP platform our sole build system. It is important to consult the CMake documentation to get the most out of our build system. That documentation is quite thorough but tends to be a bit scattered so we have collected what we think are the best [general CMake documentation links](general CMake documentation links "wikilink") for your convenience.

-After consulting that documentation,
-[install](http://www.cmake.org/HTML/Install.html) the appropriate
-package of [CMake](http://www.cmake.org) for your system platform. Note,
-you must use at least version 2.6.0 of CMake for your PLplot
-configuration, but our build system works with the latest version
-(2.6.2) of CMake as well.
+After consulting that documentation, [install](http://www.cmake.org/HTML/Install.html) the appropriate package of [CMake](http://www.cmake.org) for your system platform. Note, you must use at least version 2.6.0 of CMake for your PLplot configuration, but our build system works with the latest version (2.6.2) of CMake as well.

 ### Generic Unix instructions for our build system

 #### (Optional) set environment variables to help cmake find system components that are installed in non-standard locations

-Here is one particular example (which must be executed before the cmake
-invocation discussed below).
+Here is one particular example (which must be executed before the cmake invocation discussed below).

-`export CMAKE_INCLUDE_PATH=/home/software/autotools/install/include:/home/software/cgmlib/cd1.3`\
-`export CMAKE_LIBRARY_PATH=/home/software/autotools/install/lib:/home/software/cgmlib/cd1.3`\
+`export CMAKE_INCLUDE_PATH=/home/software/autotools/install/include:/home/software/cgmlib/cd1.3`
+`export CMAKE_LIBRARY_PATH=/home/software/autotools/install/lib:/home/software/cgmlib/cd1.3`
 `export PKG_CONFIG_PATH=/home/software/libLASi/install/lib/pkgconfig`

-For this particular example, \&amp;lt;tt\&amp;gt;CMAKE\_INCLUDE\_PATH\&amp;lt;/tt\&amp;gt; helps
-cmake to find the headers for \&amp;lt;tt\&amp;gt;libltdl\&amp;lt;/tt\&amp;gt; and
-\&amp;lt;tt\&amp;gt;libcd\&amp;lt;/tt\&amp;gt; in non-standard install locations;
-\&amp;lt;tt\&amp;gt;CMAKE\_LIBRARY\_PATH\&amp;lt;/tt\&amp;gt; helps cmake to find the
-\&amp;lt;tt\&amp;gt;libltdl\&amp;lt;/tt\&amp;gt; and \&amp;lt;tt\&amp;gt;libcd\&amp;lt;/tt\&amp;gt; libraries in non-standard
-install locations; and \&amp;lt;tt\&amp;gt;PKG\_CONFIG\_PATH\&amp;lt;/tt\&amp;gt; helps cmake to use
-the \&amp;lt;tt\&amp;gt;pkg-config\&amp;lt;/tt\&amp;gt; command internally to find a libLASi
-pkg-config module file that is installed in a non-standard location.
+For this particular example, &lt;tt&gt;CMAKE_INCLUDE_PATH&lt;/tt&gt; helps cmake to find the headers for &lt;tt&gt;libltdl&lt;/tt&gt; and &lt;tt&gt;libcd&lt;/tt&gt; in non-standard install locations; &lt;tt&gt;CMAKE_LIBRARY_PATH&lt;/tt&gt; helps cmake to find the &lt;tt&gt;libltdl&lt;/tt&gt; and &lt;tt&gt;libcd&lt;/tt&gt; libraries in non-standard install locations; and &lt;tt&gt;PKG_CONFIG_PATH&lt;/tt&gt; helps cmake to use the &lt;tt&gt;pkg-config&lt;/tt&gt; command internally to find a libLASi pkg-config module file that is installed in a non-standard location.

-In general, \&amp;lt;tt\&amp;gt;CMAKE\_INCLUDE\_PATH\&amp;lt;/tt\&amp;gt; helps cmake find headers
-and other files that are installed in non-standard locations;
-\&amp;lt;tt\&amp;gt;CMAKE\_LIBRARY\_PATH\&amp;lt;/tt\&amp;gt; helps cmake find libraries that are
-installed in non-standard locations; and \&amp;lt;tt\&amp;gt;PKG\_CONFIG\_PATH\&amp;lt;/tt\&amp;gt;
-helps pkg-config (either externally or internally from cmake) find
-pkg-config modules installed in non-standard locations. Finally,
-although not used in the specific example above, the colon-separated
-environment variable \&amp;lt;tt\&amp;gt;PATH\&amp;lt;/tt\&amp;gt; helps cmake find executables that
-are installed in non-standard locations.
+In general, &lt;tt&gt;CMAKE_INCLUDE_PATH&lt;/tt&gt; helps cmake find headers and other files that are installed in non-standard locations; &lt;tt&gt;CMAKE_LIBRARY_PATH&lt;/tt&gt; helps cmake find libraries that are installed in non-standard locations; and &lt;tt&gt;PKG_CONFIG_PATH&lt;/tt&gt; helps pkg-config (either externally or internally from cmake) find pkg-config modules installed in non-standard locations. Finally, although not used in the specific example above, the colon-separated environment variable &lt;tt&gt;PATH&lt;/tt&gt; helps cmake find executables that are installed in non-standard locations.

 #### (Optional) set environment variables to specify the compilers and compiler flags

-Here is one particular example (which must be executed before the cmake
-invocation discussed below).
+Here is one particular example (which must be executed before the cmake invocation discussed below).

-`export CC="gcc -O2"`\
-`export CXX="g++ -O2"`\
+`export CC="gcc -O2"`
+`export CXX="g++ -O2"`
 `export FC="g77 -O2"`

-If you don't set the environment variables above, then by default no
-compiler options (i.e., no optimization and no debugging symbols) are
-used for gcc-related compilers for our build system which makes for fast
-builds, but slow execution.
+If you don't set the environment variables above, then by default no compiler options (i.e., no optimization and no debugging symbols) are used for gcc-related compilers for our build system which makes for fast builds, but slow execution.

 #### cmake invocation

 Here is one typical example.

-`mkdir build_dir`\
-`cd build_dir`\
-`cmake -DCMAKE_INSTALL_PREFIX=/my/prefix \`\
+`mkdir build_dir`
+`cd build_dir`
+`cmake -DCMAKE_INSTALL_PREFIX=/my/prefix \`
 `../plplot_cmake &amp;gt;&amp;amp; cmake.out`

-(CMake is capable of generating builds within the source tree, but we
-have emphasized a build with a separate build tree here because of its
-fundamental advantage that the source tree remains clean with no
-generated files in it.)
+(CMake is capable of generating builds within the source tree, but we have emphasized a build with a separate build tree here because of its fundamental advantage that the source tree remains clean with no generated files in it.)

-Check the cmake.out file for any configuration issues, especially
-WARNING messages which signal that a component of PLplot has been
-removed because required system components for that component have not
-been found.
+Check the cmake.out file for any configuration issues, especially WARNING messages which signal that a component of PLplot has been removed because required system components for that component have not been found.

-There are a large number of [CMake options for
-PLplot](CMake options for PLplot "wikilink") which can be set for cmake
-to personalize your build. Use the ccmake front end to cmake to obtain
-documentation of all these options. In the above case we have specified
-a particular install prefix "/my/prefix".
+There are a large number of [CMake options for PLplot](CMake options for PLplot "wikilink") which can be set for cmake to personalize your build. Use the ccmake front end to cmake to obtain documentation of all these options. In the above case we have specified a particular install prefix "/my/prefix".

-Note in the above example an initially empty build directory
-(arbitrarily) named build\_dir is used to insure a clean start, and
-../plplot\_cmake is the (arbitrary) name of the top-level directory of a
-freshly checked out source tree from our svn repository. If instead you
-use a freshly unpacked PLplot source distribution tarball
-"../plplot\_cmake" will need to be replaced by "../plplot-5.9.2" (for
-our latest release at time of writing).
+Note in the above example an initially empty build directory (arbitrarily) named build_dir is used to insure a clean start, and ../plplot_cmake is the (arbitrary) name of the top-level directory of a freshly checked out source tree from our svn repository. If instead you use a freshly unpacked PLplot source distribution tarball "../plplot_cmake" will need to be replaced by "../plplot-5.9.2" (for our latest release at time of writing).

-To start a fresh build, simply execute "cd build\_dir; rm -rf \*" before
-invoking cmake. Of course, "rm -rf \*" is an extremely dangerous command
-(since it removes everything in the current directory and all
-subdirectories), but you should be okay so long as you cd to the correct
-directory before executing the "rm" command.
+To start a fresh build, simply execute "cd build_dir; rm -rf \*" before invoking cmake. Of course, "rm -rf \*" is an extremely dangerous command (since it removes everything in the current directory and all subdirectories), but you should be okay so long as you cd to the correct directory before executing the "rm" command.

 #### Build and install

-`make &amp;gt;&amp;amp; make.out`\
+`make &amp;gt;&amp;amp; make.out`
 `make install &amp;gt;&amp;amp; make_install.out`

-Check make.out and make\_install.out for any errors. Follow up by
-[testing PLplot](testing PLplot "wikilink").
+Check make.out and make_install.out for any errors. Follow up by [testing PLplot](testing PLplot "wikilink").
+

 The content of this page is available under the [GNU Free Documentation License 1.2](http://www.gnu.org/copyleft/fdl.html).
+
&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alan W. Irwin</dc:creator><pubDate>Tue, 30 Sep 2014 21:05:02 -0000</pubDate><guid>https://sourceforge.nete33adb15e34f4330b92737b9a507ff1bd079946a</guid></item></channel></rss>