Proof Checking of Natural Mathematical Documents, with optional support for Isabelle Prover IDE (Isabelle/PIDE – Isabelle/jEdit).

NOTE: The subsequent explanations are for development of the tool, not for end-users!

Ensure that curl, git, and hg (Mercurial) are installed:

• Linux: e.g. sudo apt install curl git mercurial

• macOS: e.g. brew install mercurial or download from https://www.mercurial-scm.org

• Windows: use Cygwin64 with packages curl, git, and mercurial (via Cygwin setup-x86_64.exe)

Commands below assume the same current directory: repository clones isabelle_naproche and naproche are put side-by-side.

• Initial clone:

  hg clone https://isabelle.in.tum.de/repos/isabelle isabelle_naproche
  git clone https://github.com/naproche/naproche.git naproche
  
  isabelle_naproche/Admin/init -I Isabelle_Naproche -V ./naproche/Isabelle
  isabelle_naproche/bin/isabelle components -u ./naproche

• Later updates:

  git --git-dir="./naproche/.git" pull
  isabelle_naproche/Admin/init -V ./naproche/Isabelle

• Isabelle executable: there is no need to have isabelle_naproche/bin/isabelle in the PATH, but it is convenient to put it into a standard place once, e.g.:

  isabelle_naproche/bin/isabelle install "$HOME/bin"

• Build and test:

  • Shutdown Isabelle/jEdit before building Isabelle/Naproche as follows:

    isabelle naproche_build

  • Run some tests as follows (make sure that your current directory is the root of the Naproche repository):

    isabelle naproche_build && isabelle naproche_test -j2
    
    isabelle naproche_test -o naproche_server_debugging

  • Package the Isabelle/Naproche component as follows:

    isabelle naproche_build && isabelle naproche_component -P

    The result is for the current repository version, and the underlying HW + OS platform. The following reference platforms (x86_64) are used for Isabelle2022:

    • Ubuntu Linux 18.04 LTS
    • macOS 11 Big Sur
    • Windows 10

• Isabelle Prover IDE

  • Open ForTheL examples in Isabelle/jEdit, e.g.

    isabelle jedit examples/cantor.ftl

  • Open Isabelle development environment with ForTheL examples, e.g.

    isabelle jedit -l Pure Isabelle/Test.thy

• Using a recent E Theorem Prover: The E Theorem Prover bundled with Isabelle is only updated so often. If you would like to use the latest E Theorem Prover, follow the following instructions.

  1. Download and install the latest version of the E Theorem Prover from The E Theorem Prover Website. Installation instructions are provided in the README file. After following these, a working E executable should be located at E/PROVER/eprover.

  2. To make the eprover executable available to Isabelle/Naproche, we will create the e_naproche Isabelle component. First, we prepare the directory structure of the component:

     mkdir -p e_naproche/etc
     mkdir e_naproche/$(isabelle_naproche/bin/isabelle getenv -b ISABELLE_PLATFORM64)

     We then copy the eprover exutable into the component:

     cp eprover/PROVER/eprover e_naproche/$(isabelle_naproche/bin/isabelle getenv -b ISABELLE_PLATFORM64)/

     And create a document at e_naproche/etc/settings with the following content:

     # -*- shell-script -*- :mode=shellscript:
     
     E_HOME="$COMPONENT/$ISABELLE_PLATFORM64"
     

     Finally, we add the e_naproche component to Isabelle.

     isabelle_naproche/bin/isabelle components -u ./e_naproche

  3. To ensure that Naproche does not fall back to the E Theorem Prover component bundled with Isabelle, we need to ensure that the e_naproche component is loaded before the naproche component. First, navigate to your Isabelle user home, which can be located using

     isabelle_naproche/bin/isabelle getenv -b ISABELLE_HOME_USER

     Then edit the document at etc/components. Move the path pointing to the e_naproche component above that pointing to the naproche component.

     Finally, verify that the path returend by

     isabelle getenv -b NAPROCHE_EPROVER

     points to the eprover executable inside the e_naproche component.

• Supported OS platforms: Linux, macOS, Windows (e.g. with Cygwin terminal)

• The Haskell Tool Stack: https://www.haskellstack.org

• Install the E Theorem Prover (supported versions: 2.0 to 2.5) and set the environment variable NAPROCHE_EPROVER to its executable path.

  Note: the E prover executable bundled with Isabelle can be located like this:

  isabelle getenv -b NAPROCHE_EPROVER

• Optional (for development): Haskell IDE within VSCode: https://marketplace.visualstudio.com/items?itemName=haskell.haskell

cd .../naproche  #repository

stack clean

stack build

stack test

stack exec Naproche-SAD -- OPTIONS FILE

It may be necessary to allow the E Prover more time by appending -t SECONDS

You can use the tool Haddock to automatically generate documentation of Naproche's source code. Just run the following command:

stack haddock

To access this documentation via a local Hoogle server, proceed the following steps:

1. Generate a local Hoogle database.

   stack hoogle -- generate --local

2. Start a local Hoogle server.

   stack hoogle -- server --local --port=8080

Now you can access the documentation with your favourite web browser at https://localhost:8080.

If you are developing Naproche and want to add Haddock annotations to the source files, have a look at this guide: https://haskell-haddock.readthedocs.io/en/latest/markup.html

This program is based on the System for Automated Deduction (SAD) by Andrei Paskevich, see https://github.com/tertium/SAD. You can find more resources in our CONTRIBUTING.md.