From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Sebastian Urban Newsgroups: gmane.emacs.bugs Subject: bug#35885: 25.2; Few mistakes in Emacs Manual (+ proposals) Date: Sat, 22 Aug 2020 12:19:17 +0200 Message-ID: <7695eb68-1b42-efb7-0560-4ffbcc8bc8ac@gmail.com> References: <87v9hkvygw.fsf@gnus.org> <47224e43-28c1-04d0-4418-b8f069a48b0c@gmail.com> <87d03qx2mm.fsf@gnus.org> <9d2594a9-8632-eb3b-18aa-359584c96753@gmail.com> <87k0xwj97f.fsf@gnus.org> <87r1s37xb2.fsf@gnus.org> <5047e985-673d-1c3c-4f97-0353e83285a9@gmail.com> <87o8n5xz9t.fsf@gnus.org> <83sgcf9mey.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="29255"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:68.0) Gecko/20100101 Thunderbird/68.11.0 Cc: larsi@gnus.org, 35885@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Aug 22 12:20:10 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1k9Qd7-0007TS-Os for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 22 Aug 2020 12:20:09 +0200 Original-Received: from localhost ([::1]:60018 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k9Qd6-00045R-CV for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 22 Aug 2020 06:20:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47934) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k9Qd0-00045H-Br for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2020 06:20:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:37364) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1k9Qd0-0002vi-2L for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2020 06:20:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1k9Qcz-0000cE-T8 for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2020 06:20:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Sebastian Urban Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 22 Aug 2020 10:20:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35885 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 35885-submit@debbugs.gnu.org id=B35885.15980915602315 (code B ref 35885); Sat, 22 Aug 2020 10:20:01 +0000 Original-Received: (at 35885) by debbugs.gnu.org; 22 Aug 2020 10:19:20 +0000 Original-Received: from localhost ([127.0.0.1]:48910 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k9QcK-0000bH-3g for submit@debbugs.gnu.org; Sat, 22 Aug 2020 06:19:20 -0400 Original-Received: from mail-lj1-f175.google.com ([209.85.208.175]:45663) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k9QcH-0000b1-Bs for 35885@debbugs.gnu.org; Sat, 22 Aug 2020 06:19:18 -0400 Original-Received: by mail-lj1-f175.google.com with SMTP id w25so4456297ljo.12 for <35885@debbugs.gnu.org>; Sat, 22 Aug 2020 03:19:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:subject:to:cc:references:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=d8cVtECOgrKS9SaWWj7GO8Q7sbfPs2aCkkmx9okgwOY=; b=ct9MlvhF/b7kRyrKjDWyzSWubIqTCXS2JwU0Mn8jd9+1uv3x3D6925R0XQSin1wwk/ 3MCe+6MCIXa1U/L9PMMTCyRnqYARKF5Yc4o8w8pSm9guc287QEv7bzRJTs/Iyt1swaVK kOAwW+T7+xyr4cDBeWzqBhMymG0xdlqo4RA69UH+nn4/R1S+yarkd+qelcMzKSqtgfWQ bhzkC+HdbVMCYkQJZD6kr4Vt023n9/JFXvAtfbe3m9ImNDgZFHLXM3fJy3G2rieDiK+Q 9+RRHWlDguCNtorehMSZjIqDHSKBnS+sJewnm4sdbX6yEuaqA6j4hfJMZmvL4JbYywIG POKQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:subject:to:cc:references:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=d8cVtECOgrKS9SaWWj7GO8Q7sbfPs2aCkkmx9okgwOY=; b=XTYOn3WBbXFsiF2pOvv1bicqlJZYJKBZGL5vDzT10BwFJD074DYGhqy4ErUYSwih+U U6GCtgi2u7F9WLR71bcw5lzRrDRNsWYz7xjsD96ivOLS2fOZNmnWLtDt7Qqpk09V9ON4 CMn1I35uswE6JhooHO1jVdlKmmp5QwhY1JuohmE2BYKA79mtUa86y1LOO9lmwbZRVizR 1u24FNYpRpw65eV9Ng7GenN8MBz0pdE64gLNfSmmXT9BekJ0zDMNausUz0n7c9d4NaSL R4LI520q6HfvzV2Q8UBOzuqNVmwlmrpZ25MMRxJiRvGMLZVh682+DkzKioQ55o8E40RC bUJg== X-Gm-Message-State: AOAM531pfWYhoUsOAQQTCsyDyitKoIglx0MHcrXn4sVM8zOQ9gq+Kvrv +hrPFYvoZD3ntgdVMu80lINUA0Ijyvo= X-Google-Smtp-Source: ABdhPJwIEx8WggR/IHRksfAp7EJI5oxsZRv7Iril3M/jPM7hfkgvSzjj5JJ757Km/FzKmLPXEHXGUQ== X-Received: by 2002:a2e:98ce:: with SMTP id s14mr3238123ljj.358.1598091550743; Sat, 22 Aug 2020 03:19:10 -0700 (PDT) Original-Received: from [192.168.1.100] (ip-89-161-2-137.tel.tkb.net.pl. [89.161.2.137]) by smtp.gmail.com with ESMTPSA id b17sm970584ljp.9.2020.08.22.03.19.09 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 22 Aug 2020 03:19:10 -0700 (PDT) In-Reply-To: <83sgcf9mey.fsf@gnu.org> Content-Language: en-GB X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:185935 Archived-At: >> 1. Changed @samp to @t, as far as I remember it's preferred for quotes. >> >> 2. Similarly, in (...), I changed @samp to @kbd. Although, this time > > I understand item 1, but not item 2. Why would we want to change > @samp to @kbd? Likewise in other parts, where you suggest to change > @t to @kbd. @kbd is for something the user types; using it for quotes > in context other than typing input is wrong. Before I answer, I have to ask: do we want extra (curved) quotes around examples showing quotes, both ASCII and curved? Because I have doubts which way is correct... The point of changing @samp to @kbd is to get rid of additional curved quotes, which surrounds the text, i.e. (‘`’ and ‘'’) --> (` and '). But, since you emphasized, that @kbd is only meant for user input, and point 2. is more likely an example of how ASCII quotes look, I guess @samp could stay. Otherwise, we could use @verb here... We'll still need @w to prevent page break inside parens, unless, in this case, it's acceptable. The point of changing @t to @kbd is to get ASCII quotes, because @t prints curved ones, except for " (QUOTATION MARK). Although, because in change 3. in DISPLAY.TEXI we are showing an example, not user input, we could use @samp there. Also, in change 5. in TEXT.TEXI, even though @t will print ", i.e. correct symbol, since the sentence says: "Then, typing @t{"} insert...", I think we should use @kbd as it is user input. >> * EMACS.TEXI >> ============ >> >> This will change header style (PDF), to this: >> +-------------------------+ +------------------------+ >> | PAGE_NUM DOC_TITLE | |CHAPTER PAGE_NUM | >> >> --8<---------------cut here---------------start------------->8--- >> --- old/emacs.texi 2020-08-19 15:44:47.000000000 +0200 >> +++ new/emacs.texi 2020-08-20 20:06:46.751323200 +0200 >> @@ -99,6 +99,7 @@ >> >> @end titlepage >> >> +@headings double > > This is an unrelated change. Why would we want it? It is related (see https://debbugs.gnu.org/cgi/bugreport.cgi?bug=35885#11): 2. Header style should be changed. It shows page number in right upper corner on every page, but it should show it in right upper corner for odd (right-side) pages and in left upper corner for even (left-side) pages - just like in normal book. (...) These are beyond our control (well, unless we want to write a lot of TeX glue in the manual): this is how Texinfo works. Now, all we need is one line in EMACS.TEXI. BTW, 2 months ago there was a bug report about it: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=42199 S. U.