Re: [PATCH] org-manual: Add references to LaTeX docs

[David Masterson <dsmasterson@gmail.com>]

Minor change below.

Ihor Radchenko <yantar92@posteo.net> writes:

> 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.
>
> 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

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