From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 ) for ; 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 ) for ; 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 ; 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 ) 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 ) 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 ) 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 ; 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 ; 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 ) id 1oWKG7-0000A1-VM for emacs-orgmode@gnu.org; Thu, 08 Sep 2022 12:20:08 -0400 From: Perry Smith 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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" 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 = 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
I don=E2=80=99t understand this page: 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=99ll 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=99t want to go = down that path for some reason.

Thank you for your help,
Perry

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