From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Ihor Radchenko Newsgroups: gmane.emacs.devel Subject: Re: Org mode and Emacs (was: Convert README.org to plain text README while installing package) Date: Mon, 13 Jun 2022 10:40:29 +0800 Message-ID: <87h74p476q.fsf@localhost> References: <87o7z61v59.fsf@gmail.com> <87bkv527p5.fsf@gmail.com> <835yld93w7.fsf@gnu.org> <877d5t0yrn.fsf@gmail.com> <87r140yuof.fsf@gmail.com> <875yl9e7zm.fsf@gmail.com> <83czfh12kp.fsf@gnu.org> <87pmjhghu2.fsf@localhost> <835yl910gp.fsf@gnu.org> <87wndndbhq.fsf@gmail.com> <874k0qbrhe.fsf@localhost> <877d5lwhbg.fsf@gmail.com> <87k09l4cs1.fsf@localhost> <87y1y1uycc.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="29584"; mail-complaints-to="usenet@ciao.gmane.io" Cc: rms@gnu.org, eliz@gnu.org, monnier@iro.umontreal.ca, acm@muc.de, emacs-devel@gnu.org To: Tim Cross Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Jun 13 04:40:45 2022 Return-path: Envelope-to: ged-emacs-devel@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 1o0a0S-0007Yd-Vp for ged-emacs-devel@m.gmane-mx.org; Mon, 13 Jun 2022 04:40:44 +0200 Original-Received: from localhost ([::1]:51156 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o0a0R-0002Si-UQ for ged-emacs-devel@m.gmane-mx.org; Sun, 12 Jun 2022 22:40:43 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40066) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o0ZzA-0001fo-Lv for emacs-devel@gnu.org; Sun, 12 Jun 2022 22:39:24 -0400 Original-Received: from mail-qv1-xf35.google.com ([2607:f8b0:4864:20::f35]:41822) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o0Zz8-0002oz-VC; Sun, 12 Jun 2022 22:39:24 -0400 Original-Received: by mail-qv1-xf35.google.com with SMTP id q104so3526411qvq.8; Sun, 12 Jun 2022 19:39:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version:content-transfer-encoding; bh=GPU2h7IqxQXr+Vi4vxQaSaVpxyQzc31/SCBRVfsRvDE=; b=B2ppVaJQMoIXn4H/w0VjuFw+72vLPjNnqXeHza/nRCdnNO3V9PDhFBGVAeHDGK9wNU bepWs/TToIhdfIOdiOplib2GzvpTBQhQcX5pLC6845H/uiZLsE4KCNK21Q/aB5qX7Le7 xelito5EMEPVs1674udMXioCJuautMR+K+Lwpu2/eV+faBMnnx6FHZEj1fmxHbii4EQe XB7/xkBi6yAgwFcHMdij1ws9jnlsMJw8hq4iz73JQN1NY+626kY4orImF4TTX00m2LHp Od0vDXr6IxdJ0oRClmgwEqimRnkXJeubNOI+MN/1b5F3/MSerm49cfcP7ZqIVfuQW7uq mOew== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version:content-transfer-encoding; bh=GPU2h7IqxQXr+Vi4vxQaSaVpxyQzc31/SCBRVfsRvDE=; b=ZelZX3v0Oc1kVuG1hqcPKOfiCh7GSCSiaXFZvxu9Yhu9KGAlt5BYMUeCAuBbbXYZQF 8OLRSJ/QyYUHSBH/qg5skyUIs6V3bIjlv+JDhg6MdI06O9lyBzNGJpFuYoQr10IHrpRv u/hFaK289BKbVOw6J7upqdTQxgylKl+XTuU+MxsO7nTgZpE9WZMzZf58BSXqCdkvTBLY KQqlHRU1fAzoJ6DpAnrUwlVLiTMCSKrz3UjRb0iUt8YFGrE9zhwSm0SJmZD//oOZcVpO 0I/hZcGgExGcFFfQQZYv2JJAuHn9w5h56VU7XlIYi6vWbI3lZYTbqawX0cEKou/BpJyf MPeA== X-Gm-Message-State: AOAM530LH+Vld5T6+LlsJLeGsgqgOumMtN7tLxopnnbqbfyiIXOlU+RH 5XFlzIr9ix2JGpxYEkVBz96FYFGSvdvbBPH+ X-Google-Smtp-Source: ABdhPJyPQsBuAJHUnhGvrsCO4abtSmVswo8pP1dZ+HeIMkBp6T1raKlX7cCgjbQG2MuqpTmQ/o2dsg== X-Received: by 2002:a05:6214:518f:b0:464:5788:fe55 with SMTP id kl15-20020a056214518f00b004645788fe55mr54229948qvb.4.1655087961423; Sun, 12 Jun 2022 19:39:21 -0700 (PDT) Original-Received: from localhost (22.b2.a86c.ip4.static.sl-reverse.com. [108.168.178.34]) by smtp.gmail.com with ESMTPSA id w2-20020a05622a134200b003051ba1f8bcsm4065765qtk.15.2022.06.12.19.39.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 12 Jun 2022 19:39:20 -0700 (PDT) In-Reply-To: <87y1y1uycc.fsf@gmail.com> Received-SPF: pass client-ip=2607:f8b0:4864:20::f35; envelope-from=yantar92@gmail.com; helo=mail-qv1-xf35.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 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, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:291126 Archived-At: Tim Cross writes: > Well, I think Richard was pretty clear when he asked for the additional > semantic tags listed in the Indicating Definitions, Commands & etc > section of the texinfo manual (6.1 in my copy). Looking at just that > section and it is clear current org markup syntax can handle less than > half. Some of those not handled are the types of semantic elements you > would tend to encounter in software manuals and that is just one section.= =20 To clarify, all those extra semantics boil down to either quoting the text inside in ASCII export or transforming them to /italics/ or ~fixed-width~ in LaTeX/HTML export. Moreover, the majority of extra semantics is simply aliases (for example, @command is an alias to @code). Two exceptions are @acronym and @abbr, which can be easily added as special link types. In general, I so nothing in the 6.1 Indicating Definitions, Commands, etc. that cannot be replicated using Org links or existing emphasis objects: @code{sample} =3D ~sample~ @kbd{M-a} =3D [[kbd:M-a]] (with @kbdinputstyle being document keyword) @key{RET} =3D \RET (new entity type) @samp{text} =3D [[samp:text]] @verb{text} =3D =3Dtext=3D @var{name} =3D [[var:name]] @env{variable}=3D [[env:variable]] @file{path} =3D [[file:path]] @command{cmd} =3D [[command:cmd]] @option{opt} =3D [[option:opt]] @dfn{def} =3D [[dfn:def]] @abbr{abbrev, meaning} =3D [[abbr:meaning][abbrev]] same for @acronym. @email{address,text} =3D [[mailto:address][text]] @indicateurl{url} =3D [[url]] @emph{text} =3D /text/ @strong{text} =3D *text* @sc{text} =3D [[sc:][text]] Note that for abbrevs, we have WIP https://github.com/tecosaur/org-glossary 7 Quotations and Examples @quotation: Block Quotations #+begin_verbatim @indentedblock: Indented text blocks N/A but can be a special bl= ock @example: Example Text #+begin_example @verbatim: Literal Text #+begin_verse @lisp: Marking a Lisp Example #+begin_src @display: Examples Using the Text Font N/A (not sure here) but can= also be a special block @format: Examples Using the Full Line Width I am a bit lost here, but a= gain, anything can be a special block basically @exdent: Undoing a Line=E2=80=99s Indentation ... @flushleft and @flushright ... @raggedright: Ragged Right Text ... @noindent: Omitting Indentation \\ I think @indent: Forcing Indentation Not sure here @cartouche: Rounded Rectangles Can be a block option (I am= not sure if we can make it universal for all possible backends) @small=E2=80=A6 Block Commands Can be a block opti= on Best, Ihor