BLUEFISH 2.4.2 - UNIVERSAL BUILD (TEST VERSION)
=================================================

This is a custom-built, universal version of the Bluefish text
editor (v2.4.2), meaning it runs natively on both:

  - Apple Silicon Macs (M1/M2/M3/M4, etc.)
  - Intel Macs

This is a personal/community build, not an official release, so
macOS will show a security warning the first time you open it.
This is expected - here's how to get past it.


HOW TO OPEN IT
--------------

IMPORTANT: Unzip the file and MOVE Bluefish-Universal.app to your
local disk (e.g. drag it into Applications or your Desktop) BEFORE
opening it. Do not run it directly from a mounted disk image,
external drive, or network share - this can cause it to quit
instantly with no warning, even though nothing is actually wrong
with the app.

macOS blocks apps downloaded from outside the App Store by default
unless they're signed by a registered Apple Developer. Since this is
a self-built app, you'll need to manually allow it once.

Option A - System Settings (easiest, no Terminal needed)

  1. Make sure Bluefish-Universal.app has been moved to your local
     disk (see above).
  2. Double-click it to try opening it. You'll get a warning that
     it can't be opened.
  3. Go to System Settings > Privacy & Security.
  4. Scroll down - you'll see a message saying "Bluefish-Universal"
     was blocked to protect your Mac.
  5. Click Open Anyway, then confirm with your password or Touch ID.
  6. It should now open normally from then on.

Option B - Terminal (if Option A doesn't work, or the app quits
instantly with no warning)

  Make sure the app is on your local disk first (see IMPORTANT
  note above), then open Terminal and run:

    xattr -cr /path/to/Bluefish-Universal.app

  (Replace /path/to/ with wherever you saved the app - e.g.
  ~/Applications/Bluefish-Universal.app or
  /Applications/Bluefish-Universal.app.)

  Then try opening it again.


WHAT TO TEST
------------

  - General editing - typing, saving, opening files
  - Syntax highlighting for a few languages (HTML, CSS, PHP, etc.)
  - Spellcheck (if enabled)
  - Opening/inserting images, including SVGs
  - Any toolbar/menu features you'd normally use


KNOWN LIMITATIONS
------------------

  - This build is ad-hoc signed, not signed with a paid Apple
    Developer certificate - the security warning above is expected
    and not a sign of a problem with the app itself.
  - If the app quits unexpectedly with no warning dialog at all
    (rather than a clear "blocked" message), first make sure it has
    been moved to your local disk and is not being run from a
    mounted disk image, external drive, or network share - this is
    the most common cause of a silent crash. If it still happens
    after moving it locally, try Option B above.


FEEDBACK
--------

If you run into anything odd - crashes, missing icons, spellcheck
not working, etc. - please note:

  - What you were doing when it happened
  - Whether you're on Apple Silicon or Intel
  - Your macOS version (Apple menu > About This Mac)

Thanks for testing!
