~ubuntu-branches/ubuntu/wily/julia/wily

« back to all changes in this revision

Viewing changes to README.md

  • Committer: Package Import Robot
  • Author(s): Sébastien Villemot
  • Date: 2013-11-17 19:32:52 UTC
  • mfrom: (1.1.12)
  • Revision ID: package-import@ubuntu.com-20131117193252-tkrpclguqqebqa35
Tags: 0.2.0+dfsg-3
testsuite-i386.patch: loosen the numerical precision for yet another test.

Show diffs side-by-side

added added

removed removed

Lines of Context:
60
60
 
61
61
**Note:** the build process will not work if any of the build directory's parent directories have spaces in their names (this is due to a limitation in GNU make).
62
62
 
63
 
Once it is built, you can either run the `julia` executable using its full path in the directory created above, or add that directory to your executable path so that you can run the Julia program from anywhere (in the current shell session):
64
 
 
65
 
In bash:
66
 
 
67
 
    export PATH="$(pwd):$PATH"
68
 
    
69
 
In csh / tcsh:
70
 
 
71
 
    set path= ( $path $cwd )
 
63
Once it is built, you can run the `julia` executable using its full path in the directory created above (the `julia` directory), or, to run it from anywhere,
 
64
 
 
65
1. add a soft link to the `julia` executable in the `julia` directory to `/usr/local/bin` (or any suitable directory already in your path), or
 
66
 
 
67
2. add the `julia` directory to your executable path for this shell session (in bash: `export PATH="$(pwd):$PATH"` ; in csh or tcsh:
 
68
`set path= ( $path $cwd )` ), or
 
69
 
 
70
3. add the `julia` directory to your executable path permanently (eg in `.bash_profile`).
72
71
 
73
72
Now you should be able to run Julia like this:
74
73
 
75
 
    julia
76
 
 
77
 
If everything works correctly, you will see a Julia banner and an interactive prompt into which you can enter expressions for evaluation.
 
74
    `julia`
 
75
 
 
76
If everything works correctly, you will see a Julia banner and an interactive prompt into which you can enter expressions for evaluation. (Errors related to libraries might be caused by old, incompatible libraries sitting around in your PATH. In that case, try moving the `julia` directory earlier in the PATH).
 
77
 
78
78
You can read about [getting started](http://julialang.org/manual/getting-started) in the manual.
79
79
 
 
80
If you are building a Julia package for distribution on Linux, OS X,
 
81
or Windows, take a look at the detailed notes in
 
82
[DISTRIBUTING.md](https://github.com/JuliaLang/julia/blob/master/DISTRIBUTING.md).
 
83
 
80
84
<a name="Uninstalling-Julia"/>
81
85
## Uninstalling Julia
82
86
 
124
128
### OS X
125
129
 
126
130
It is essential to use a 64-bit gfortran to compile Julia dependencies. The gfortran-4.7 (and newer) compilers in brew and macports work for building Julia. If you do not use brew or macports, you can download and install [gfortran and gcc from hpc.sf.net](http://hpc.sf.net/). The HPC gfortran requires HPC gcc to be installed to function properly. 
127
 
 
128
 
Clang is now used by default to build Julia on OS X (10.7 and above). Make sure to update to at least Xcode 4.3.3, and update to the latest command line tools from the Xcode preferences. This will ensure that clang v3.1 is installed, which is the minimum version of clang required to build Julia. On OS X 10.6, the Julia build will automatically use gcc.
 
131
Clang is now used by default to build Julia on OS X (10.7 and above). It is recommended that you upgrade to the latest version of Xcode (at least 4.3.3.). You need to have the Xcode command line utlities installed (and updated): run `xcode-select --install` in the terminal (in Xcode prior to v5.0, you can alternatively go to Preferences -> Downloads and select the Command Line Utilities). This will ensure that clang v3.1 is installed, which is the minimum version of clang required to build Julia. On OS X 10.6, the Julia build will automatically use gcc.
129
132
 
130
133
If you have set `LD_LIBRARY_PATH` or `DYLD_LIBRARY_PATH` in your .bashrc or equivalent, Julia may be unable to find various libraries that come bundled with it. These environment variables need to be unset for Julia to work.
131
134