From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
Received: from mp12.migadu.com ([2001:41d0:2:4a6f::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by ms5.migadu.com with LMTPS
	id uADOGTAYGmMVyQAAbAwnHQ
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Thu, 08 Sep 2022 18:28:32 +0200
Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by mp12.migadu.com with LMTPS
	id IBWsGTAYGmMaMAEAauVa8A
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Thu, 08 Sep 2022 18:28:32 +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 950F611330
	for <larch@yhetil.org>; Thu,  8 Sep 2022 18:28:31 +0200 (CEST)
Received: from localhost ([::1]:59942 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	id 1oWKOE-0005Ro-5y
	for larch@yhetil.org; Thu, 08 Sep 2022 12:28:30 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:42968)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <pedz@easesoftware.com>)
 id 1oWKMn-0005QV-OT
 for emacs-orgmode@gnu.org; Thu, 08 Sep 2022 12:27:03 -0400
Received: from insect.birch.relay.mailchannels.net ([23.83.209.93]:52894)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <pedz@easesoftware.com>)
 id 1oWKMk-0000em-Do
 for emacs-orgmode@gnu.org; Thu, 08 Sep 2022 12:27:00 -0400
X-Sender-Id: a2hosting|x-authuser|pedz+easesoftware.com@mi3-ss4.a2hosting.com
Received: from relay.mailchannels.net (localhost [127.0.0.1])
 by relay.mailchannels.net (Postfix) with ESMTP id 6EB3F5C1CFA
 for <emacs-orgmode@gnu.org>; Thu,  8 Sep 2022 16:20:13 +0000 (UTC)
Received: from mi3-ss4.a2hosting.com (unknown [127.0.0.6])
 (Authenticated sender: a2hosting)
 by relay.mailchannels.net (Postfix) with ESMTPA id 8F1705C0D3B
 for <emacs-orgmode@gnu.org>; Thu,  8 Sep 2022 16:20:09 +0000 (UTC)
ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1662654009; a=rsa-sha256;
 cv=none;
 b=fo7uyo2aUKZAaBDKfRJR/4F5+mSRV7g5FtDSt8SD5Tkv9oBhCOI0QuvWmqqKc3ceNB8VL+
 swQstHgzMexoKcBUGOqEtnKMRmW44wI26VUpNM/kUw+92NBgVu+aTu3RBA8KOFsKZlffJt
 ZUxWNpEMfOpUXoeSXVGcLmqwKa14Y5VMhwOjcj/cUhBq/vM9MDb/Y9bQB/ba6HpKupOWmX
 OHbBEs9imIIEelgrkwhCBodcFUdAlMFOMHq5IwbzMx1zzB7OICVN4Pcc58AMM1TSWFFHZP
 nrB5IVLg8KTEOST0vX/oW5OiwuQ/FGKzfeAuRbHMYBmz9XOC4RdXqiyjaEDVQA==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed;
 d=mailchannels.net; s=arc-2022; t=1662654009;
 h=from:from:reply-to:subject:subject:date:date:message-id:message-id:
 to:to:cc:mime-version:mime-version:content-type:content-type:
 dkim-signature; bh=BQJx9exujC3SrNLP3u2zEZrJmMyKAfE7remysEVxPxI=;
 b=9cNOv+1HM8Y808Yc70aHsV9jUlolmRD20SFkNR4Eqf9lG3gybwXh9Ip0skcuT9idZVWYRs
 45yz2NREFbbqbKh9ngzF/13uF0B4PhwLOVTo4zH8z3r3A2J1WRTkWzdoqhwTd6hw9z15u7
 Qv6ZKJC9rXgGxVslARRkZ59t2mSFlQMURgRuU9ZJCb2rzluF42o6KQb9SVqQadr3BPhxsq
 M4bNvoS3feJHAQhYIHKRpjsw6+cqjZ0ZpQx9u0rDkXwzol149xjcVva48tVFxPlGwCUdqL
 msqC7ceJyIwdtefaqsQBlncwEREdokR58rLRGPazuJCI8L8KV0VLSDogyZQifA==
ARC-Authentication-Results: i=1; rspamd-f776c45b8-v746r;
 auth=pass smtp.auth=a2hosting smtp.mailfrom=pedz@easesoftware.com
