From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
Received: from mp11.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 4NtJMTxey2RczwAASxT56A
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Thu, 03 Aug 2023 09:58:52 +0200
Received: from aspmx1.migadu.com ([2001:41d0:403:478a::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by mp11.migadu.com with LMTPS
	id sEhOMTxey2RFWQEA9RJhRA
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Thu, 03 Aug 2023 09:58:52 +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 7C67965062
	for <larch@yhetil.org>; Thu,  3 Aug 2023 09:58:52 +0200 (CEST)
Authentication-Results: aspmx1.migadu.com;
	dkim=pass header.d=posteo.net header.s=2017 header.b=M49Zexdi;
	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";
	dmarc=pass (policy=none) header.from=posteo.net
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org;
	s=key1; t=1691049532;
	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=ipqw+X2P0aMh17dZFp9HBtWya9TKq5m6Zx5G2rUTLQA=;
	b=Kth/bIks+OsWooyDu/n3IGMvHqX4hgsE6eVHGIecLIxP9FDFCSIkirEOc4hgqBQWBK4VK2
	Vgp10jJ2qRbG44w4qkQ+azwpBAHyqeFbpL2aec0b/zIXrhmV1XFifXXZ4WU2WyoLH1F+1g
	l/x90Qf0OYIAPxdYBUA1fSx0TGwCTAPiCbu62Ngngeom2PB52jEgE0d3VotW11adctcrei
	x6TBop/+TWmzSqDr1kzzgfMn1Mg9dtnkhCMv75LRdxwwdQ92gQtrt78r75MisfyXBoB02s
	2wASC4ogZ6QCwHsXwmUv8iYzigOfZbFvBKQkPEUFPJhaydPmV2y0rsWrHIDMVw==
ARC-Seal: i=1; s=key1; d=yhetil.org; t=1691049532; a=rsa-sha256; cv=none;
	b=XqIv/NRl4hXcLFe7D4W4paKY8KrgNcCkWRAgUeIQKkaqpy8og7H7uz2PWASaVyluSgNRsD
	/ZWXNjPEBaeSnf5oxZo8TnN90ybMSk28nDd8woyjvYaCflkOcXOdEJur3MYGI6M2IAWxRF
	URYsEuR7tWw0smD297dCgDYp5h6k/x8115tAQGY2in5P3FoQJBXWmA4I/4bb4Bm/f+kCAH
	27xmZ7mqp6AD6g/nTDKbjDsPI6b4g5+kBQclRMtOfkJ1VGXxDy4VnSeCFxoWSygl/B9z0r
	cDmCzKcpzAbZSBAYxe0byLoYednheGpdLZoOFKTkdwA6bxqqjitMeiiju/BFaQ==
ARC-Authentication-Results: i=1;
	aspmx1.migadu.com;
	dkim=pass header.d=posteo.net header.s=2017 header.b=M49Zexdi;
	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";
	dmarc=pass (policy=none) header.from=posteo.net
Received: from localhost ([::1] helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-orgmode-bounces@gnu.org>)
	id 1qRTDY-0005ra-SS; Thu, 03 Aug 2023 03:57:56 -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 <yantar92@posteo.net>)
 id 1qRTDV-0005qE-3j
 for emacs-orgmode@gnu.org; Thu, 03 Aug 2023 03:57:53 -0400
Received: from mout01.posteo.de ([185.67.36.65])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <yantar92@posteo.net>)
 id 1qRTDR-0001ge-JG
 for emacs-orgmode@gnu.org; Thu, 03 Aug 2023 03:57:51 -0400
Received: from submission (posteo.de [185.67.36.169]) 
 by mout01.posteo.de (Postfix) with ESMTPS id 15137240029
 for <emacs-orgmode@gnu.org>; Thu,  3 Aug 2023 09:57:47 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017;
 t=1691049467; bh=4L+DOnBU9DYbAr7eZhNvI9txaq5yWg3oUWh3d5kcR6w=;
 h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:From;
 b=M49ZexdiXZPJ1aq+8teO0Y0PmCytzmCyAsUb0lW4UTxO/0mr38oyhGk/Vc32zEHyq
 9Hy2hxjl/3iUNvGzWGyymJecXZEI0CO+UhT9wiXMNjVA3claMW9+DRKuSrwTCSyOfq
 QpXSsRDzYMU147qJ20zmcd557boW0RWVAbLlvHdTpo7bDXVfh3fNO5325v4Y1uehsZ
 0ihDwvR0FHO/ctmp07ycTqzNo0VdxU/YlR0s/O1n/KZCL3oTaysYPuiE1akOtbeOKR
 SBLzZoa9jbbdq14GIVJGMslwpMpa1MbhuDpjo7fPAAy1nr670U6ylF40vKYBtOyD6q
 QQ7ydNXFHO/Xw==
