Differences

This shows you the differences between two versions of the page.

--- install:install [2020/06/25 09:49] – [Arch Linux] perl-json benmuell
+++ install:install [2023/10/06 07:43] (current) – perlbrew benmuell
@@ Line 1: / Line 1: @@
 ===== Installation from Source Code =====
 This page describes how to install polymake from the source code. See the [[:download:start|downloads page]] for other ways of installing polymake. In particular, if you are using Ubuntu or Debian, you might want to consider installing our [[:download:start##debian_fedora_gentoo_ubuntu|debian packages]].
+**Warning:** Unfortunately polymake is **not compatible with perl 5.38.0 or newer**. Since several Linux distributions have switched to the new perl version the polymake package had to be removed from their repositories. If you want to continue using polymake you can try our new [[install:jll|jll-based binaries]] or see below to build polymake from source with a [[install:install#Perlbrew|custom perl]].
 Usually, following the description in the [[install#quick_summary|quick summary]] should do the job. Please be aware that the installation procedure described on this page works on UNIX systems with the newest version of polymake. If you have special needs, you might find help in other places:
@@ Line 15: / Line 17: @@
 ===== Quick summary =====
-Installing polymake from sources can usually be accomplished using the following five steps:
+Installing polymake from sources can usually be accomplished using the following six steps:
+  * Make sure to have a supported perl version **older** than 5.38. Otherwise check the section on [[install:install#Perlbrew|perl-brew]].
   * Download a source tarball from the [[download/start|download page]].
@@ Line 48: / Line 52: @@
   * GNU Readline & History library v5.0+
-  * Perl 5.16.0+, with all of the following modules:
+  * Perl 5.16.0-5.36.x, with all of the following modules:
     * ''ExtUtils::Embed'', which some distributions ship separately as ''perl-ExtUtils-Embed''
     * ''XML::SAX''
@@ Line 61: / Line 65: @@
   * [[http://flintlib.org/|FLINT]] 2.5.2+. (This dependency is strongly recommended but can be disabled if it cannot be fulfilled)
+==== Perlbrew ====
+If your perl version is 5.38 or newer you need to build a custom perl to use with polymake. The easiest way to do this is to install ''perlbrew'' with your package manager (or from https://perlbrew.pl/).
+Once you have perlbrew installed you need to initialize it with ''perlbrew init'' and add ''source ~/perl5/perlbrew/etc/bashrc'' to your shell rc file as shown in the output.
+To build a compatible perl use:
+<code>
+perlbrew install perl-5.36.1 --as pmperl -Duseshrplib
+</code>
+The above command will take a few minutes, once that is done you can (temporarily) switch the perl version for the current shell with ''perlbrew use pmperl''. This change is active until you close that terminal again.
+To install the required perl modules for this perl installation run:
+<code>
+perlbrew use pmperl
+perlbrew install-cpanm
+cpanm Term::ReadLine::Gnu Term::ReadKey XML::SAX XML::Writer JSON SVG
+</code>
+In this shell you can now run the configure script for polymake and continue with the installation instructions. Make sure to always switch the perl to ''pmperl'' before running ''polymake''.
 ==== Recommended software ====