From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id myYKMeYWz2Ss4AAASxT56A (envelope-from ) for ; Sun, 06 Aug 2023 05:43:34 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id ShozMOYWz2SPOgAAauVa8A (envelope-from ) for ; Sun, 06 Aug 2023 05:43:34 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 15A7A65ACF for ; Sun, 6 Aug 2023 05:43:33 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=sFQ+IwkV; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; arc=pass ("microsoft.com:s=arcselector9901:i=1"); dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none) ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1691293414; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=RJYhyGbngDRmLr1ZAsLPkIhbXKKjCXR08DBHWnVeywk=; b=cO+0gdSov0EcDCbk5G2VCg77enSwPLNHEWdEY2YCGI7/oDEONjo/H8bi+ZScO4JR5beNWL fxfHZDyLVRYENA+DevOy37046BbcfbG3+Ftb2BPGYaPpP7FSDiyfTfhrskDKdQlT/2ZgLs YEMdd2ZIxKuhBJwi7WskRwso2CqATTS8D6YrL178vJpqcsXIiOiwe9pZ7g+A31QmTjgQj0 EIgjBYB8RbnMlQDXE2U1tGdWTT10ApdZSwLuNBN629holcC1U8nJgOdmtzLKQ0YQI/7nyt 7r3pjkjnKftbhqjBeLZ36w7mnR4kO/CTM2hayAY9K+dq8cxD87SH1PYjG/h3sw== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1691293414; a=rsa-sha256; cv=pass; b=TNVUCsENonaMSyovzhhBUTjxGoIDHDEZ/fkXryLNXBehJQJ9YcXEewG9wrz17K8QasyPME gahyRokg2c2DuP6HArSZoEEN0Da2GTD4lNBwkVOtKB5sQAkX9JFllbodi9W7VC+OUOxd6y 5W2UqVyR+49ihekj5lULuR05f2zq3CTZ/b2G2W/L5exxY5tslJH7evb69mbeVURezgvGcK 82/4XwK1l0rvy0XflHKNE4EJU19+/AiB65Tl2FJ0QdkIZ4lt3x7lD6Gy6W8HY7kxb3vaYO IW6I8hmHKR4rBdQ2po/39PhZHhFi4iTdsrbIESGyb1CuulGE6FzETe4beoVeHA== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=sFQ+IwkV; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; arc=pass ("microsoft.com:s=arcselector9901:i=1"); dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qSUdY-00056D-64; Sat, 05 Aug 2023 23:41:00 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qSUdW-00055u-Nj for emacs-orgmode@gnu.org; Sat, 05 Aug 2023 23:40:58 -0400 Received: from mail-bn7nam10olkn20824.outbound.protection.outlook.com ([2a01:111:f400:7e8a::824] helo=NAM10-BN7-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qSUdU-0008QV-MT for emacs-orgmode@gnu.org; Sat, 05 Aug 2023 23:40:58 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=l2bk2stZFd7CKQd0LJrk9zq11uVM1UVnYV0JhDM0BUCwxB4z2nlCxILBJGsKzZJSVIQvWRtBhCSumHwyxfeXq7LukqLkkXfpmLEmJGCLrIhC0XwZzceBvdLGF+j/J27OvDICAMzMN4h3tWaGX5MtttXSGEfskmsUnqteIwwUT+3cwjhO8aaiOW/g9Ib9HZ/gNbO3OWC++KZ9i8FzOl/2AE9aMKqUBeE0zdP8WNwG4D8fgoako2U/8e3xCyG35V4eZB+kCRsW4+0aAo4MZi5SkTbEoPKWiRsVKn/HQ2piFjl1me/suwoLfEMaOBg29AE2wQXLpPJsxz5i2EPceL30Zg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=RJYhyGbngDRmLr1ZAsLPkIhbXKKjCXR08DBHWnVeywk=; b=PEMk5jZPlHIjdxQ6107syMxt9CNcG9AL+V8j1zqd62V/lFTHLawr+nOUnEKkmF57vWtcjOwTd7sUD9v8uyCJ76RRZFKKjslKQXlM2sTxA3OtdU61pYuOaOSpCjAPrDe83tloMkSycbIHxbZYWLhkvQDlxadk1CYAhD8KBKuE+fhK7tn8ffkmdp5e1v6Prg5o7719NCAGOU8Xaw1IhQ5PGKAv8eScaaSqafWv28twe4TT/dZDXUaVFkEfcUqUdOP20/E0iq2DC/j6nqeCIw443HoaaZZkPCbIxfsJ36ntxRhLB6zSCABi0IXFD2DIGr1WEAS4sEb/qpmqejJtrLmwfg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=RJYhyGbngDRmLr1ZAsLPkIhbXKKjCXR08DBHWnVeywk=; b=sFQ+IwkVPNCiJ4CZiTW6UCdFhTKutjfrwsHFHyrsJ5a1oyXQKwc332jRpNyEjYe035cStaJSk1yWUd/CHWSoBi9BSjqOZMfA34GEdvIyCHuYTajGahip0X0cRcIBRFVjnNEQgsa9N/aRnvJcplpXafzc+qCxPw/wGcI9te6BIV0gyeKZgdks2sR/k9ssCrKMF+p94GH33kz6FswpwITUyQVlOlqo7WHIbatzIW9QzZqAzFppSI6JFwBU/wccQsxq9LgfGXAauV+wqWK3tJzYwVtCPieOY1uzTn4LIE6W4RGgBvYUsuYTn7gSL8jjCaM1i7bU3vu7ALaK3x/1OKXVjg== Received: from SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) by PH0PR03MB6592.namprd03.prod.outlook.com (2603:10b6:510:bb::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6652.22; Sun, 6 Aug 2023 03:35:52 +0000 Received: from SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::7fb8:ad7e:f3ec:44d3]) by SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::7fb8:ad7e:f3ec:44d3%3]) with mapi id 15.20.6631.026; Sun, 6 Aug 2023 03:35:52 +0000 From: David Masterson To: Ihor Radchenko Cc: Stefan Nobis , emacs-orgmode@gnu.org Subject: Re: [PATCH] org-manual: Add references to LaTeX docs References: <874jlmja63.fsf@localhost> <87wmyhj3xs.fsf@localhost> <87leewimrx.fsf@localhost> <87cz08idlz.fsf@localhost> <87cz07gp1b.fsf@localhost> <87r0omnd4a.fsf@localhost> <87tttg1rsl.fsf@localhost> Date: Sat, 05 Aug 2023 20:35:49 -0700 In-Reply-To: <87tttg1rsl.fsf@localhost> (Ihor Radchenko's message of "Thu, 03 Aug 2023 07:58:02 +0000") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Content-Type: text/plain X-TMN: [/wg1pR82iXzySHk1D8hctD1KOy9uSEeVFv+V+qPP/Mr150P2jIjrNdkMZtCCJ0z+] X-ClientProxiedBy: BYAPR01CA0067.prod.exchangelabs.com (2603:10b6:a03:94::44) To SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) X-Microsoft-Original-Message-ID: <87sf8wsuzu.fsf@penguin> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 2 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR03MB5455:EE_|PH0PR03MB6592:EE_ X-MS-Office365-Filtering-Correlation-Id: c311b22c-3b28-472d-af12-08db962e3bd1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: lDtyU+E8j7R04qx2WTo4Bu0OA10ikxdp3m1v+PzxCKF/QqGMtawEf14+pYtzlmFptH16N09pNXJzeCc9cB+pkp/whtb+3tmSzvWqFH6roLbLodkGDiR+Q8zNUrDBZJCW8XBi5Rt2dIrTvYs82vkP03yF6quFNxZXGfvVkjoIxsdJWnSkrjFKcKU614kyZ5wk9bVX8gb1ZToEF44iZVQinU5/JLgcOOBAo2BYPYBd+r0QrsVAVBO+5N3NRa0DEM/QN18+C59VMbBK0L2GS15L69BrAadkimKpLk+U2Mm4f6CFEVUVAg+UiEdWxIj8d2V86Kgs/W30rA8108HauIbPyVlgYKMhjil/dmxG4WUStFn6A8lYPPe8trym5CI4ZMO0VyzEgsyiNvOxJuYSMZ6ebyGPV6s7xZFua8sOiV8zYsS0pKEtPRqhUTdbJfLBWUeJxLbVKlf8W4r8pvCAnEbjO0TCigNJYD2dEnIl1ey7NPrPzjvFfJb7Sf1gmgb/OBFcI0lIzi7CFsDBHTjKQbZHtrqoy9fODeGulFuCxC0PRZSddIOhGLsfgDPC9x0IuL0PzHZMUlX3VqSXuRsY4XTegA== X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?EbDL7i5KipkLrS9GEbeyVByOdUY07Gw7aV9StQdL5v1x6pZL7X4jqloAwr9q?= =?us-ascii?Q?8KR/edSieoN7tTm6ZZ8RxZ2VYgn/pR6NPJ9P/zEpcoGrhQzh4Bga1A//Miud?= =?us-ascii?Q?hIHd7g8gjaCfElU8cbNvUe8g+fGPu6bM8HmH2t4rgX19MmnntL27Dp+MoWxn?= =?us-ascii?Q?gescRmJFTqu4/lF8UZt37WuVl/NCn1pzkRWqolOdsijBzz6B8zktmVEMN+/S?= =?us-ascii?Q?HhSE5p3oUbExvnD6qQg5RmPRFuL2DFUkYvhWklBumJi/m+YumRxDdBNnBGiX?= =?us-ascii?Q?zmf/56IGS29wWnQppGr9p5TQW3yi3Arsz45mfdMHoWaPZz/CM0We0EXHL3yM?= =?us-ascii?Q?oj0VdERYq5tGxNe0CskQCWxxMshQLRnGuz9BdlxtIBWvDGPRaAqNyou6BxiP?= =?us-ascii?Q?lTqo5ftIehpPhLhAa2eJiKV8ZBCDUNIkSTeOFicJ/OmWyndCy7DhnRHPaMbW?= =?us-ascii?Q?q9rnpp5Y26wAykBGBmOP6uzIdaAgrgreE8xMVDGohSGcS/m0OgYJImYdS1zn?= =?us-ascii?Q?Q8KEW2N/JYal2a1z1Be9M3fkD1q84GA65Rkf9gB9Crv3lUmZjnUCQYpjXKwX?= =?us-ascii?Q?fReuVnIuY+o2znavK5uDO1nngWVKVXge3qtSGt4xbTyATKAPbj5NnbZT3o1S?= =?us-ascii?Q?RI7m3DNDQe6VnXZaS7lpOg92+s2qZmejtUr764O9H7ytTzdAIOuDyt9cQJUs?= =?us-ascii?Q?krBhXPumFmQeB0YSjdFaVKBsnRPjt7Nf8b6P2spthPSG4bqOhbVuTbOWJBJ2?= =?us-ascii?Q?xLmufplEr/FE93ZCbIdEOv9hjlSNUypfGBR+4CqcZlQ2gQ65txfs0fFoLFnq?= =?us-ascii?Q?o/nxnqIQ68Ho9UsJPQtthghnnWfk9zexY6Af+Gbuk7XrPQIt/k4Uas6dwehJ?= =?us-ascii?Q?lYAK5iq+0vEs+EmnWy6gb+eFQr91d37Rv4eZBIPnWl9alHCIc3aw3xXxunX4?= =?us-ascii?Q?tOyhCBLEcN570cJkKSeMmZtnhHAk7DRYHRKWPCsa2zB5iUNpiJm2KCHJ0ZQk?= =?us-ascii?Q?3PuUwotr/FWDc3RBeJv+03hvTaLqo/AakdpXmeuk90fOngK0A5q+x53N8YtZ?= =?us-ascii?Q?H8BDD3j9L9HcxEnhsazgFQw4H+jUJjK+GxvX0/M92DmLGWPeLJSST+Lwh3sG?= =?us-ascii?Q?knhmCbrGqPDBNAetUdyofqNYXDyxIPzNFfKl6ogIoWvAKTIqbyBZA9qei0C0?= =?us-ascii?Q?S3FNx5VCX+fdW2OG4c4rDNmHwxwPtNrvYRsSDpbVA0uxYNijpsUOjAk/9ILr?= =?us-ascii?Q?CalhSAKtzjmgPz9GxPZ7Peekh/y/sFizTxpmLsw9IFAwgzLXGav2uXI7WUGg?= =?us-ascii?Q?rka/xfoUmMdnScSzzprFq1VL?= X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: c311b22c-3b28-472d-af12-08db962e3bd1 X-MS-Exchange-CrossTenant-AuthSource: SJ0PR03MB5455.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Aug 2023 03:35:52.4777 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR03MB6592 Received-SPF: pass client-ip=2a01:111:f400:7e8a::824; envelope-from=outlook_98C99531806B1C22@outlook.com; helo=NAM10-BN7-obe.outbound.protection.outlook.com X-Spam_score_int: 6 X-Spam_score: 0.6 X-Spam_bar: / X-Spam_report: (0.6 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FORGED_GMAIL_RCVD=1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Queue-Id: 15A7A65ACF X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -9.86 X-Spam-Score: -9.86 X-TUID: KAjB9sPOaE+D Minor change below. Ihor Radchenko writes: > David Masterson writes: > >> I think begin.html is a good starting point. Mentioning 'texdoc latex' >> is also simple (and more LaTeX specific) and most likely to work. You >> could include a parenthetical note that, if it doesn't work, try the >> URL. After that, new users can dig through the documentation. > > See the attached tentative patch. > > From 659d79484fcd280b0ec8d57282588386aa626b21 Mon Sep 17 00:00:00 2001 > Message-ID: <659d79484fcd280b0ec8d57282588386aa626b21.1691049428.git.yantar92@posteo.net> > From: Ihor Radchenko > Date: Thu, 3 Aug 2023 10:56:07 +0300 > Subject: [PATCH] doc/org-manual.org: Refer to LaTeX docs for general > terminology > > * doc/org-manual.org (LaTeX Export): Add links to online and offline > LaTeX docs. > (Quoting LaTeX code): Clarify that direct LaTeX can be used for > fine-tuning. > > Link: https://orgmode.org/list/SJ0PR03MB5455B2712FA85BA945DFF441A20BA@SJ0PR03MB5455.namprd03.prod.outlook.com > --- > doc/org-manual.org | 14 +++++++++++--- > 1 file changed, 11 insertions(+), 3 deletions(-) > > diff --git a/doc/org-manual.org b/doc/org-manual.org > index 16fbb268f..c3a4e47bc 100644 > --- a/doc/org-manual.org > +++ b/doc/org-manual.org > @@ -13703,6 +13703,13 @@ ** LaTeX Export > blank lines in the Org document. That's because LaTeX itself depends > on blank lines to tell apart syntactical elements, such as paragraphs. > > +The following sections expect users to be familiar with common LaTeX > +terminology. You may refer to https://tug.org/begin.html to get > +familiar with LaTeX basics. Users with LaTeX installed may also run > +=texinfo latex= from terminal to open LaTeX introduction [fn:: The I think you meant '=texdoc latex=' here. > +command will open PDF file, which is also available for download from Oh, also 'open a PDF file'. > +http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf] > + > *** LaTeX/PDF export commands > :PROPERTIES: > :DESCRIPTION: For producing @LaTeX{} and PDF documents. > @@ -13979,9 +13986,10 @@ *** Quoting LaTeX code > :DESCRIPTION: Incorporating literal @LaTeX{} code. > :END: > > -The LaTeX export backend can insert any arbitrary LaTeX code, see > -[[*Embedded LaTeX]]. There are three ways to embed such code in the Org > -file and they all use different quoting syntax. > +When the available LaTeX export customizations are not sufficient to > +fine-tune the desired output, it is possible to insert any arbitrary > +LaTeX code (see [[*Embedded LaTeX]]). There are three ways to embed such > +code in the Org file and they all use different quoting syntax. > > #+cindex: inline, in @LaTeX{} export > Inserting in-line quoted with @ symbols: > -- > 2.41.0 Everything else looks good. -- David Masterson