update 1.2.0 release notes

Author: mitchellh

docs/install/release-notes/1-2-0.mdx

@@ -4,4 +4,198 @@ description: |-
   Release notes for Ghostty 1.2.0, presently unreleased.
 ---
 
-Coming soon.
+<Note>
+  This page is still a **work-in-progress.** 1.2.0 is still unreleased and this
+  page is missing a lot of content. We're slowly filling in the blanks as we
+  near the release.
+</Note>
+
+Ghostty 1.2.0 features **6 months of work** with changes from
+**142 contributors** over **2,520 commits**. This release contains major
+improvements to every part of Ghostty, including hundreds of bug fixes.
+
+## Highlights
+
+Potential list:
+
+- terminal background image GH-3645
+- quick terminal on linux GH-4624
+- quick terminal size GH-2384
+- linux bell features GH-5326
+- linux localization
+
+## Breaking Changes
+
+- GTK: libadwaita is now required. We've
+  [warned that this was coming](/docs/install/release-notes/1-1-0#gtk:-forcing-a-dependency-on-libadwaita)
+  since the 1.1.0 release notes and our motivations are well explained in
+  the prior link. Please read that carefully before reacting! We put out a
+  call for feedback from the community and discussed this decision at length.
+  We shipped features addressing those concerns such as our SSD support, first
+  class CSS styling, and more.
+
+### Deprecations
+
+The list below contains deprecations that will be removed in the future,
+but remain compatible today:
+
+- `selection-invert-fg-bg` should be replaced with
+  `selection-foreground=cell-background` and
+  `selection-background=cell-foreground`. GH-5219
+- `cursor-invert-fg-bg` should be replaced with
+  `cursor-color=cell-foreground` and
+  `cursor-text=cell-background`. GH-5219
+
+## Full Changelog
+
+[Full list of closed issues on GitHub](https://github.com/ghostty-org/ghostty/milestone/5?closed=1).
+
+In each section, we try to sort improvements before bug fixes.
+
+- Add a new keybind `prompt_title` that can be used to change
+  the title of a terminal manually. GH-2509 GH-5769
+- config: copy on right click with `right-click-action = copy`. GH-4404
+- config: `background-image` can be used to set a background image for
+  the terminal. This currently applies to each terminal, not to windows.
+  GH-3645
+- config: `env` can be used to specify environment variables to set
+  in the terminal environment. GH-5257
+- config: `quick-terminal-size` can be used to customize the
+  size of the quick terminal. GH-2384
+- config: `font-shaping-break` configures when a ligature should be
+  broken (split). GH-4515
+- config: new values `cell-foreground` and `cell-background` can be used
+  with `selection-foreground`, `selection-background`, and `cursor-color`
+  to set their color values to the dynamic cell colors. GH-5219
+- cli: pressing `enter` in `+list-themes` now shows help text on
+  how to configure the theme. GH-4731
+- holding the mouse above or below the window while clicking now
+  scrolls the viewport without having to jiggle the mouse. GH-4422
+- Resolve issue when pressing `backspace` with preedit text (such as
+  when using an IME). GH-5728
+- config: `keybind=` (blank) restores default keybindings, behaving
+  like other `<key>=` blank values. GH-5936
+- config: `palette` configuration now supporst whitespace between
+  the palette number and color. GH-5921
+- config: All configurations that take a list of colors (e.g.
+  `macos-icon-ghost-color`) support spaces after commas. GH-5918
+- font: U+25E4 and U+25E2 (geometric shapes) are now rasterized
+  with the built-in sprite font. GH-3344
+- vt: Kitty image protocol supports delete by range operations. GH-5957
+- vt: `ctrl+esc` now produces the proper Kitty keyboard encoding. GH-7000
+- vt: clear correct row on index (`\n`) operation in certain edge cases.
+  This fixes a misrender that could happen with the vim status line
+  in certain scenarios. GH-7093
+- vt: clicking on an unfocused window no longer encodes a mouse event. GH-2595
+
+### macOS
+
+- macOS: Add `bring_all_to_front` keybind action to bring all
+  Ghostty windows to the front. GH-4704
+- macOS: Add `reset_window_size` keybind action to reset the window
+  size to its initial configured size. GH-6038
+- macOS: Add "Return to Default Size" menu item. GH-1328
+- macOS: `macos-hidden` configuration will hide Ghostty from the
+  dock and tab menu. GH-4538
+- macOS: Clicking links now uses the `NSWorkspace` API rather than
+  the `open` command. This preserves the source application (Ghostty)
+  which other programs can now use to change their behavior if
+  desired. GH-5256
+- macOS: New option `padded-notch` for the existing `macos-non-native-fullscreen`
+  configuration to put the non-native fullscreen window below the notch
+  but still hide the menu bar. GH-5750
+- macOS: `Cmd+h` (macOS hide window) no longer sends `h` if attempting to
+  hide the last visible window. GH-5929
+- macOS: `maximize` configuration now works on macOS. GH-5928
+- macOS: Title text is vertically centered with `macos-titlebar-style=tabs`.
+  GH-5777
+- macOS: focus no longer goes to the first split when toggling
+  non-native fullscreen. GH-6999
+- macOS: the `close_window` keybind action now works. GH-7003
+- macOS: quick terminal can appear and disappear more reliably
+  on fullscreen spaces. GH-7070
+- macOS: selection off the left edge of the window no longer
+  scrolls up by one line. GH-7071
+- macOS: All split directions are now available in the menubar and
+  context menus. GH-5807
+- macOS: Invoking `new_tab` in anyway within the quick terminal now
+  shows a helpful error rather than creating a new window. Tabs in the
+  quick terminal will be supported in a future release. GH-5939
+- man pages now mention macOS-specific configuration path. GH-5938
+
+### GTK (Linux, FreeBSD)
+
+- GTK: The quick terminal now works on Linux under Wayland and the
+  `wlr-layer-shell` protocol. GH-4624
+- GTK: Audio bell support (default off) can be enabled with
+  `bell-features=audio` and setting `bell-audio-path` and
+  `bell-audio-volume`. GH-5326
+- GTK: Dynamically choose between `io_uring` and `epoll` for the
+  async API on Linux. Previously, this was hardcoded to `io_uring`
+  and epoll-only systems had to build from source. GH-5916
+- GTK: New config `async-backend` can be set to `epoll` to force using
+  epoll instead of io_uring on Linux. This can be useful on kernels where
+  iowait reporting is broken. GH-5916
+- GTK: New config `window-show-tab-bar` customizes when the tab bar
+  is visible. GH-5590
+- GTK: `copy-on-select=clipboard` no longer causes toast spam while
+  selecting. The copy only happens when the mouse is released. GH-4800
+- GTK: All split directions are now available in the menubar and
+  context menus. GH-5779
+- GTK: Fix an issue where the window would sometimes become blank
+  and not close after the last tab was closd. GH-5837
+- GTK: Resize overlay now uses language-neutral `w x h` format
+  and omits units. GH-6013
+- packaging: experimental snap packaging is now tested in CI. The
+  published snap image is maintained by an external maintainer for now.
+  GH-3931
+
+### Changes for Package Maintainers
+
+TODO
+
+## Roadmap
+
+Ghostty 1.3 will continue the focus of making Ghostty the
+["best existing terminal emulator"](https://mitchellh.com/writing/ghostty-1-0-reflection)
+by shipping the last remaining major missing features to achieve
+parity with other popular terminal emulators. Namely, we plan on shipping
+scrollback search and scrollbars for 1.3, at a minimum.[^1]
+
+The primary focus of Ghostty 1.3 will be on desktop application features
+(of which scrollback search and scrollbars are a part). The core terminal
+emulation features of Ghostty have already proven to be very feature
+rich and stable. However, we plan on continuing to expand our VT feature
+support, such as adopting new experimental protocols that have been recently
+released into the ecosystem by others.
+
+To answer common requests, **Windows** and **libghostty as a
+standalone library** are not planned for Ghostty 1.3. These remain part
+of the long term roadmap, but we want to focus on our existing platforms
+and desktop applications first.
+
+### Moving to a March/September Release Cycle
+
+Ghostty will move to a 6-month release cycle for major/minor releases,
+with the next minor release (1.3.0) planned for March 2026. A March/September
+release cycle aligns well with many major Linux distibutions and macOS.
+Patch releases (e.g. 1.2.1) will be made as needed on an unscheduled basis.
+
+This is a relatively long release cycle for modern applications, but
+let's the development team focus on large, impactful features with enough
+time to stabilize in tip releases. For packagers, it avoids the churn of
+packaging new releases frequently. And the alignment with major OS releases
+let's us ensure we ship major releases that work well on new OS versions.
+
+For users who are interested in more frequent updates, we recommend using
+the [`tip` release channel](/docs/config/reference#auto-update-channel) on macOS or
+[building from source](/docs/install/release-notes/1-1-0#roadmap) frequently on Linux.
+We have thousands of nightly users (thank you for testing!) and the entire
+maintainer team works hard to keep tip releases stable. For the entire 1.1
+to 1.2 development cycle, I can't remember tip releases ever being broken
+for daily use.
+
+[^1]:
+    "Parity" here is used loosely to describe the most popular, frequently
+    used features of other terminal emulators. There is a long tail of features
+    we'll likely never fully implement (and vice versa for our features).