Author: jryans Date: Thu May 30 09:46:22 2019 New Revision: 362113 URL: http://llvm.org/viewvc/llvm-project?rev=362113&view=rev Log: [Docs] Modernize references to macOS
Summary: This updates all places in documentation that refer to "Mac OS X", "OS X", etc. to instead use the modern name "macOS" when no specific version number is mentioned. If a specific version is mentioned, this attempts to use the OS name at the time of that version: * Mac OS X for 10.0 - 10.7 * OS X for 10.8 - 10.11 * macOS for 10.12 - present Reviewers: JDevlieghere Subscribers: mgorny, christof, arphaman, cfe-commits, lldb-commits, libcxx-commits, llvm-commits Tags: #clang, #lldb, #libc, #llvm Differential Revision: https://reviews.llvm.org/D62654 Modified: lldb/trunk/docs/lldb-gdb-remote.txt lldb/trunk/docs/resources/build.rst lldb/trunk/docs/use/remote.rst Modified: lldb/trunk/docs/lldb-gdb-remote.txt URL: http://llvm.org/viewvc/llvm-project/lldb/trunk/docs/lldb-gdb-remote.txt?rev=362113&r1=362112&r2=362113&view=diff ============================================================================== --- lldb/trunk/docs/lldb-gdb-remote.txt (original) +++ lldb/trunk/docs/lldb-gdb-remote.txt Thu May 30 09:46:22 2019 @@ -787,9 +787,9 @@ os_version: a version string that repres watchpoint_exceptions_received: one of "before" or "after" to specify if a watchpoint is triggered before or after the pc when it stops default_packet_timeout: an unsigned number that specifies the default timeout in seconds distribution_id: optional. For linux, specifies distribution id (e.g. ubuntu, fedora, etc.) -osmajor: optional, specifies the major version number of the OS (e.g. for Mac OS X 10.11.2, it would be 10) -osminor: optional, specifies the minor version number of the OS (e.g. for Mac OS X 10.11.2, it would be 11) -ospatch: optional, specifies the patch level number of the OS (e.g. for Mac OS X 10.11.2, it would be 2) +osmajor: optional, specifies the major version number of the OS (e.g. for macOS 10.12.2, it would be 10) +osminor: optional, specifies the minor version number of the OS (e.g. for macOS 10.12.2, it would be 12) +ospatch: optional, specifies the patch level number of the OS (e.g. for macOS 10.12.2, it would be 2) //---------------------------------------------------------------------- // "qGDBServerVersion" @@ -1160,7 +1160,7 @@ for this region. // second form of this packet is used, otherwise the first form is // used. This packet is called prior to executing an expression, so // the remote GDB server should do anything it needs to in order to -// ensure the registers that are saved are correct. On MacOSX this +// ensure the registers that are saved are correct. On macOS this // involves calling "thread_abort_safely(mach_port_t thread)" to // ensure we get the correct registers for a thread in case it is // currently having code run on its behalf in the kernel. @@ -1723,7 +1723,7 @@ for this region. // There are three ways this packet can be used. All three return a dictionary of // binary images formatted the same way. // -// On MacOS X 10.11, iOS 9, tvOS 9, watchOS 2 and earlier, the packet is used like +// On OS X 10.11, iOS 9, tvOS 9, watchOS 2 and earlier, the packet is used like // jGetLoadedDynamicLibrariesInfos:{"image_count":1,"image_list_address":140734800075128} // where the image_list_address is an array of {void* load_addr, void* mod_date, void* pathname} // in the inferior process memory (and image_count is the number of elements in this array). @@ -1863,9 +1863,9 @@ server to expedite memory that the clien stack pointer, which are needed for computing backtraces) and it reduces the packet count. -On MacOSX with debugserver, we expedite the frame pointer backchain for a thread +On macOS with debugserver, we expedite the frame pointer backchain for a thread (up to 256 entries) by reading 2 pointers worth of bytes at the frame pointer (for -the previous FP and PC), and follow the backchain. Most backtraces on MacOSX and +the previous FP and PC), and follow the backchain. Most backtraces on macOS and iOS now don't require us to read any memory! //---------------------------------------------------------------------- Modified: lldb/trunk/docs/resources/build.rst URL: http://llvm.org/viewvc/llvm-project/lldb/trunk/docs/resources/build.rst?rev=362113&r1=362112&r2=362113&view=diff ============================================================================== --- lldb/trunk/docs/resources/build.rst (original) +++ lldb/trunk/docs/resources/build.rst Thu May 30 09:46:22 2019 @@ -117,8 +117,12 @@ There are two ways to build LLDB on macO **Preliminaries** -* Xcode 4.3 or newer requires the "Command Line Tools" component (XCode->Preferences->Downloads->Components). -* Mac OS X Lion or newer requires installing `Swig <http://swig.org/>`_. +In addition to any dependencies required by LLVM and Clang, LLDB needs a few +development packages that may also need to be installed depending on your +system. The current list of dependencies are: + +* Xcode 4.3 or newer requires the "Command Line Tools" component (XCode->Preferences->Downloads->Components) +* `Swig <http://swig.org/>`_ **Building LLDB with Xcode** Modified: lldb/trunk/docs/use/remote.rst URL: http://llvm.org/viewvc/llvm-project/lldb/trunk/docs/use/remote.rst?rev=362113&r1=362112&r2=362113&view=diff ============================================================================== --- lldb/trunk/docs/use/remote.rst (original) +++ lldb/trunk/docs/use/remote.rst Thu May 30 09:46:22 2019 @@ -17,7 +17,7 @@ advanced debugging operations, like copy can be used to execute arbitrary shell commands on the remote system. In order to reduce code complexity and improve remote debugging experience LLDB -on Linux and OSX uses the remote debugging stub even when debugging a process +on Linux and macOS uses the remote debugging stub even when debugging a process locally. This is achieved by spawning a remote stub process locally and communicating with it over the loopback interface. In the case of local debugging this whole process is transparent to the user. The platform binary is @@ -44,7 +44,7 @@ gdb-remote stub. A single binary facilit since the two functions share a lot of code. The lldb-server binary is also statically linked with the rest of LLDB (unlike lldb, which dynamically links to liblldb.so by default), so it does not have any dependencies on the rest of -lldb. On Mac OSX and iOS, the remote-gdb functionality is implemented by the +lldb. On macOS and iOS, the remote-gdb functionality is implemented by the debugserver binary, which you will need to deploy alongside lldb-server. The binaries mentioned above need to be present on the remote system to enable _______________________________________________ lldb-commits mailing list lldb-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-commits