#-------------------------------------------------------------------------
# File: HomebrewUser-ReadMeFirst.txt
#                              in macbuild/Resources/script-bundle-B.zip
#
# Last modified: 2020-09-13
#-------------------------------------------------------------------------

This folder contains the "KLayoutHomebrew.app" script bundle and some sample icon files.


[1] Homebrew setup
    First of all, to use this package, you need to set up the Homebrew environment.
    At least, you have to install Qt5, Python, and Ruby package:
        % brew install qt5
        % brew install python
        % brew install ruby

    The main reason you chose this package would be to use KLayout's PYA in Python 3.x.
    The attached file "HomebrewPythonPip.txt" has captured the steps I followed to add some
    Python modules using the "pip" command.


[2] 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 be 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

[3] 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]
