1.Verify the TeXmacs dependencies

Before you install TeXmacs on your system, you have to make sure that the other programs on which TeXmacs depends, namely TeX and Guile/Scheme (from the Gnome project) have been installed correctly. You can do this by checking whether the latex and guile-config binaries exists in your path

    which latex
    which guile-config

If one of these commands yields an error message, then click here. On some systems, you also need to make sure that you installed the development packages (i.e. X11-dev or X11-devel) for Xlib.

2.Download and unpack the source code

Download the latest version (3.8 Mb) of the source code, or the latest stable version (3.8 Mb), cd into the directory where you wish to compile TeXmacs and type

    tar -zxvf TeXmacs-1.0.7.2-src.tar.gz

All files will be unpacked into the directory TeXmacs-1.0.7.2-src, which is the 'installation directory'. If you do not have ftp access, then you might wish to download from the web.

3.Compile, install and run

TeXmacs supports the standard GNU compilation and installation procedure. Assuming that you logged yourself in as root, cd into the installation directory and type

    ./configure
    make
    make install

The first command examines your particular system configuration. The second command launches the compilation. The last command installs TeXmacs in /usr/local.

If everything works fine, you should be able to run TeXmacs by

    texmacs &

If this does not work, you should make sure that /usr/local/bin is in your PATH. Depending on your shell, you can ensure this by typing

    export PATH=/usr/local/bin:$PATH   or
    setenv PATH /usr/local/bin:$PATH

If you are interested by packaging TeXmacs for some Linux or Unix distribution, then please take a look at our suggestions.

4.Extra fonts?

You may optionally download a tarball (5.8 Mb) with extra Type 1 fonts. These fonts should be unpacked in the directory ~/.TeXmacs (which you should create if it does not already exist) using

    gunzip -c TeXmacs-extra-fonts-1.0-noarch.tar.gz | tar xvf -

Although TeXmacs is able to automatically generate bitmap analogues for the extra fonts, this process may take some time at a first run. Type 1 fonts are also rendered better by certain Pdf viewers and they are often preferred by publishers.

Chinese, Japanese and Korean users also need to separately download extra CJK fonts, whenever these languages do not correctly show up in the language menus.

5.Be cool...

Please let us know if you like or dislike the program. It is very useful for us to have a rough idea about the number of permanent users and for what applications you are interested in TeXmacs. Furthermore, we are glad to receive your suggestions and problems, no matter how silly they may seem to you. You may also subscribe to the texmacs-users or texmacs-info mailing lists. If you really like the program, then please consider donating money or services to us. Of course, you may also contribute yourself.

Appendix A.Configuration options

If you cannot log yourself in as root, or if you want to install TeXmacs elsewhere than in /usr/local, then you should use

    ./configure --prefix=[target directory]

instead of ./configure. In this case, TeXmacs will be installed in [target directory] and you will have to set your PATH accordingly, as to contain [target directory]/bin. Other options supported by configure are

• –bindir=[binary directory]: sets the directory where the TeXmacs binaries should be installed ([target directory]/bin, by default).
• –datadir=[data directory]: sets the directory where other TeXmacs data should be installed. ([target directory]/share, by default).

Appendix B.Static compilation

By default, we build TeXmacs using dynamically linked libraries. If you rather want to build the static version, use

    make STATIC_TEXMACS

Appendix C.Possible problems

• Everything compiles fine, but you frequently get a segmentation fault when running the editor.

  Solution: This problem may have several causes:

  • You don't use a standard version of the GNU C++ compiler. We use gcc-2.95.3 on a GNU/Linux system on a PC. More recent versions (3.3.*, 3.4.*, 4.*, etc.) of g++ should work as well. Some versions don't support optimization, in which case you should configure using the –disable-optimize option.
  • You are compiling TeXmacs on a not yet supported system. Please take a look at configure.in in order to see whether your system is supported. If not, try to add a new entry for your system.

• You use Cygwin and you do not manage to get Guile working.

  Solution: There may be a problem with the file name ice-9/and-let*.scm (stars are not allowed in file names), which should be renamed as ice-9/and-let-star.scm. You should make the corresponding modifications in ice-9/Makefile.in. Since you might be unable to extract ice-9/and-let*.scm from the archive, you can find a copy of it (for guile-1.4) here.

• You have problems with compiling or linking with X Window.

  Solution: modify some of the compilation options in configure.in.

• If you encounter other problems, or if our fixes don't work, then please contact us.