X-Sender-Id: a2hosting|x-authuser|pedz+easesoftware.com@mi3-ss4.a2hosting.com
X-MC-Relay: Neutral
X-MailChannels-SenderId: a2hosting|x-authuser|pedz+easesoftware.com@mi3-ss4.a2hosting.com
X-MailChannels-Auth-Id: a2hosting
X-Turn-Cooing: 4eecfdf464d19647_1662654012828_3768577091
X-MC-Loop-Signature: 1662654012828:366725773
X-MC-Ingress-Time: 1662654012828
Received: from mi3-ss4.a2hosting.com (mi3-ss4.a2hosting.com [68.66.200.199])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384)
 by 100.103.147.32 (trex/6.7.1); Thu, 08 Sep 2022 16:20:12 +0000
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
 d=easesoftware.com; s=default; h=To:Date:Message-Id:Subject:Mime-Version:
 Content-Type:From:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID:
 Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc
 :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=BQJx9exujC3SrNLP3u2zEZrJmMyKAfE7remysEVxPxI=; b=JvTT8BxKXdt+O/2JyNQakS7C0z
 MAJk4gEsJ32zDc6wbbBQJ60WM3QKVB0ZpZarchtl2DuW67UUStGUNh4lmZSRrTy2gVlmtVlo2wih7
 JGgSvj4VfofJa2egCkvZZzDGFge7CFSz7aMcaGv/MkMm1gTN5akXDEipKpXPj1vUtF1YNJkKUPbtG
 2coRtsJjtXkzzM9ZqdlcdYlgJ7Ef/o+eABJ5VP96m4RnCWme/5MsKjkbUK/mBbOocrwEV6wAEAFCQ
 aHpKssAbSVad/FuA2zd3GEkTJm56hCjxvgTnHGBhpJV7GgipIfWRFtnybtp7B0ad7kvdJGYQ5JHel
 JClAoySQ==;
Received: from cpe-70-94-128-193.satx.res.rr.com ([70.94.128.193]:56050
 helo=smtpclient.apple)
 by mi3-ss4.a2hosting.com with esmtpsa (TLS1.2) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.95)
 (envelope-from <pedz@easesoftware.com>) id 1oWKG7-0000A1-VM
 for emacs-orgmode@gnu.org; Thu, 08 Sep 2022 12:20:08 -0400
From: Perry Smith <pedz@easesoftware.com>
Content-Type: multipart/signed;
 boundary="Apple-Mail=_EAAD7CEF-C1ED-4150-ADAB-7741D455C1CF";
 protocol="application/pgp-signature"; micalg=pgp-sha256
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.1\))
Subject: Org mode "style sheet" for software documentation
Message-Id: <1EFEFC5A-24EE-43FC-9C4A-14F02CB8B0FD@easesoftware.com>
Date: Thu, 8 Sep 2022 11:20:07 -0500
To: emacs-orgmode@gnu.org
X-Mailer: Apple Mail (2.3696.120.41.1.1)
X-AuthUser: pedz+easesoftware.com@mi3-ss4.a2hosting.com
Received-SPF: pass client-ip=23.83.209.93; envelope-from=pedz@easesoftware.com;
 helo=insect.birch.relay.mailchannels.net
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.1 / 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, HTML_MESSAGE=0.001,
 RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-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" <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
X-Migadu-Flow: FLOW_IN
X-Migadu-To: larch@yhetil.org
X-Migadu-Country: US
ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org;
	s=key1; t=1662654512;
	h=from:from:sender:sender:reply-to:subject:subject:date:date:
	 message-id:message-id:to:to:cc:mime-version:mime-version:
	 content-type:content-type:list-id:list-help:list-unsubscribe:
	 list-subscribe:list-post:dkim-signature;
	bh=BQJx9exujC3SrNLP3u2zEZrJmMyKAfE7remysEVxPxI=;
	b=Jzia+cbP96RulNoChGwRIV9QW79H+AQN9KqxZ18j6cr7d59VifUiZ7yJI/rXmWXCQdW0v7
	0MKFcz84H6Hvw3YIJTVnx9/AOtJ0x/VbmY/rrAELCWNdAMTu5dHO6vfXG9xljUlBG4IKzJ
	HhvAAiGSfWs67UBytRDo4KRMAsb0IzKNaQdd8gh/eKblxn98+DQJt62Pc6cDXmFr9ZBrMN
	9RRPv9HDOdmqwpx/6ycmu8S3GctU3eSPgxkFvAmq6eaQOqdrK4JGRta4tIK8DsV+iHbiiP
	kSXBIHa4ShQTAaKiyEVLGihvqp3OxW0DUnhDXH3gzW5LYTGd+trAVlpm5Xee2Q==
