#-------------------------------------------------------------------------
# File: ReadMe.txt in macbuild/Resources/script-bundles.zip
#
# Last modified: 2020-05-23
#-------------------------------------------------------------------------

This directory contains four simple script bundles (*.app) generated by
using the macOS "Automator.app" tool and four associated icon files.

Since each script bundle consists of a simple Bash script, you may able to edit it
as you like knowing the following pieces of information.

[1] KLayoutEditor.app
    This script bundle invokes the standard "/Applications/klayout.app" in the EDITOR mode.
    KLayout's configuration file is "$HOME/.klayout/klayoutrc," which is the default.
    You can invoke multiple instances of KLayout using this script bundle.

[2] KLayoutViewer.app
    This script bundle invokes the standard "/Applications/klayout.app" in the VIEWER mode.
    KLayout's configuration file is "$HOME/.klayout/klayoutrc," which is the default.
    You can invoke multiple instances of KLayout using this script bundle.

[3] KLayoutAna3.app
    This bundle is for those who have the Anaconda3 environment under /Applications/anaconda3.
    Optionally, drag and drop this bundle to /Applications folder, too.
    As the bundle consists of a simple Bash script, you may able to edit it as you like
    with the help of "Automator.app."

    The standard installation deploys the Anaconda3 under $HOME/opt/anaconda3/.
    Therefore you need to make a symbolic link: /Applications/anaconda3 ---> $HOME/opt/anaconda3/
    The built-in Bash script sets and exports "PYTHONHOME" environment variable, then invokes
    "/Applications/klayout.app" in the EDITOR mode.
    KLayout's configuration file is "$HOME/.klayout/klayoutrc."
    You can invoke multiple instances of KLayout using this script bundle.

    If you wish to make this package coexist with the standard one (Qt5 Frameworks embedded)
    that uses the OS-bundled Ruby and Python (2.7.x),
      1) Rename "/Applications/klayout.app" to "/Applications/klayout-ana3.app"
      2) Edit this script using "Automator.app"
              # myklayout=/Applications/klayout.app (comment out)
              # myconfig=$HOME/.klayout/klayoutrc (comment out)
                |
                |
                V
              myklayout=/Applications/klayout-ana3.app
              myconfig=$HOME/.klayout/klayoutrc-ana3

[4] KLayoutHomebrew.app
    This bundle is for those who have the Homebrew environment under /usr/local/opt/.
    Optionally, drag and drop this bundle to /Applications folder, too.
    As the bundle consists of a simple Bash script, you may able to edit it as you like
    with the help of "Automator.app."

    "KLayoutHomebrew.app" invokes "/Applications/klayout.app" in the EDITOR mode.
    KLayout's configuration file is "$HOME/.klayout/klayoutrc."
    You can invoke multiple instances of KLayout using this script bundle.

    If you wish to make this package coexist with the standard one (Qt5 Frameworks embedded)
    that uses the OS-bundled Ruby and Python (2.7.x),
      1) Rename "/Applications/klayout.app" to "/Applications/klayout-HB.app"
      2) Edit this script using "Automator.app"
              # myklayout=/Applications/klayout.app (comment out)
              # myconfig=$HOME/.klayout/klayoutrc (comment out)
                |
                |
                V
              myklayout=/Applications/klayout-HB.app
              myconfig=$HOME/.klayout/klayoutrc-HB

[5] Application Icons
    You can change the application icon of a script bundle using "Finder."
      1) Right-click a script bundle "*.app" and "Get info."
      2) Click the default "robot icon" at the top-left, then it is highlighted.
      3) Drag and drop any icon onto the "robot icon."

[EOF]
