From 573fe7348b1a57a740a0aaeec7b39e87a2199bc1 Mon Sep 17 00:00:00 2001 From: taylrfnt Date: Sat, 22 Feb 2025 17:46:30 -0600 Subject: [PATCH 1/3] add macos default config path to manpages --- src/build/mdgen/ghostty_1_footer.md | 8 ++++++++ src/build/mdgen/ghostty_5_footer.md | 8 ++++++++ src/build/mdgen/ghostty_5_header.md | 5 +++++ 3 files changed, 21 insertions(+) diff --git a/src/build/mdgen/ghostty_1_footer.md b/src/build/mdgen/ghostty_1_footer.md index 86a8a8098..bd261a68b 100644 --- a/src/build/mdgen/ghostty_1_footer.md +++ b/src/build/mdgen/ghostty_1_footer.md @@ -4,6 +4,10 @@ _\$XDG_CONFIG_HOME/ghostty/config_ : Location of the default configuration file. +_\$HOME/Library/Application Support/com.mitchellh.ghostty/config_ + +: **On macOS**, location of the default configuration file. + _\$LOCALAPPDATA/ghostty/config_ : **On Windows**, if _\$XDG_CONFIG_HOME_ is not set, _\$LOCALAPPDATA_ will be searched @@ -23,6 +27,10 @@ for configuration files. : Default location for configuration files. +**$HOME/Library/Application Support/com.mitchellh.ghostty** + +: **MACOS ONLY** default location for configuration files. + **LOCALAPPDATA** : **WINDOWS ONLY:** alternate location to search for configuration files. diff --git a/src/build/mdgen/ghostty_5_footer.md b/src/build/mdgen/ghostty_5_footer.md index 0c893dd07..cdf126b81 100644 --- a/src/build/mdgen/ghostty_5_footer.md +++ b/src/build/mdgen/ghostty_5_footer.md @@ -4,6 +4,10 @@ _\$XDG_CONFIG_HOME/ghostty/config_ : Location of the default configuration file. +_\$HOME/Library/Application Support/com.mitchellh.ghostty/config_ + +: **On macOS**, location of the default configuration file. + _\$LOCALAPPDATA/ghostty/config_ : **On Windows**, if _\$XDG_CONFIG_HOME_ is not set, _\$LOCALAPPDATA_ will be searched @@ -15,6 +19,10 @@ for configuration files. : Default location for configuration files. +**$HOME/Library/Application Support/com.mitchellh.ghostty** + +: **MACOS ONLY** default location for configuration files. + **LOCALAPPDATA** : **WINDOWS ONLY:** alternate location to search for configuration files. diff --git a/src/build/mdgen/ghostty_5_header.md b/src/build/mdgen/ghostty_5_header.md index aac6c17ea..078133861 100644 --- a/src/build/mdgen/ghostty_5_header.md +++ b/src/build/mdgen/ghostty_5_header.md @@ -11,6 +11,11 @@ is on the roadmap but not yet supported. The configuration file must be placed at `$XDG_CONFIG_HOME/ghostty/config`, which defaults to `~/.config/ghostty/config` if the [XDG environment is not set](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html). +**If you are using macOS, the configuration file can also be placed at +`$HOME/Library/Application Support/com.mitchellh.ghostty/config`.** This is the +default configuration location for macOS. It will be searched before any of the +XDG environment locations listed above. + The file format is documented below as an example: # The syntax is "key = value". The whitespace around the equals doesn't matter. From eec150d4cdc7e473bca256f64a989cb84c8b2401 Mon Sep 17 00:00:00 2001 From: taylrfnt Date: Sat, 22 Feb 2025 17:58:05 -0600 Subject: [PATCH 2/3] mention default loc precendence over XDG --- src/build/mdgen/ghostty_1_footer.md | 3 ++- src/build/mdgen/ghostty_5_footer.md | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/src/build/mdgen/ghostty_1_footer.md b/src/build/mdgen/ghostty_1_footer.md index bd261a68b..a0516b4c2 100644 --- a/src/build/mdgen/ghostty_1_footer.md +++ b/src/build/mdgen/ghostty_1_footer.md @@ -6,7 +6,8 @@ _\$XDG_CONFIG_HOME/ghostty/config_ _\$HOME/Library/Application Support/com.mitchellh.ghostty/config_ -: **On macOS**, location of the default configuration file. +: **On macOS**, location of the default configuration file. This location takes +precedence over the XDG environment locations. _\$LOCALAPPDATA/ghostty/config_ diff --git a/src/build/mdgen/ghostty_5_footer.md b/src/build/mdgen/ghostty_5_footer.md index cdf126b81..d94ef9b55 100644 --- a/src/build/mdgen/ghostty_5_footer.md +++ b/src/build/mdgen/ghostty_5_footer.md @@ -6,7 +6,8 @@ _\$XDG_CONFIG_HOME/ghostty/config_ _\$HOME/Library/Application Support/com.mitchellh.ghostty/config_ -: **On macOS**, location of the default configuration file. +: **On macOS**, location of the default configuration file. This location takes +precedence over the XDG environment locations. _\$LOCALAPPDATA/ghostty/config_ From 398add17f11758c541e575360e024cdb0f33a053 Mon Sep 17 00:00:00 2001 From: taylrfnt Date: Sat, 22 Feb 2025 18:00:37 -0600 Subject: [PATCH 3/3] actually change it in both places --- src/build/mdgen/ghostty_1_footer.md | 3 ++- src/build/mdgen/ghostty_5_footer.md | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/src/build/mdgen/ghostty_1_footer.md b/src/build/mdgen/ghostty_1_footer.md index a0516b4c2..7ace64cd8 100644 --- a/src/build/mdgen/ghostty_1_footer.md +++ b/src/build/mdgen/ghostty_1_footer.md @@ -30,7 +30,8 @@ for configuration files. **$HOME/Library/Application Support/com.mitchellh.ghostty** -: **MACOS ONLY** default location for configuration files. +: **MACOS ONLY** default location for configuration files. This location takes +precedence over the XDG environment locations. **LOCALAPPDATA** diff --git a/src/build/mdgen/ghostty_5_footer.md b/src/build/mdgen/ghostty_5_footer.md index d94ef9b55..c5077ab97 100644 --- a/src/build/mdgen/ghostty_5_footer.md +++ b/src/build/mdgen/ghostty_5_footer.md @@ -22,7 +22,8 @@ for configuration files. **$HOME/Library/Application Support/com.mitchellh.ghostty** -: **MACOS ONLY** default location for configuration files. +: **MACOS ONLY** default location for configuration files. This location takes +precedence over the XDG environment locations. **LOCALAPPDATA**