ARC-Seal: i=2; s=key1; d=yhetil.org; t=1662654512; a=rsa-sha256; cv=pass;
	b=Fak8l64eVPaZhkaEU8t7EHLmsJ1bdMl1zAMeHUEE6DzlFRZCQeWn2jXjqSk1w16gP+Nw8M
	7wlsLgvcpGvu+hQ+rVabcUyMdUP+JxG/Fw4PRjITHMFR7ZYcgfVCxgXEl2nisDo8KXG3t2
	VSSNfPNC+9urAzFHBXBf+a23JDvxRANPiCj6BaezvWf40Gmo2KJwKiFdh3hsljy48tMSS8
	E34kACrQCz6viGffND+afGFEovIjYDDnAMhKMuzAxpKU6Yjvp4g8ZEJ7CwIAipnyTcMwM8
	5jIJX/NHrBNf5y6P8sYCHQPXZ3YkYbsu6WPoEXHeolEKMpha/rLZlMxr9Bc7Tw==
ARC-Authentication-Results: i=2;
	aspmx1.migadu.com;
	dkim=fail ("headers rsa verify failed") header.d=easesoftware.com header.s=default header.b=JvTT8BxK;
	arc=pass ("mailchannels.net:s=arc-2022:i=1");
	dmarc=none;
	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"
X-Migadu-Spam-Score: -3.98
Authentication-Results: aspmx1.migadu.com;
	dkim=fail ("headers rsa verify failed") header.d=easesoftware.com header.s=default header.b=JvTT8BxK;
	arc=pass ("mailchannels.net:s=arc-2022:i=1");
	dmarc=none;
	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"
X-Migadu-Queue-Id: 950F611330
X-Spam-Score: -3.98
X-Migadu-Scanner: scn0.migadu.com
X-TUID: O8pOt8RXCpSH


--Apple-Mail=_EAAD7CEF-C1ED-4150-ADAB-7741D455C1CF
Content-Type: multipart/alternative;
	boundary="Apple-Mail=_ABEF56A9-1156-49AD-A490-3ECCF85FDC28"


--Apple-Mail=_ABEF56A9-1156-49AD-A490-3ECCF85FDC28
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=utf-8

I don=E2=80=99t understand this page: =
https://orgmode.org/worg/dev/org-syntax.html#Emphasis_Markers =
<https://orgmode.org/worg/dev/org-syntax.html#Emphasis_Markers>

In particular, the BORDER BODY BORDER part.  Note that this is the =
CONTENT which is already between MARKERS.

What I *think* I want is the ability to effectively create what I=E2=80=99=
ll call =E2=80=9Cmacros=E2=80=9D.  I=E2=80=99d like to be able to =
separate out things like file paths, code samples (both in line and =
block), keywords, environment variables, code variables, etc.  So, as I =
write, I would do (as a total pretend example) [var]foo_dog[var] to =
denote foo_dog as a code variable.  I=E2=80=99m wondering if that =
isn=E2=80=99t what the =E2=80=9CBORDER=E2=80=9D character is.  =46rom =
the way the section is written, I would assume the leading border =
character must be the same as the trailing border character so I could =
do ~vfoo_docv~  where the =E2=80=9Cv=E2=80=9D would be the border =
character?

OR=E2=80=A6 perhaps what this is trying to tell me is the first =
character after the leading marker and the last character before the =
trailing marker must not be whitespace characters since that is how it =
appears from all of the examples.

My logic is if I take the time to separate out all of the elements as I =
write the document, then I can later decide to format, for example, code =
snippets the same as variables.  It would also help me to be more =
consistent while I write because I=E2=80=99m (currently) having to =
remember =E2=80=9COk=E2=80=A6 how did I format variables?  Was that =
=E2=80=98code' or =E2=80=98italics'? =E2=80=A6 Hmm=E2=80=A6=E2=80=9D

If I=E2=80=99ve misunderstood this page, then perhaps to save a follow =
up email, can someone tell me if I can create =E2=80=9Cmacros=E2=80=9D =
within Org mode to do what I mentioned OR tell me that I really don=E2=80=99=
t want to go down that path for some reason.

Thank you for your help,
Perry


--Apple-Mail=_ABEF56A9-1156-49AD-A490-3ECCF85FDC28
Content-Transfer-Encoding: quoted-printable
Content-Type: text/html;
	charset=utf-8

