Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

mac app bundle README git usage clarification + template.pot version bump #107

Merged
merged 2 commits into from Jul 18, 2017
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
41 changes: 34 additions & 7 deletions mac/README.txt
Expand Up @@ -10,11 +10,17 @@ it is built for the 'vanilla' releases on msp.ucsd.edu.
* tcltk-wish.sh: downloads and builds a Tcl/Tk Wish.app for macOS

These scripts complement the autotools build system described in INSTALL.txt and
are meant to be run after Pd is configured and built. Both osx-app.sh &
tcltck-wish.sh have extensive help output using the --help commandline option:
are meant to be run after Pd is configured and built. The following usage, for
example, downloads and builds a 32bit Tk 8.6.6 Wish.app which is used to create
a macOS Pd-0.47.1.app:

mac/tcltk-wish.sh --arch i386 8.6.6
mac/osx-app.sh --wish Wish-8.6.6.app 0.47.1

Both osx-app.sh & tcltck-wish.sh have extensive help output using the --help
commandline option:

mac/osx-app.sh --help
...
mac/tcltk-wish.sh --help

In a nutshell, a monolithic macOS "application" is simply a directory structure
Expand Down Expand Up @@ -65,21 +71,42 @@ it to your system, you can build Tcl/Tk as embedded frameworks inside of the Pd
.app bundle. This has the advantage of portability to other systems.

The tcltk-wish.sh script automates building a Wish.app with embedded Tcl/Tk,
either from the release distributions or from a git clone. You can also specify
which architectures to build: 32 bit, 64 bit, or both. Once your custom Wish.app
is built, you can use it as the .app source for osx-app.sh with the -w option:
either from the release distributions or from a git clone:

# build Wish-8.6.6.app with embedded Tcl/Tk 8.6.6
mac/tcltk-wish.sh 8.6.6

# build Pd with the custom donor Wish
# build Wish-master-git.app from the latest Tcl/Tk master branch from git
tcltk-wish.sh --git master-git

You can also specify which architectures to build (32 bit, 64 bit, or both):

# build 32bit Wish-8.6.6.app with embedded Tcl/Tk 8.6.6
tcltk-wish.sh --arch i386 8.6.6

# build universal (32 & 64 bit)
tcltk-wish.sh --universal 8.6.6

Once your custom Wish.app is built, you can use it as the .app source for
osx-app.sh with the -w option:

# build Pd with a custom Tcl/Tk 8.6.6 Wish
mac/osx-app.sh -w Wish-8.6.6.app

Downloading and building Tcl/Tk takes some time. If you are doing lots of builds
of Pd and/or are experimenting with different versions of Tcl/Tk, building the
embedded Wish.apps you need with tcltk-wish.sh can save you some time as they
can be reused when (re)making the Pd .app bundle.

Usually, it's best to use stable releases of Tcl/Tk. However, there are times
when building from the current development version is useful. For instance,
if there is a bug in the Tcl/Tk sources and the generated Wish.app crashes on
your system, you can then see if there is a fix for this in the Tcl/Tk
development version on GitHub. If so, then you can test by using the
tcltk-wish.app --git commandline option. Oftentimes, these kinds of issues will
appear with a newer version of macOS before they have been fixed by the open
source community.

## Supplementary Build Scripts

* build-macosx: builds a 32 bit Pd .app bundle using src/makefile.mac
Expand Down
7 changes: 5 additions & 2 deletions mac/tcltk-wish.sh
Expand Up @@ -51,9 +51,12 @@ Examples:
# build Wish-8.5.19.app with embedded Tcl/Tk 8.5.19
tcltk-wish.sh 8.5.19

# build Wish-8.6.5.app with embedded Tcl/Tk 8.6.5
# build 32bit Wish-8.6.6.app with embedded Tcl/Tk 8.6.6
tcltk-wish.sh --arch i386 8.6.6

# build Wish-8.6.6.app with embedded Tcl/Tk 8.6.6
# and universal archs
tcltk-wish.sh --universal 8.6.5
tcltk-wish.sh --universal 8.6.6

# build Wish-master-git.app with the latest master branch from git
tcltk-wish.sh --git master-git
Expand Down
2 changes: 1 addition & 1 deletion po/template.pot
Expand Up @@ -5,7 +5,7 @@
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Pure Data 0.47.1\n"
"Project-Id-Version: Pure Data 0.48.0\n"
"Report-Msgid-Bugs-To: pd-dev@iem.at\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
Expand Down