Skip to content

Commit 0ed7e51

Browse files
authored
Merge pull request #44 from StefanMathis/patch-1
Added note regarding Julia setup
2 parents c98f16a + 71ca4b9 commit 0ed7e51

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

docs/src/index.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,17 @@ This bot can be used offline or online.
2020

2121
Follow these steps to set up SnoopCompile bot for your package.
2222

23-
## 1 - Setting up the SnoopCompile bot configuration folder
23+
## 1 - Add Julia to your system PATH (if you haven't done that already)
24+
25+
The CompileBot spawns a new Julia process when running the `snoop_bot` function. Therefore, you need to make sure that Julia is added to your system PATH. See the official documentation on how to do that: https://julialang.org/downloads/platform/. To test whether Julia has been added successfully, simply open a terminal and type in `julia`. If everything has been configured correctly, the Julia REPL should be invoked now.
26+
27+
## 2 - Setting up the SnoopCompile bot configuration folder
2428

2529
Here, we will configure the bot in a directory `deps/SnoopCompile/` that should be added to your repository.
2630
All configuration files for the SnoopCompile bot should go in this directory.
2731
If you choose a different name for this directory, be sure to change the path in the configuration steps below.
2832

29-
## 2 - Create the precompile script
33+
## 3 - Create the precompile script
3034

3135
You will need a [precompile script](@ref pcscripts), here called `example_script.jl`, that "exercises" the functionality you'd like to precompile.
3236
If you write a dedicated precompile script, place it in the bot configuration folder.
@@ -35,7 +39,7 @@ Alternatively, you may use your package's `"runtests.jl"` file.
3539
While less precise about which functionality is worthy of precompilation,
3640
this can slightly simplify configuration as described below.
3741

38-
## 3 - Create the script that runs `snoop_bot`
42+
## 4 - Create the script that runs `snoop_bot`
3943

4044
The `snoop_bot` function generates precompile statements and writes them to
4145
a file that will be incorporated into your package.
@@ -90,7 +94,7 @@ with `snoop_bot(config, :(using MyPackage))`.
9094

9195
You can override this default behavior with a keyword argument, see [`snoop_bot`](@ref) for details.
9296

93-
## 4 - Optionally test the impact of your precompiles with `snoop_bench`
97+
## 5 - Optionally test the impact of your precompiles with `snoop_bench`
9498

9599
Call [`snoop_bench`](@ref) to measure the effect of adding precompile files.
96100
It takes the same parameters as `snoop_bot` above.
@@ -101,7 +105,7 @@ instead.
101105
Note that benchmarking has the option of different performance metrics,
102106
`snoop_mode=:snoopi` or `snoop_mode=:run_time` depending on whether you want to measure inference time or the run time of your precompile script.
103107

104-
## 5 - Configure the bot to run with a GitHub Action file
108+
## 6 - Configure the bot to run with a GitHub Action file
105109

106110
You can create the precompile files automatically when you merge pull requests to `master` by adding a workflow file under `.github/workflows/SnoopCompile.yml`.
107111
This file should have content such as the example below.

0 commit comments

Comments
 (0)