<html><head><meta http-equiv=3D"Content-Type" content=3D"text/html; =
charset=3Dutf-8"></head><body style=3D"word-wrap: break-word; =
-webkit-nbsp-mode: space; line-break: after-white-space;" class=3D""><div =
class=3D"">I don=E2=80=99t understand this page:&nbsp;<a =
href=3D"https://orgmode.org/worg/dev/org-syntax.html#Emphasis_Markers" =
class=3D"">https://orgmode.org/worg/dev/org-syntax.html#Emphasis_Markers</=
a></div><div class=3D""><br class=3D""></div><div class=3D"">In =
particular, the&nbsp;BORDER BODY BORDER part. &nbsp;Note that this is =
the CONTENT which is already between MARKERS.</div><div class=3D""><br =
class=3D""></div><div class=3D"">What I *think* I want is the ability to =
effectively create what I=E2=80=99ll call =E2=80=9Cmacros=E2=80=9D. =
&nbsp;I=E2=80=99d like to be able to separate out things like file =
paths, code samples (both in line and block), keywords, environment =
variables, code variables, etc. &nbsp;So, as I write, I would do (as a =
total pretend example) [var]foo_dog[var] to denote foo_dog as a code =
variable. &nbsp;I=E2=80=99m wondering if that isn=E2=80=99t what the =
=E2=80=9CBORDER=E2=80=9D character is. &nbsp;=46rom the way the section =
is written, I would assume the leading border character must be the same =
as the trailing border character so I could do ~vfoo_docv~ &nbsp;where =
the =E2=80=9Cv=E2=80=9D would be the border character?</div><div =
class=3D""><br class=3D""></div><div class=3D"">OR=E2=80=A6 perhaps what =
this is trying to tell me is the first character after the leading =
marker and the last character before the trailing marker must not be =
whitespace characters since that is how it appears from all of the =
examples.</div><div class=3D""><br class=3D""></div><div class=3D"">My =
logic is if I take the time to separate out all of the elements as I =
write the document, then I can later decide to format, for example, code =
snippets the same as variables. &nbsp;It would also help me to be more =
consistent while I write because I=E2=80=99m (currently) having to =
remember =E2=80=9COk=E2=80=A6 how did I format variables? &nbsp;Was that =
=E2=80=98code' or =E2=80=98italics'? =E2=80=A6 Hmm=E2=80=A6=E2=80=9D</div>=
<div class=3D""><br class=3D""></div><div class=3D"">If I=E2=80=99ve =
misunderstood this page, then perhaps to save a follow up email, can =
someone tell me if I can create =E2=80=9Cmacros=E2=80=9D within Org mode =
to do what I mentioned OR tell me that I really don=E2=80=99t want to go =
down that path for some reason.</div><div class=3D""><br =
class=3D""></div><div class=3D"">Thank you for your help,</div><div =
class=3D"">Perry</div><div class=3D""><br class=3D""></div></body></html>=

--Apple-Mail=_ABEF56A9-1156-49AD-A490-3ECCF85FDC28--

--Apple-Mail=_EAAD7CEF-C1ED-4150-ADAB-7741D455C1CF
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
	filename=signature.asc
Content-Type: application/pgp-signature;
	name=signature.asc
Content-Description: Message signed with OpenPGP

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCAAdFiEE5yOa/gCtQpb3oCpljxzk9yzE+MAFAmMaFjcACgkQjxzk9yzE
+MCIuQ/+PefmRf1/hM/AVjuLTVEeVhkbDuLQE2Sz5yW2X3guyq52psjRnmeMtwuZ
afqg7a+KZpfixcYScVxDkejjyx1hEVLBir7op9URz9Tt3W1mRvYpxtHfngAyORJD
+P61clwfXmESJFgARSlW6LFmrrmsFNz/Gpqfq2u2zkQk1kLI1S+LudYrsScf8wAi
xQGUX/RAZuyQ9OoqKdUpKpLH71kDohhe1xq/YXqvDPlMiZLsmieHcV9r7nc4trjA
vKXUkelpBTPmA9RP0ZurN1DQbvpEcKdWJGcFsH9dXjDPnW6vpg2TxPiIX4s3jb3i
66gh7SzhQUFwVNvpI+K3yYUc/gFsrqYqsDIBLmBLUutZjlNtmIaKbHmI/te9u+RC
lI048l8DP6EaWfo+RmutH7J1g+khnBzuW57alIxUgpT21XPTqngAnu1DRANif/8q
PHS3FpSqPFg8fsrbvPx5RRSJlmWJqCOEKn62OcgG2GPt+CWWD2c+TlqqSE2txgcv
d7LcjRHhABwGfzY7wXrcY8Fxm8c5yVjEqgoAZ2RrYmqRR8nyOIfSaq6ioWZcMv2y
2m9G0bpbjwihXVyR3pywT5ENk00mOiCcPXO4veKW9ittkqAknPCtznqWYG+Hu+46
brSHq2QlunJ9tIynvI3Cqd94lzb1gVEQP9SHFiUTHdAdfZrKpso=
=K/fO
-----END PGP SIGNATURE-----

--Apple-Mail=_EAAD7CEF-C1ED-4150-ADAB-7741D455C1CF--