From 747039e1cdfbe37418953189bc80b336d3560620 Mon Sep 17 00:00:00 2001 From: Jim Grisham Date: Mon, 23 Aug 2021 21:33:06 -0700 Subject: [PATCH 1/6] Update Info.plist.in Updated LSMinimumSystemVersion to prevent launch on unsupported macOS versions. Release notes for 2.3.0[1] state that macOS 10.12 is the minimum - this has not been verified in the code, however. [1] https://github.com/debauchee/barrier/releases/tag/v2.3.0 --- dist/macos/bundle/Barrier.app/Contents/Info.plist.in | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dist/macos/bundle/Barrier.app/Contents/Info.plist.in b/dist/macos/bundle/Barrier.app/Contents/Info.plist.in index 40e0b3d8..3f1c968a 100644 --- a/dist/macos/bundle/Barrier.app/Contents/Info.plist.in +++ b/dist/macos/bundle/Barrier.app/Contents/Info.plist.in @@ -31,6 +31,6 @@ NSHumanReadableCopyright © 2018 Debauchee Open Source Group LSMinimumSystemVersion - 10.9.0 + 10.12.0 From feb30fafcb49fcd2e5121972eec3389ef7bddb1a Mon Sep 17 00:00:00 2001 From: Jim Grisham Date: Mon, 23 Aug 2021 22:39:00 -0700 Subject: [PATCH 2/6] Update README.md Updated OS support section, based in the discussion from issue #544. (Also cleaned up code formatting in FAQ section) --- README.md | 58 +++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 39 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 3ec09b62..dfdd5322 100644 --- a/README.md +++ b/README.md @@ -82,32 +82,52 @@ specific packages. [![Packaging status](https://repology.org/badge/vertical-allrepos/barrier.svg)](https://repology.org/project/barrier/versions) -### FAQ +## FAQ - Frequently Asked Questions -Q: Does drag and drop work on linux? +**Q: Does drag and drop work on linux?** -A: No +> A: No *(see [#855](https://github.com/debauchee/barrier/issues/544) if you'd like to change that)* -Q: What OSes are supported? -A: - - Windows 7, 8, 8.1, and 10 - - MacOS/OS X - - Linux - - FreeBSD - - OpenBSD +**Q: What OSes are supported?** -Q: Are 32-bit versions of Windows supported? +> A: The most recent release of Barrier is known to work on: +> - Windows 7, 8, 8.1, and 10 +> - macOS *(previously known as OS X or Mac OS X)* +> - _The current GUI does **not** work on OS versions prior to macOS 10.12 Sierra (but see the related answer below)_ +> - Linux +> - FreeBSD +> - OpenBSD -A: No -Q: How do I load my configuration on startup? +**Q: Are 32-bit versions of Windows supported?** -A: Start the binary with the argument `--config ` +> A: No -Q: After loading my configuration on the client the field 'Server IP' is still empty! -A: Edit your configuration to include the servers ip adress manually with - (...) - section: options - serverhostname= +__Q: Is it possible to use Barrier on Mac OS X / OS X versions prior to 10.12?__ + +> A: Not officially. +> - For OS X 10.10 Yosemite and later: +> - [Barrier v2.1.0](https://github.com/debauchee/barrier/releases/tag/v2.1.0) or earlier _may_ work. +> - For Mac OS X 10.9 Mavericks _(and perhaps earlier)_: +> 1. the command-line portions of the current release _should_ run fine. +> 2. The GUI will _not_ run, as that OS version does not include Apple's *Metal* framework. +> - _(For a GUI workaround for Mac OS X 10.9, see the [discussion at issue #544](https://github.com/debauchee/barrier/issues/544))_ + + +**Q: How do I load my configuration on startup?** + +> A: Start the binary with the argument `--config ` + + +**Q: After loading my configuration on the client the field 'Server IP' is still empty!** + +> A: Edit your configuration to include the servers ip adress manually with +> +>``` +>(...) +> +>section: options +> serverhostname= +>``` From cc6067a543edea7a2e13e4f9c4975f45a32bc89b Mon Sep 17 00:00:00 2001 From: Jim Grisham Date: Thu, 4 Nov 2021 14:29:00 -0700 Subject: [PATCH 3/6] Updated README.md based on PR peer-review comments Added changes recommended by @shymega in https://github.com/debauchee/barrier/pull/1260 --- README.md | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 5804341f..e9a3d9c4 100644 --- a/README.md +++ b/README.md @@ -91,8 +91,8 @@ specific packages. **Q: What OSes are supported?** -> A: The most recent release of Barrier is known to work on: -> - Windows 7, 8, 8.1, and 10 +> A: The [most recent release](https://github.com/debauchee/barrier/releases/latest) of Barrier is known to work on: +> - Windows 7, 8, 8.1, 10, and 11 > - macOS *(previously known as OS X or Mac OS X)* > - _The current GUI does **not** work on OS versions prior to macOS 10.12 Sierra (but see the related answer below)_ > - Linux @@ -111,10 +111,14 @@ __Q: Is it possible to use Barrier on Mac OS X / OS X versions prior to 10.12?__ > - For OS X 10.10 Yosemite and later: > - [Barrier v2.1.0](https://github.com/debauchee/barrier/releases/tag/v2.1.0) or earlier _may_ work. > - For Mac OS X 10.9 Mavericks _(and perhaps earlier)_: -> 1. the command-line portions of the current release _should_ run fine. +> 1. the command-line portions of the [current release](https://github.com/debauchee/barrier/releases/latest) _should_ run fine. > 2. The GUI will _not_ run, as that OS version does not include Apple's *Metal* framework. > - _(For a GUI workaround for Mac OS X 10.9, see the [discussion at issue #544](https://github.com/debauchee/barrier/issues/544))_ +> Note: Only versions [v2.3.4](https://github.com/debauchee/barrier/releases/tag/v2.3.4) and [later](https://github.com/debauchee/barrier/releases/latest) of Barrier can be supported by this project. +> - Anyone using an earlier version is advised to upgrade due to recently-addressed security vulnerabilities *(and other bug fixes)*. +> - This is especially important for computers accessible from the public Internet *(or from other shared/untrusted networks, such as when using shared WiFi)*. + **Q: How do I load my configuration on startup?** @@ -131,3 +135,14 @@ __Q: Is it possible to use Barrier on Mac OS X / OS X versions prior to 10.12?__ >section: options > serverhostname= >``` + +**Q: Are there any other significant limitations with the current version of Barrier?** + +> A: Currently: +> - Barrier currently has limited UTF-8 support; issues have been reported with processing various languages. +> - *(see [#860](https://github.com/debauchee/barrier/issues/860))* +> - There is interest in future support for the Wayland compositor/display server protocol *([official site](https://wayland.freedesktop.org/) | [Wikipedia article](https://en.wikipedia.org/wiki/Wayland_(display_server_protocol)))* on Linux. +> - As of late 2021, there is no expected completion date for *Wayland* support. +> - *(see [#109](https://github.com/debauchee/barrier/issues/109) and [#1251](https://github.com/debauchee/barrier/issues/1251) for status or to volunteer your talents)* +> +> The complete list of open issues can be found in the ['Issues' tab on GitHub](https://github.com/debauchee/barrier/issues?q=is%3Aissue+is%3Aopen). Help is always appreciated. From e46b8e558fd66e2cf64709b6dd14aef2efe98391 Mon Sep 17 00:00:00 2001 From: Jim Grisham Date: Thu, 4 Nov 2021 14:35:51 -0700 Subject: [PATCH 4/6] Create macos-launchinfo.bugfix: --- doc/newsfragments/macos-launchinfo.bugfix: | 1 + 1 file changed, 1 insertion(+) create mode 100644 doc/newsfragments/macos-launchinfo.bugfix: diff --git a/doc/newsfragments/macos-launchinfo.bugfix: b/doc/newsfragments/macos-launchinfo.bugfix: new file mode 100644 index 00000000..4d88b96e --- /dev/null +++ b/doc/newsfragments/macos-launchinfo.bugfix: @@ -0,0 +1 @@ +Corrected macOS packaging to provide a better error message when a user attempts to launch Barrier on an incompatible macOS version. (https://github.com/debauchee/barrier/issues/1260). From 842c75747ae11eb1725a75df41ceb07098271f56 Mon Sep 17 00:00:00 2001 From: Jim Grisham Date: Thu, 4 Nov 2021 14:40:44 -0700 Subject: [PATCH 5/6] Create 1260_update-faqs.doc --- doc/newsfragments/1260_update-faqs.doc | 1 + 1 file changed, 1 insertion(+) create mode 100644 doc/newsfragments/1260_update-faqs.doc diff --git a/doc/newsfragments/1260_update-faqs.doc b/doc/newsfragments/1260_update-faqs.doc new file mode 100644 index 00000000..a7e753d8 --- /dev/null +++ b/doc/newsfragments/1260_update-faqs.doc @@ -0,0 +1 @@ +Updated FAQs in project README.md with more detail on OS support and links to issues for infrequent users. (https://github.com/debauchee/barrier/issues/1260). From f8d538f29e72feb993cd64241d4d0611743c8b53 Mon Sep 17 00:00:00 2001 From: Jim Grisham Date: Thu, 4 Nov 2021 14:45:11 -0700 Subject: [PATCH 6/6] Rename macos-launchinfo.bugfix: to 1260_macos-launchinfo.bugfix: Updated filename to begin with issue number (per the [twisted/towncrier](https://github.com/twisted/towncrier#readme) documentation). --- .../{macos-launchinfo.bugfix: => 1260_macos-launchinfo.bugfix:} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename doc/newsfragments/{macos-launchinfo.bugfix: => 1260_macos-launchinfo.bugfix:} (100%) diff --git a/doc/newsfragments/macos-launchinfo.bugfix: b/doc/newsfragments/1260_macos-launchinfo.bugfix: similarity index 100% rename from doc/newsfragments/macos-launchinfo.bugfix: rename to doc/newsfragments/1260_macos-launchinfo.bugfix: