Skip to content

Commit

Permalink
README: mention install "reset" for Homebrew users
Browse files Browse the repository at this point in the history
  • Loading branch information
timholy committed Jun 1, 2017
1 parent 9b0d4e3 commit c776da4
Showing 1 changed file with 18 additions and 6 deletions.
24 changes: 18 additions & 6 deletions README.md
Expand Up @@ -14,23 +14,23 @@ modular.

Add the package with

```jl
```julia
Pkg.add("ImageMagick")
```

# Usage

ImageMagick will be used as needed if you've said

```
```julia
using FileIO
```

in your session or module. You should **not** generally say `using
ImageMagick`. See [FileIO](https://github.com/JuliaIO/FileIO.jl) for
further details.

It's worth pointing out that packages such as Images load FileIO.
It's worth pointing out that packages such as [Images.jl](https://github.com/JuliaImages/Images.jl) load FileIO for you.

# Troubleshooting

Expand All @@ -43,12 +43,24 @@ particular for multipage TIFFs. Use `ImageMagick.libversion` to see what versio
found. If ImageMagick.jl doesn't find a previous installation, it will install its own copy of the
ImageMagick library with Homebrew.jl.

An alternative to ImageMagick on OS X is
[QuartzImageIO](https://github.com/JuliaIO/QuartzImageIO.jl).
ImageMagick.jl 0.3.0 introduced significant improvements in the installation procedure for OSX users.
If you've had trouble with previous versions of ImageMagick.jl and attempted to resolve problems manually,
some of your workarounds might interfere with the new approach. You can reset your build with

```julia
using Homebrew
run(`$brew remove imagemagick@6`)
run(`$brew prune`)

This comment has been minimized.

Copy link
@Allardvm

Allardvm Jun 1, 2017

Contributor

Just a heads-up that my PR's 'reset script' has two erroneous $'s (I fixed this in the PR). It should be:

using Homebrew
run(`brew remove imagemagick@6`)
run(`brew prune`)
Pkg.build("ImageMagick")

According to the Homebrew docs, the following should also work (but I don't have a Mac around to confirm):

using Homebrew
Homebrew.brew(`remove imagemagick@6`)
Homebrew.brew(`prune`)
Pkg.build("ImageMagick")

This comment has been minimized.

Copy link
@timholy

timholy Jun 1, 2017

Author Member

Thanks, will fix.

Pkg.build("ImageMagick")
```

You may also find [debugging
Homebrew](https://github.com/JuliaLang/Homebrew.jl/wiki/Debugging-Homebrew.jl)
useful.
useful.

Finally, an alternative to ImageMagick on OS X is
[QuartzImageIO](https://github.com/JuliaIO/QuartzImageIO.jl).


## Manual installation on Windows

Expand Down

0 comments on commit c776da4

Please sign in to comment.