Received: from customer (localhost [127.0.0.1])
 by submission (posteo.de) with ESMTPSA id 4RGh623hWQz6tw3;
 Thu,  3 Aug 2023 09:57:46 +0200 (CEST)
From: Ihor Radchenko <yantar92@posteo.net>
To: David Masterson <dsmasterson@gmail.com>
Cc: Stefan Nobis <stefan-ml@snobis.de>, emacs-orgmode@gnu.org
Subject: [PATCH] org-manual: Add references to LaTeX docs (was: New Orgmode
 LaTex Document Class ?)
In-Reply-To: <SJ0PR03MB5455B2712FA85BA945DFF441A20BA@SJ0PR03MB5455.namprd03.prod.outlook.com>
References: <SJ0PR03MB5455C5502B0CCE4B4C4DECB8A206A@SJ0PR03MB5455.namprd03.prod.outlook.com>
 <m1o7jw31uo.fsf@nobis-it.eu>
 <SJ0PR03MB5455AF89651DB2B6EE26C570A207A@SJ0PR03MB5455.namprd03.prod.outlook.com>
 <874jlmja63.fsf@localhost>
 <SJ0PR03MB5455F9D0F0AFE11E2157155DA204A@SJ0PR03MB5455.namprd03.prod.outlook.com>
 <87wmyhj3xs.fsf@localhost>
 <SJ0PR03MB5455570031D6322F1B8AA0E1A204A@SJ0PR03MB5455.namprd03.prod.outlook.com>
 <87leewimrx.fsf@localhost> <m1zg3cwmtz.fsf@nobis-it.eu>
 <87cz08idlz.fsf@localhost>
 <SJ0PR03MB5455AC2E71F1C3A60E68E2ECA205A@SJ0PR03MB5455.namprd03.prod.outlook.com>
 <87cz07gp1b.fsf@localhost>
 <SJ0PR03MB54551E60D2B4F498BBCBD45FA20BA@SJ0PR03MB5455.namprd03.prod.outlook.com>
 <87r0omnd4a.fsf@localhost>
 <SJ0PR03MB5455B2712FA85BA945DFF441A20BA@SJ0PR03MB5455.namprd03.prod.outlook.com>
Date: Thu, 03 Aug 2023 07:58:02 +0000
Message-ID: <87tttg1rsl.fsf@localhost>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
Received-SPF: pass client-ip=185.67.36.65; envelope-from=yantar92@posteo.net;
 helo=mout01.posteo.de
X-Spam_score_int: -43
X-Spam_score: -4.4
X-Spam_bar: ----
X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,
 RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001,
 SPF_HELO_NONE=0.001, SPF_PASS=-0.001,
 T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham 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." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=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: 7C67965062
X-Migadu-Scanner: mx0.migadu.com
X-Migadu-Spam-Score: -9.31
X-Spam-Score: -9.31
X-TUID: HGO9jthuSX2I

--=-=-=
Content-Type: text/plain

David Masterson <dsmasterson@gmail.com> 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.


--=-=-=
Content-Type: text/x-patch
Content-Disposition: inline;
 filename=0001-doc-org-manual.org-Refer-to-LaTeX-docs-for-general-t.patch

>From 659d79484fcd280b0ec8d57282588386aa626b21 Mon Sep 17 00:00:00 2001
Message-ID: <659d79484fcd280b0ec8d57282588386aa626b21.1691049428.git.yantar92@posteo.net>
From: Ihor Radchenko <yantar92@posteo.net>
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
+command will open PDF file, which is also available for download from
+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


--=-=-=
Content-Type: text/plain


-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>

--=-=-=--