WPE WebKit in Red Ribbon 0.1.2
===========================

Red Ribbon's browser tabs on Linux use WPE WebKit 2.54.2, a library
licensed under the GNU Lesser General Public License version 2.1
(LICENSE-WPE-LGPL-2.1.txt, next to this file), with parts under the BSD
licenses and others (wpewebkit-licenses/).

Red Ribbon uses the unmodified upstream release. Its source code is included next to this file as wpewebkit-2.54.2.tar.xz, and is
published by the WPE project at

  https://wpewebkit.org/releases/wpewebkit-2.54.2.tar.xz
  sha256 f3284e19e47fcb5ac8c63c2e1c113dbd65b2423eb8a545f5b345707829004f56

built with CMake and these options (Red Ribbon's
crates/wpe-embed/build/provision.rs):

  -DPORT=WPE
  -DCMAKE_BUILD_TYPE=Release
  '-DCMAKE_C_FLAGS_RELEASE=-O2 -g0 -DNDEBUG'
  '-DCMAKE_CXX_FLAGS_RELEASE=-O2 -g0 -DNDEBUG'
  -DENABLE_WPE_PLATFORM=ON
  -DENABLE_WPE_LEGACY_API=OFF
  -DENABLE_WPE_PLATFORM_WAYLAND=OFF
  -DENABLE_WPE_PLATFORM_DRM=OFF
  -DENABLE_WPE_PLATFORM_HEADLESS=OFF
  -DENABLE_MINIBROWSER=OFF
  -DENABLE_API_TESTS=OFF
  -DENABLE_LAYOUT_TESTS=OFF
  -DENABLE_DOCUMENTATION=OFF
  -DENABLE_INTROSPECTION=OFF
  -DENABLE_JOURNALD_LOG=OFF
  -DUSE_LIBBACKTRACE=OFF
  -DUSE_SYSTEM_UNIFDEF=OFF
  -DENABLE_BUBBLEWRAP_SANDBOX=ON
  -DENABLE_PDFJS=OFF
  -DENABLE_WEBDRIVER=OFF
  -DENABLE_SPELLCHECK=ON
  -DENABLE_XSLT=OFF
  -DENABLE_SPEECH_SYNTHESIS=OFF
  -DENABLE_GAMEPAD=OFF
  -DENABLE_WEB_RTC=OFF
  -DENABLE_MEDIA_STREAM=OFF
  -DENABLE_MEDIA_RECORDER=OFF
  -DENABLE_WEB_CODECS=OFF
  -DUSE_AVIF=OFF
  -DUSE_JPEGXL=OFF
  -DUSE_ATK=OFF
  -DUSE_LIBHYPHEN=OFF
  -DUSE_SKIA_OPENTYPE_SVG=OFF
  -DCMAKE_INSTALL_PREFIX=<prefix>
  -DCMAKE_INSTALL_RPATH=<prefix>/lib
  -DCMAKE_INSTALL_LIBDIR=lib
  -DCMAKE_INSTALL_LIBEXECDIR=libexec

then `cmake --build` and `cmake --install --strip`.

Packaging changes the installed files in two ways only, both done by
packaging/linux.sh (next to this file), and undone by AppRun's per-user
copy: each binary's RUNPATH is set relative to the binary itself, and the
install prefix compiled into the binaries is overwritten in place with a
path of the same length under /tmp, which AppRun links to that copy.

Using your own build of WPE WebKit
----------------------------------
Build WPE WebKit 2.54.2 (modified as you like) with the options above,
then either:
  - copy its lib/ over ~/.cache/ribbon/appimage/2.54.2-r4-*/lib/ (created the
    first time Red Ribbon runs), or
  - run the AppImage with its lib/ folder in LD_LIBRARY_PATH, which is
    searched before the bundled copy.
Or extract the AppImage (--appimage-extract) and replace the files in
squashfs-root/wpe/.
