From 42713c6716e748031d5de4a4e0f94b28b7ec0484 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Antoine=20C=C5=93ur?= Date: Tue, 26 Apr 2022 22:11:44 +0800 Subject: [PATCH] =?UTF-8?q?OS=20X=20=E2=86=92=20macOS=20(#2986)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/Bug-Submission.md | 4 ++-- docs/Building-Transmission.md | 7 +++---- docs/Configuration-Files.md | 2 +- docs/Editing-Configuration-Files.md | 6 +++--- docs/Port-Forwarding-Guide.md | 6 +++--- docs/Scripts.md | 2 +- docs/Transmission-Architecture.md | 4 ++-- gtk/transmission-gtk.metainfo.xml.in | 2 +- macosx/TransmissionHelp/html/pffirewall.html | 6 +++--- macosx/TransmissionHelp/html/pfrouter.html | 2 +- macosx/TransmissionHelp/html/portforward.html | 2 +- macosx/TransmissionHelp/html/troubleshoot.html | 2 +- qt/README.txt | 2 +- 13 files changed, 23 insertions(+), 24 deletions(-) diff --git a/docs/Bug-Submission.md b/docs/Bug-Submission.md index e3b2882ad..14baea2c8 100644 --- a/docs/Bug-Submission.md +++ b/docs/Bug-Submission.md @@ -17,7 +17,7 @@ If you are having trouble with Transmission then the things you should do in ord * State the version of Transmission you are using (e.g. Linux/GTK+ 1.80). If you are using a GUI version of Transmission, you can find its version in the `About` dialog in the Help menu. **Do not** say _the latest version_ it's ambiguous. - * State what operating system and version (e.g. Mac OS X 10.5.8, Ubuntu 8.04, ...) + * State what operating system and version (e.g. macOS 12.3.1, Ubuntu 22.04, ...) * Describe the symptoms in a short yet precise manner. * If the problem is reproducible and you explain how to reproduce it, then it stands a high chance of being addressed. If the problem is intermittent then we still want to know, but if you can not tell us how to reproduce it we cannot easily work on it. @@ -47,7 +47,7 @@ If you are experiencing slow speeds and you have been through the documentation, If you have problems on the Mac version then please do these extra steps: * Make sure your system is updated to the latest version of your operating system. Note as of version 1.60, Transmission requires Mac OS X 10.5 or later. * If you are running a nightly build, set the language to English. The localization will sometimes crash the nightly builds until they are updated (right before an official release). - * OS X collects two pieces of crash information that can help us fix the crash: + * macOS collects two pieces of crash information that can help us fix the crash: 1. In Console.app, look under LOG FILES > ~/Library/Logs/ > CrashReporter > for Transmission. If you find one, include it in your forum post. 2. In Console.app, select LOG DATABASE QUERIES > Console Messages, and search for Transmission. If you find a message that mentions an assertion failure, include it in your forum post. diff --git a/docs/Building-Transmission.md b/docs/Building-Transmission.md index 2f1f75b21..ab1a3ce29 100644 --- a/docs/Building-Transmission.md +++ b/docs/Building-Transmission.md @@ -1,11 +1,10 @@ ## Getting the Source ## The source code for both official and nightly releases can be found on our [download page](https://transmissionbt.com/download/). -## On Mac OS X ## +## On macOS ## Transmission has an Xcode project file (Transmission.xcodeproj) for building in Xcode. Make sure you have this software: - * OS X 10.10 or newer - * OS X 10.10 SDK - * Xcode 4.4 or newer + * macOS 10.14.4 or newer + * Xcode 11.3.1 or newer Building the project on Mac requires the source to be retrieved from GitHub. Pre-packaged source code will not compile. diff --git a/docs/Configuration-Files.md b/docs/Configuration-Files.md index c29c59ea1..fdd9a1a2c 100644 --- a/docs/Configuration-Files.md +++ b/docs/Configuration-Files.md @@ -1,6 +1,6 @@ ## Locations -### Mac OS X Defaults +### macOS Defaults diff --git a/docs/Editing-Configuration-Files.md b/docs/Editing-Configuration-Files.md index bede8f36b..155c47614 100644 --- a/docs/Editing-Configuration-Files.md +++ b/docs/Editing-Configuration-Files.md @@ -68,7 +68,7 @@ Here is a sample of the three basic types: respectively Boolean, Number and Stri * **lpd-enabled:** Boolean (default = false) Enable [Local Peer Discovery (LPD)](https://en.wikipedia.org/wiki/Local_Peer_Discovery). * **message-level:** Number (0 = None, 1 = Error, 2 = Info, 3 = Debug, default = 2) Set verbosity of transmission messages. * **pex-enabled:** Boolean (default = true) Enable [https://en.wikipedia.org/wiki/Peer_exchange Peer Exchange (PEX)]. - * **prefetch-enabled:** Boolean (default = true). When enabled, Transmission will hint to the OS which piece data it's about to read from disk in order to satisfy requests from peers. On Linux, this is done by passing `POSIX_FADV_WILLNEED` to [posix_fadvise()](https://www.kernel.org/doc/man-pages/online/pages/man2/posix_fadvise.2.html). On OS X, this is done by passing `F_RDADVISE` to [fcntl()](https://developer.apple.com/library/IOS/#documentation/System/Conceptual/ManPages_iPhoneOS/man2/fcntl.2.html). This defaults to false if configured with --enable-lightweight. + * **prefetch-enabled:** Boolean (default = true). When enabled, Transmission will hint to the OS which piece data it's about to read from disk in order to satisfy requests from peers. On Linux, this is done by passing `POSIX_FADV_WILLNEED` to [posix_fadvise()](https://www.kernel.org/doc/man-pages/online/pages/man2/posix_fadvise.2.html). On macOS, this is done by passing `F_RDADVISE` to [fcntl()](https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/fcntl.2.html). This defaults to false if configured with --enable-lightweight. * **scrape-paused-torrents-enabled:** Boolean (default = true) * **script-torrent-added-enabled:** Boolean (default = false) Run a script when a torrent is added to Transmission. Environmental variables are passed in as detailed on the [Scripts](./Scripts.md) page * **script-torrent-added-filename:** String (default = "") Path to script. @@ -172,9 +172,9 @@ Only keys that differ from above are listed here. These options have been replac ##### [RPC](rpc-spec.md) * **rpc-access-control-list:** String (Comma-delimited list of IP addresses prefixed with "+" or "-". Wildcards allowed using '\*'. Example: "+127.0.0.\*,-192.168.\*.\*", Default: "+127.0.0.1") -## Mac OS X +## macOS ### Overview -Mac OS X has a standardized way of saving user preferences files using [XML](https://en.wikipedia.org/wiki/XML) format. These files are called [plist](https://en.wikipedia.org/wiki/Plist) (short for property list) files. Usually there is no need to modify these files directly, since Apple provided a [command-line tool](https://developer.apple.com/DOCUMENTATION/Darwin/Reference/ManPages/man1/defaults.1.html) to reliably change settings. You do need to restart Transmission before these have effect. +macOS has a standardized way of saving user preferences files using [XML](https://en.wikipedia.org/wiki/XML) format. These files are called [plist](https://en.wikipedia.org/wiki/Plist) (short for property list) files. Usually there is no need to modify these files directly, since Apple provided a [command-line tool](https://developer.apple.com/DOCUMENTATION/Darwin/Reference/ManPages/man1/defaults.1.html) to reliably change settings. You do need to restart Transmission before these have effect. In short: * To set a key: `defaults write org.m0k.transmission ` diff --git a/docs/Port-Forwarding-Guide.md b/docs/Port-Forwarding-Guide.md index 3446843b6..9e534272e 100644 --- a/docs/Port-Forwarding-Guide.md +++ b/docs/Port-Forwarding-Guide.md @@ -6,8 +6,8 @@ For this to be possible, it is required to be accessible from the Internet. Howe ## Open your local firewall To allow other peers to communicate with your Transmission instance, you have to forward a port through your firewall. -### On Mac OS X -Upon opening Transmission for the first time, a Mac OS X dialog box should appear asking if you will allow Transmission to receive incoming connections. Click Accept. +### On macOS +Upon opening Transmission for the first time, a macOS dialog box should appear asking if you will allow Transmission to receive incoming connections. Click Accept. If this does not happen, you can add Transmission to Leopard's firewall manually: 1. Open System Prefs >> Security >> Firewall. Make sure "Set access for specific services and applications" is selected. @@ -53,7 +53,7 @@ Most routers manufactured since 2001 have either the UPnP or NAT-PMP feature. ### Forward manually through a router 1. Find out what your IP address is. - * *On Mac OS X*- Go to System Preferences >> Network, double-clicking on your connection (for instance, Built-in Ethernet), and clicking the TCP/IP tab. The address is probably something like 192.168.1.100, or 10.0.1.2. The IP of your router is here too. + * *On macOS*- Go to System Preferences >> Network, double-clicking on your connection (for instance, Built-in Ethernet), and clicking the TCP/IP tab. The address is probably something like 192.168.1.100, or 10.0.1.2. The IP of your router is here too. * *On Unix*- In Ubuntu, right click the Network Manager applet in the menu bar, and select 'Connection Information'. The address is probably something like 192.168.1.2, or 10.0.1.2. * If you don't have Network Manager, open a Terminal and type 'ifconfig'. It will list information for each of your network devices. Find the one you are using, and use the number after 'inet addr:'. * Using the command "ip a" will achieve the same results in a different format. diff --git a/docs/Scripts.md b/docs/Scripts.md index 73e8769b8..3462ae6de 100644 --- a/docs/Scripts.md +++ b/docs/Scripts.md @@ -2,7 +2,7 @@ ## Introduction Thanks to the powerful [RPC](./rpc-spec.md), `transmission-remote` can talk to any client that has the RPC enabled. This means that a script written using `transmission-remote` or [RPC](./rpc-spec.md) can, without rewrite, communicate with all the Transmission clients: Mac, Linux, Windows, and headless. -Mac OS users may wonder whether there will be AppleScript scripts, the answer is ''no''. Although AppleScript is a nice technology, it's a pain to implement. However, Mac OS X is a Unix after all, so any script you find here will also work on the Mac. Even from within AppleScript, you can run these scripts by typing: `do shell script "path/to/script"`. +Mac OS users may wonder whether there will be AppleScript scripts, the answer is ''no''. Although AppleScript is a nice technology, it's a pain to implement. However, macOS is a Unix after all, so any script you find here will also work on the Mac. Even from within AppleScript, you can run these scripts by typing: `do shell script "path/to/script"`. ## How-To If you are interested at writing scripts for Transmission, have a look at the following pages: diff --git a/docs/Transmission-Architecture.md b/docs/Transmission-Architecture.md index a1f17ad6c..95931173e 100644 --- a/docs/Transmission-Architecture.md +++ b/docs/Transmission-Architecture.md @@ -7,7 +7,7 @@ The core components and methods of control are shown below: ![Architecture](https://transmission.github.io/wiki-images/Transmission_Architecture.gif) From the above diagram it can be seen that a Transmission core may be controlled by the following: - * _Local_ directly linked GUI (OS X, GTK+) + * _Local_ directly linked GUI (macOS, GTK+) * _Local_ or _remote_ Qt GUI * _Local_ or _remote_ command line utility * _Local_ or _remote_ Transmission web application running in a web browser @@ -17,7 +17,7 @@ The multiple methods of controlling Transmission and the various native GUIs ava ![Products](https://transmission.github.io/wiki-images/Transmission_Products.gif) The products are: - * Transmission desktop - OS X + * Transmission desktop - macOS * Transmission desktop - Windows, Linux/Qt * Transmission desktop - Linux/GTK+ * Transmission daemon (headless) diff --git a/gtk/transmission-gtk.metainfo.xml.in b/gtk/transmission-gtk.metainfo.xml.in index 65a318853..9fe7cd7f3 100644 --- a/gtk/transmission-gtk.metainfo.xml.in +++ b/gtk/transmission-gtk.metainfo.xml.in @@ -20,7 +20,7 @@ Copyright 2017 Endless Mobile, Inc.

Transmission is a BitTorrent client with an easy-to-use frontend on top a cross-platform backend. - Native frontends are available for OS X and Windows, as well as command line and + Native frontends are available for macOS and Windows, as well as command line and web frontends.

diff --git a/macosx/TransmissionHelp/html/pffirewall.html b/macosx/TransmissionHelp/html/pffirewall.html index bbdd9801f..20f990b6e 100644 --- a/macosx/TransmissionHelp/html/pffirewall.html +++ b/macosx/TransmissionHelp/html/pffirewall.html @@ -3,7 +3,7 @@ - Configuring the Mac OS X Firewall + Configuring the macOS Firewall

@@ -12,10 +12,10 @@
-

Configuring the Mac OS X Firewall

+

Configuring the macOS Firewall


-

Upon opening Transmission for the first time, a Mac OS X dialog box should appear asking if you will allow Transmission to receive incoming connections. Click Accept.

+

Upon opening Transmission for the first time, a macOS dialog box should appear asking if you will allow Transmission to receive incoming connections. Click Accept.

If this doesn't happen, you can add Transmission to the firewall manually:

    diff --git a/macosx/TransmissionHelp/html/pfrouter.html b/macosx/TransmissionHelp/html/pfrouter.html index d4f846750..3004e96c9 100644 --- a/macosx/TransmissionHelp/html/pfrouter.html +++ b/macosx/TransmissionHelp/html/pfrouter.html @@ -14,7 +14,7 @@

    Port Forwarding a Router

    -

    If you are using a router, it is probably OK to disable the OS X firewall, as you are already being protected by the router. To disable the firewall, open System Prefs → Security → Firewall. Click Stop. +

    If you are using a router, it is probably OK to disable the macOS firewall, as you are already being protected by the router. To disable the firewall, open System Prefs → Security → Firewall. Click Stop.

    To forward a port in your router manually: diff --git a/macosx/TransmissionHelp/html/portforward.html b/macosx/TransmissionHelp/html/portforward.html index f51620a2a..9630dfdfe 100644 --- a/macosx/TransmissionHelp/html/portforward.html +++ b/macosx/TransmissionHelp/html/portforward.html @@ -26,7 +26,7 @@

If you don't have a compatible router, it is simple to forward Transmission's port manually. For instructions click here.

-

If you don't use a router, and your modem is directly connected to your computer, you'll need to open Transmission's port in the Mac OS X firewall. For instructions click here.

Note: It is highly recommended you enable the Mac OS X firewall if you are not using a router.

+

If you don't use a router, and your modem is directly connected to your computer, you'll need to open Transmission's port in the macOS firewall. For instructions click here.

Note: It is highly recommended you enable the macOS firewall if you are not using a router.

Keep in mind that many DSL modems also function as routers, so port forwarding may still be necessary, even though your computer is directly connected to the modem.

diff --git a/macosx/TransmissionHelp/html/troubleshoot.html b/macosx/TransmissionHelp/html/troubleshoot.html index 9b63bc115..397aea17a 100644 --- a/macosx/TransmissionHelp/html/troubleshoot.html +++ b/macosx/TransmissionHelp/html/troubleshoot.html @@ -63,7 +63,7 @@

The second way is to map Transmission's port on all of the devices on your network. Transmission can only automatically port map the router the computer is directly connected to. Any others in between this router and your modem will have to be forwarded manually. For detailed instructions, click here. -

Finally make sure the OS X firewall is either disabled, or you have allowed Transmission's port. +

Finally make sure the macOS firewall is either disabled, or you have allowed Transmission's port. The firewall can cause the port to remain closed, even if it has been successfully mapped by the router(s). diff --git a/qt/README.txt b/qt/README.txt index 7d2419cc1..0487213d2 100644 --- a/qt/README.txt +++ b/qt/README.txt @@ -29,7 +29,7 @@ BUILDING ON WINDOWS rb07 has a writeup of this on the Transmission wiki: https://trac.transmissionbt.com/wiki/BuildingTransmissionQtWindows -BUILDING ON OS X +BUILDING ON MACOS nnc has a writeup of this on the Transmission wiki: https://trac.transmissionbt.com/wiki/BuildingTransmissionQtMac

WhatWhere
Per-torrent settings$HOME/Library/Application Support/Transmission