$OpenBSD: README,v 1.5 2011/06/14 21:11:24 edd Exp $

+-----------------------------------------------------------------------
| Running texlive_base-2010p3 on OpenBSD
+-----------------------------------------------------------------------

Texmf Subsets
=============

There are a number of texmf trees in the OpenBSD packages:

texmf-minimal:
  A teTeX like tree, suitable for casual TeX users
  who do not need many extra macros or ConTeXt (approx 302MB).

texmf-full:
  Extra macros and ConTeXt support (approx 163MB).

texmf-doc:
  Documentation for all of TeX Live (approx 760MB).

All sizes are compressed package sizes and the texmf package contents do
not overlap.

User Local Texmf Trees
======================

Individual users may override or add to the TeX class and style files
supplied by TeX Live by installing them into ~/texmf. There is no need
to run mktexlsr(1) for a texmf tree in a user's $HOME. You can test the
installation by searching for the files using kpsewhich(1). Eg:

% find $HOME/texmf
/home/edd/texmf
/home/edd/texmf/tex
/home/edd/texmf/tex/latex
/home/edd/texmf/tex/latex/acronym
/home/edd/texmf/tex/latex/acronym/acronym.sty
% kpsewhich acronym.sty
/home/edd/texmf/tex/latex/acronym/acronym.sty

Upgrade From TeX Live 2009
==========================

Due to inconsistencies in the legacy TeX Live 2009 package, upgrades will
complain about non-empty directories. This is harmless, but can be silenced by
(having backed up anything manually added to texmfs) removing all
TeX Live packages, then `rm -Rf /usr/local/share/texmf*`. Now you can
install afresh the new TeX Live 2010 packages.

Other Misc. Notes
=================

Gmverb
------

Note that gmverb is broken upstream. When I see a fix, it will be fixed.

Tlmgr
-----

The 'tlmgr' script was disabled in the OpenBSD package. This is because
updating TeX Live in this way will upset the package tools due to
differing file checksums.

Soft Dependencies
-----------------

Some requirements of TeX Live were not included as dependencies to make the
package less bloated for people who don't need those features.

As far as I know:

* You should install ruby and ImageMagick if you wish to use ConTeXt.
  Don't forget to link your chosen ruby version to the default as detailed in
  the ruby package's installation message.

* asymptote is in ports: graphics/asymptote

If you know more, please mail the package maintainer: <edd@openbsd.org>

Have fun TeXing.
