From 501ad8a273e143f8412aed73f53178ef299081df Mon Sep 17 00:00:00 2001 From: Werner Lemberg Date: Fri, 8 Feb 2019 14:24:12 +0100 Subject: [ttfautohint] Update OS X instructions. In particular, describe MacPorts installation and Cosimo's Homebrew tap. --- ttfautohint/osx.html | 154 +++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 113 insertions(+), 41 deletions(-) diff --git a/ttfautohint/osx.html b/ttfautohint/osx.html index 0fc4ae6..26ab873 100644 --- a/ttfautohint/osx.html +++ b/ttfautohint/osx.html @@ -60,36 +60,81 @@ -
-

Compilation With Homebrew

+
+

Compilation With MacPorts

-

[Homebrew dropped active Qt4 support in - summer 2016; the new option to activate Qt support for the - ttfautohint brew formula is thus no - longer --with-qt but --with-qt5, - similar to other Homebrew packages that use Qt.]

- -

If you have Homebrew and are - comfortable with it, you can install ttfautohint and - ttfautohintGUI (together with libttfautohint) quite +

If you have MacPorts + and are comfortable with it, you can install ttfautohint + (together with libttfautohint) and ttfautohintGUI quite easily.

-

If you need the GUI version of ttfautohint (includes Qt - dependency), use

+

To install the ttfautohint command line executable, open + Terminal.app and type

-brew install ttfautohint --with-qt5
+sudo port install ttfautohint -

to get the currently released version. For the git HEAD - version (i.e., the current development version) use

+

Enter your Mac login password, then press the return key + again. This installs the currently released version.

+ +

You can execute the ttfautohint executable on the command + line with

-brew install --HEAD ttfautohint --with-qt5
+ttfautohint -

instead.

+

followed by an appropriate set of arguments as detailed + in the usage + documentation.

+ +

To install both the ttfautohint command line executable + and the GUI version, use

+ + 
+sudo port install ttfautohint +qt5
+ +

instead of the above installation command. Enter your + Mac login password, then press the return key again. This + installs the currently released version using + the Qt5 framework. If you + want to use the Qt4 framework (for example, if you have a + MacOS version that is not supported by Qt5), + replace +qt5 with +qt4 in the + above command.

+ +

After installation you can now type

+ + 
+ttfautohintGUI
+ +

from the Terminal app to start the GUI.

+
+ + +
+

Compilation With Homebrew

+ +

Warning 1: Since autumn 2018, + Homebrew tries to avoid package options. As a + consequence, I had the choice between ttfautohint or + ttfautohintGUI being part of core Homebrew – I decided to + stay with the former. See below if you need + ttfautohintGUI.

+ +

Warning 2: Homebrew only supports + recent MacOS versions (i.e., the current one and two older + releases). For older MacOS versions please use + MacPorts, see above.

+ +

If you have Homebrew and + are comfortable with it, you can install ttfautohint + (together with libttfautohint) and ttfautohintGUI quite + easily.

+ +

ttfautohint only

If you do not need the GUI version of ttfautohint, you - can install the ttfautohint command line executable only + can install the ttfautohint command line executable with

@@ -103,9 +148,6 @@ brew install --HEAD ttfautohint

instead.

-

Note that you need an up-to-date Homebrew version for - this simple installation.

-

To upgrade ttfautohint from an older version, please follow the standard instructions given in the Homebrew @@ -116,22 +158,10 @@ brew install --HEAD ttfautohint 

 brew reinstall --HEAD ttfautohint
-

or

- - 
-brew reinstall --HEAD ttfautohint --with-qt5
-

instead of calling brew upgrade ttfautohint (cf. this homebrew tracker issue).

-

To start the GUI, you can now type

- - 
-ttfautohintGUI
- -

from the Terminal app.

-

You can execute the ttfautohint executable on the command line with

@@ -141,6 +171,43 @@ ttfautohint

followed by an appropriate set of arguments as detailed in the usage documentation.

+ +

ttfautohint and ttfautohintGUI

+ +

If you need the GUI version of ttfautohint (which depends + on the Qt library), you can't use core Homebrew's version. + Instead, please + use Cosimo + Lupo's Homebrew Tap (i.e., a user's github + repository). Calling

+ + 
+brew install anthrotype/ttfautohint/ttfautohintGUI
+ +

will both install ttfautohint and ttfautohintGUI. For + the git HEAD version (i.e., the current development + version) use

+ + 
+brew install --HEAD anthrotype/ttfautohint/ttfautohintGUI
+ +

instead.

+ +

If you want to switch from core Homebrew to Cosimo's tap, + you should start with

+ + 
+brew uninstall ttfautohint
+ +

before installing from the tap to avoid + interferences.

+ +

After installation you can now type

+ + 
+ttfautohintGUI
+ +

from the Terminal app to start the GUI.

@@ -154,12 +221,14 @@ ttfautohint Simpkins's ttfautohint-build script.

-

If you don't have Homebrew, - you should check it out because it's extremely useful and - automates all ttfautohint build dependency installs for - you. But supposing you don't want to use it, you can - install the command line executable ttfautohint and the - ttfautohint GUI on Mac OS X from scratch.

+

If you don't have Homebrew + or MacPorts, you should + check out one of these two package managers because both + are extremely useful and automate all ttfautohint build + dependency installs for you. But supposing you don't want + to use them, you can install the command line executable + ttfautohint and the ttfautohint GUI on Mac OS X from + scratch.

Following the instructions below, everything except XCode and Qt gets installed into the @@ -424,7 +493,7 @@ ttfautohint Simpkins.

-

Last update: 24-Jul-2018

+

Last update: 8-Feb-2019

@@ -474,6 +543,9 @@ ttfautohint
  • ttfautohint on OS X
    • +
  • + Compilation With MacPorts +
  • Compilation With Homebrew
    • -- cgit v1.2.3