From nobody Sun Feb 19 18:56:51 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4PKZXg4My1z3rbJg for ; Sun, 19 Feb 2023 18:56:51 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4PKZXg3mztz3x1F; Sun, 19 Feb 2023 18:56:51 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1676833011; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=c4iUkDlYiZFMzuOYwff1siFgq4N+R3ok2GNRBWnN+FE=; b=xmpGpZt4Ao3ta5I9kA6BCztMYSKdfz09aPRE0gg5jaP2c/ws3BeZVmR/jIv8ESM3f3uJEV Qn/GSYdrEcbXoSmTQeF3Z2hIJwYlioQ5B6Ilvl4NrWahpiTzaZqBQo8rC5n26Aw/n4V4hn doQkYlTaDRoJ3pqsBF0hzRK1JtZ8xfx1isF0/6jcNksMFiAF8sySsAL/k6zHkzZ3ybrSgK swsmT08WlJISK+zI1rcLKrZFzWawgnwkJZ/LFLuv5MBKm+VAd7ATyxDy0g4tObgHKSnIWN cJUYnAh0zrSQPBPye6z7z9s+G+Zhz4A8UFGA7J0QjRI5+d+ftrO/h4S1++VeTQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1676833011; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=c4iUkDlYiZFMzuOYwff1siFgq4N+R3ok2GNRBWnN+FE=; b=HrIIPMwlXcR5qWe9jYlHebjeXPam+4+NZWNjriDqarMWsthUe56Ssd/28Ux6l+udLc8j9d ya2qpQ+AWxMrKahLTSG14eVZbDo+1VdNr2FTp1YxK9jD93n9N3YD8U4qc+DVBgPyAy147e ldx8RLJtWYwpkba7GLsfTB5LKA0yiKKqJu2pFj1Sq37VrUYxTDc0qTHtHIuGg7IoPUhBxR vBrRFhD7edQP6kzCQNyY/Jbe2HYXz3rFefs3knaz2KCeO80xZEIroL5VDszpvGgzlVbWV9 g4jIG33gSevuzCRU8igY9eaSmxPLJXbUiovt//eVJcMM5f7DOBUG+p0qaBCT4g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1676833011; a=rsa-sha256; cv=none; b=j9om91g2IGJBsU3gMcnF6ThMzmQIHYZt6ElYbkDPiyJK7zcd2Z5V8TokOwV79cYQsevRqr P04Pd17DiTtaQ4oSGitVDmj2lawN5oRMt0yW1MaR62zeoVK8BJ5qMmWB+sC+oGt0A1V2ud sqAK284CTBXXbHTwcihSlG+xDXESh+NC47xImQ2zu+q7lZZDt4IuLDZ8dyt0u34MU+D7a6 rtukdl/9ihm8MDTgwoOeZV7oPiiUmkqricrj4dG650gF5JxkffAZLta7ow4Lf5y889oJyx Y6SiF/qhhbua/vrRh7OXfJm8d3lKVM2bJ5+rQkrtqQ3f/8Nlb6pIeKN04uPfqA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4PKZXg2pB0z1BP6; Sun, 19 Feb 2023 18:56:51 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 31JIupQk023431; Sun, 19 Feb 2023 18:56:51 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 31JIup0b023430; Sun, 19 Feb 2023 18:56:51 GMT (envelope-from git) Date: Sun, 19 Feb 2023 18:56:51 GMT Message-Id: <202302191856.31JIup0b023430@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Graham Perrin Subject: git: 7045e0a4f4 - main - AsciiDoc text replacement: non-escaped ' -- ' List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: grahamperrin X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 7045e0a4f4293b805c2bddd677a31907bd434f21 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by grahamperrin: URL: https://cgit.FreeBSD.org/doc/commit/?id=7045e0a4f4293b805c2bddd677a31907bd434f21 commit 7045e0a4f4293b805c2bddd677a31907bd434f21 Author: Graham Perrin AuthorDate: 2023-02-19 18:42:27 +0000 Commit: Graham Perrin CommitDate: 2023-02-19 18:42:27 +0000 AsciiDoc text replacement: non-escaped ' -- ' https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#text-replacements notes that text replacement may occur where -- – is between two word characters, between a word character and a line boundary, or flanked by spaces. The replacement: — – an em dash. The ripgrep command below helped to identify two editions of the FreeBSD Developers' Handbook in which an escape charater was required. rg '`.* -- .*`' /usr/doc Whilst here: full stops, and one sentence per line for the affected subsection of the zh-tw translation of the book. https://bugs.freebsd.org/269679 PR: 269679 Pull request: https://github.com/freebsd/freebsd-doc/pull/113 --- .../en/books/developers-handbook/tools/_index.adoc | 2 +- .../zh-tw/books/developers-handbook/tools/_index.adoc | 16 ++++++++++++---- 2 files changed, 13 insertions(+), 5 deletions(-) diff --git a/documentation/content/en/books/developers-handbook/tools/_index.adoc b/documentation/content/en/books/developers-handbook/tools/_index.adoc index 92c48a7656..bba5b1636a 100644 --- a/documentation/content/en/books/developers-handbook/tools/_index.adoc +++ b/documentation/content/en/books/developers-handbook/tools/_index.adoc @@ -884,7 +884,7 @@ In "the good old days", programmers had to print out hex listings of core files Incidentally, under FreeBSD and other 4.4BSD systems, a core file is called [.filename]#progname.core# instead of just [.filename]#core#, to make it clearer which program a core file belongs to. To examine a core file, specify the name of the core file in addition to the program itself. -Instead of starting up `lldb` in the usual way, type `lldb -c _progname_.core -- _progname_` +Instead of starting up `lldb` in the usual way, type `lldb -c _progname_.core \-- _progname_`. The debugger will display something like this: diff --git a/documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc b/documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc index ce490709d9..973568c9b7 100644 --- a/documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc @@ -792,9 +792,12 @@ The `lldb` command displays the stack frame every time we go into or out of a fu ==== Examining a Core File with lldb -A core file is basically a file which contains the complete state of the process when it crashed. In "the good old days", programmers had to print out hex listings of core files and sweat over machine code manuals, but now life is a bit easier. Incidentally, under FreeBSD and other 4.4BSD systems, a core file is called [.filename]#progname.core# instead of just [.filename]#core#, to make it clearer which program a core file belongs to. +A core file is basically a file which contains the complete state of the process when it crashed. +In "the good old days", programmers had to print out hex listings of core files and sweat over machine code manuals, but now life is a bit easier. +Incidentally, under FreeBSD and other 4.4BSD systems, a core file is called [.filename]#progname.core# instead of just [.filename]#core#, to make it clearer which program a core file belongs to. -To examine a core file, specify the name of the core file in addition to the program itself. Instead of starting up `lldb` in the usual way, type `lldb -c _progname_.core -- _progname_` +To examine a core file, specify the name of the core file in addition to the program itself. +Instead of starting up `lldb` in the usual way, type `lldb -c _progname_.core \-- _progname_`. The debugger will display something like this: @@ -806,7 +809,10 @@ Core file '/home/pauamma/tmp/[.filename]#progname.core#' (x86_64) was loaded. (lldb) .... -In this case, the program was called [.filename]#progname#, so the core file is called [.filename]#progname.core#. The debugger does not display why the program crashed or where. For this, use `thread backtrace all`. This will also show how the function where the program dumped core was called. +In this case, the program was called [.filename]#progname#, so the core file is called [.filename]#progname.core#. +The debugger does not display why the program crashed or where. +For this, use `thread backtrace all`. +This will also show how the function where the program dumped core was called. [source,shell,subs="verbatim,quotes"] .... @@ -818,7 +824,9 @@ In this case, the program was called [.filename]#progname#, so the core file is (lldb) .... -`SIGSEGV` indicates that the program tried to access memory (run code or read/write data usually) at a location that does not belong to it, but does not give any specifics. For that, look at the source code at line 10 of file temp2.c, in `bazz()`. The backtrace also says that in this case, `bazz()` was called from `main()`. +`SIGSEGV` indicates that the program tried to access memory (run code or read/write data usually) at a location that does not belong to it, but does not give any specifics. +For that, look at the source code at line 10 of file temp2.c, in `bazz()`. +The backtrace also says that in this case, `bazz()` was called from `main()`. ==== Attaching to a Running Program with lldb