Editing MXE

[https://hg.octave.org/mxe-octave MXE-Octave] was forked 2012 from the [https://mxe.cc/ MXE project] and is useful for building Octave in the following scenarios<ref>[https://hg.octave.org/mxe-octave/file/6836b2f08479/README MXE-Octave README] text by [[User:jwe|jwe]].</ref>:

# Cross-compilation for MS Windows (see also [[Windows_Installer]]) and other platforms.
# Building Octave on outdated Linux systems (e.g. only an old GCC version is available).
# Building Octave without root permission.

{{Warning|MXE-Octave is '''not''' the best choice for building Octave, if your system already provides recent versions of GCC and other required build dependencies. See [[:Category:Installation]] for other install options.}}

=== Example of compiling MXE-Octave ===

==== Preparation ====

# [[Windows_Installer#Installing_requirements_of_MXE_Octave|Install all requirements of MXE Octave]].
# Decide for an installation directory (e.g. {{path|~/mxe-octave}}).
# <code>cd ~</code>
# <code>hg clone https://hg.octave.org/mxe-octave mxe-octave</code>
# <code>cd mxe-octave</code>
# <code>./bootstrap</code>

==== Configuration ====

For a comprehensive list of configuration options with a short explanation, type <code>./configure --help</code>.  See also the [[#Known issues|known issues]] below.

<syntaxhighlight lang="text">
./configure \
    --prefix=$HOME/mxe-octave \
    --enable-native-build \
    --enable-octave=release \
    --enable-64 \
    --enable-fortran-int64 \
    --enable-pic-flag \
    --enable-openblas \
    --enable-jit
</syntaxhighlight>

==== Build ====

<code>make all openblas JOBS=4</code> (adapt the value of the variable <code>JOBS</code> to your needs).

==== Replace reference BLAS by OpenBLAS ====

In general using the [https://www.openblas.net/ OpenBLAS] library results in faster matrix-vector operations compared to the reference BLAS library.

# <code>cd ~/mxe-octave/usr/lib</code>
# <code>mv libblas.so libblas.so.reference</code>
# <code>ln -s libopenblas.so libblas.so</code>

==== Run ====

# MXE-Octave will exist in {{path|~/mxe-octave/usr/bin}}
# Add the command <code>octave</code> as alias to your {{path|.bashrc}} file: <code>alias octave=~/mxe-octave/usr/bin/octave</code>
# Start MXE-Octave by typing <code>octave</code>.

=== Known issues ===

==== gnuplot ====

The gnuplot built by MXE-Octave does not support cairo based terminals and lua/tikz terminals.
If you want uses those features, prepare gnuplot with those features and type in the Octave command prompt

  >> gnuplot_binary /usr/bin/gnuplot

==== Build errors on older systems ====

On some older systems, it might be useful to consider adding the configuration options
* <code>--disable-docs</code>
* <code>--disable-system-opengl</code>
* <code>--disable-system-x11-libs</code>
* <code>--disable-java</code>
in case of building errors.


=== References ===

<references/>

[[Category:Building]]