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 ms9.migadu.com with LMTPS id IDtdMxP5qGQxWwEASxT56A (envelope-from ) for ; Sat, 08 Jul 2023 07:50:11 +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 UOtoMxP5qGQefAEAauVa8A (envelope-from ) for ; Sat, 08 Jul 2023 07:50:11 +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 7952D28B97 for ; Sat, 8 Jul 2023 07:50:11 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qI0oj-0004uM-4W; Sat, 08 Jul 2023 01:49:13 -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 ) id 1qI0oh-0004u1-AP for emacs-orgmode@gnu.org; Sat, 08 Jul 2023 01:49:11 -0400 Received: from ciao.gmane.io ([116.202.254.214]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qI0of-0000Po-Jr for emacs-orgmode@gnu.org; Sat, 08 Jul 2023 01:49:11 -0400 Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1qI0od-0002ve-Cb for emacs-orgmode@gnu.org; Sat, 08 Jul 2023 07:49:07 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: emacs-orgmode@gnu.org From: Max Nikulin Subject: [PATCH v2] org-faq.org: Inline comments Date: Sat, 8 Jul 2023 12:48:57 +0700 Message-ID: References: <5210ac1c-ed73-4b82-a296-41cf90b9f0a7@gmail.com> <87jzvmwnmw.fsf@localhost> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------zc0DwQGBpSaj7cbj9D0IjYad" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.11.0 Content-Language: en-US In-Reply-To: <87jzvmwnmw.fsf@localhost> Received-SPF: pass client-ip=116.202.254.214; envelope-from=geo-emacs-orgmode@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: 28 X-Spam_score: 2.8 X-Spam_bar: ++ X-Spam_report: (2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, FORGED_GMAIL_RCVD=1, FORGED_MUA_MOZILLA=2.309, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1688795411; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post; bh=WHKd7TnF6D/WmoJaiqdf8MKc90s2S2agupDsfvM+o9k=; b=Au3H0+8C9waAb4cxfpVBfgmbpUNBn+ldHEqE735L44QOkQcxxwq2HTsvo9Co/LTWBR90aS syqfT7C7yrhLxP7GYzZEGrdhqBby7eBU/G6TWx1S0DMPe87fZjc25uuL73zxHh9xTaIm95 sGjfc7VEwSTRG7HG2j4FvDo0LEbIRHjUk9BwzgMS2Rel3f50R+v6277GAWoQsr7DMPTlSV RKeSyoZHbrwm2R8MtwT5ev0V3P7ma6GlmqDvwyhDTmLoHcdkTN1nRAWdICpEe47fts6PIu vQQLJ01sk3+MIoQs3uq+jtLBasxsuKfzQkKafp/VA1Re213faKPQRUvlLVvhWA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gmail.com (policy=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" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1688795411; a=rsa-sha256; cv=none; b=aoGImhTTyACs4U0bpmqB2eIJRJ4m/QE+5eiFDRhKQUIOzubEMy44SpqBO7a5TZvFzXZQeF 5HFn9aHcmW/08qNu9w+Ps0ABqhoFQntQCe7nqJolVSp8nHZ0u5uQDAqDjOaReLFLnB9WS4 +TnaOa8F66KuJXQBpkPtt3xLnSr1LiYlalkGmw1jCCT4B/8H/1nGX8gF8pXrRwA73BV3Ox 6AoNwnCiFOy8IGU2m11a/DXmppbsWufxtuObqVLGlIETXd3h8ApW/nUkAnvf5QGaN4NVpf bjCw/S1IzSF4u4SuqsyW6hhgR+3BOAOg6XZkjHi+KZDMNZ47nHrPSguNxa0YDQ== X-Migadu-Scanner: scn1.migadu.com X-Migadu-Spam-Score: 0.13 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gmail.com (policy=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: 7952D28B97 X-Spam-Score: 0.13 X-TUID: Upf0fqJgoYRB This is a multi-part message in MIME format. --------------zc0DwQGBpSaj7cbj9D0IjYad Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 29/06/2023 17:47, Ihor Radchenko wrote: > Max Nikulin writes: >> I think, it is time to add a FAQ entry, see the attachment. > > The proposed FAQ entry is overwhelming. It would work fine as a blog, > but not as a quick answer to a question. I recommend leaving only the > @@comment:...@@ part See a shortened variant. > - it is what we use ourselves in WORG sources. I have not found it in the worg repository. There are enough @@html:@@ with a handful of @@latex:@@. --------------zc0DwQGBpSaj7cbj9D0IjYad Content-Type: text/x-patch; charset=UTF-8; name="v2-0001-org-faq.org-Inline-comments.patch" Content-Disposition: attachment; filename="v2-0001-org-faq.org-Inline-comments.patch" Content-Transfer-Encoding: base64 RnJvbSBmYzU4N2IwNmMyMGU4NjU2MzZmMTYxMDRjMTNiM2YyMzk2ODBlN2JmIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBNYXggTmlrdWxpbiA8bWFuaWt1bGluQGdtYWlsLmNv bT4KRGF0ZTogV2VkLCAyOCBKdW4gMjAyMyAyMjo0MDo0MCArMDcwMApTdWJqZWN0OiBbUEFU Q0ggdjJdIG9yZy1mYXEub3JnOiBJbmxpbmUgY29tbWVudHMKCiogb3JnLWZhcS5vcmcgKEV4 cG9ydCk6IE5ldyBoZWFkaW5nIGRlc2NyaWJpbmcgd29ya2Fyb3VuZHMKZm9yIGlubGluZSBj b21tZW50cy4KLS0tCiBvcmctZmFxLm9yZyB8IDMyICsrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrCiAxIGZpbGUgY2hhbmdlZCwgMzIgaW5zZXJ0aW9ucygrKQoKZGlmZiAtLWdp dCBhL29yZy1mYXEub3JnIGIvb3JnLWZhcS5vcmcKaW5kZXggYWI2NjEzOTUuLjQyY2QyZWY0 IDEwMDY0NAotLS0gYS9vcmctZmFxLm9yZworKysgYi9vcmctZmFxLm9yZwpAQCAtNDQ5Miw2 ICs0NDkyLDM4IEBAICoqIEhvdyBjYW4gSSBzdXBwcmVzcyB0aGUgcGFnZSBudW1iZXIgaW4g dGhlIGZvb3RlciBvZiBhbiBleHBvcnRlZCBQREY/CiAKIDogIytMQVRFWDogXHRoaXNwYWdl c3R5bGV7ZW1wdHl9CiAKKyoqIElzIGl0IHBvc3NpYmxlIHRvIGFkZCBpbmxpbmUgY29tbWVu dHM/Cis6UFJPUEVSVElFUzoKKzpDVVNUT01fSUQ6IGlubGluZS1jb21tZW50cworOkVORDoK KworVW5mb3J0dW5hdGVseSBbW2h0dHBzOi8vb3JnbW9kZS5vcmcvbWFudWFsL0NvbW1lbnQt TGluZXMuaHRtbF1bY29tbWVudHNdXQoraW4gT3JnIG1vZGUgYXJlIGJsb2NrLWxldmVsIGVs ZW1lbnRzLCBzbyB0aGV5IGJyZWFrIHBhcmFncmFwaHMuCisKK0FzIGEgd29ya2Fyb3VuZCBj aG9vc2UgYSBub24tc3RhbmRhcmQgZXhwb3J0IGJhY2tlbmQgbmFtZSBhbmQgdXNlIGl0IGlu CitbW2h0dHBzOi8vb3JnbW9kZS5vcmcvd29yZy9vcmctc3ludGF4Lmh0bWwjRXhwb3J0X1Nu aXBwZXRzXVtleHBvcnQgc25pcHBldHNdXToKKz1AQGNvbW1lbnQ6IHJld3JpdGUgaXQgQEA9 IG9yIGV2ZW4gPUBAYzogYmUgY29uY2lzZUBAPS4KK0l0IGlzIHNhZmVyIHRvIGF2b2lkIGV4 cG9ydCBzbmlwcGV0cyBoYXZpbmcgbm8gb3RoZXIgY29udGVudCBiZWZvcmUgb3IgYWZ0ZXIg dGhlbQorb24gdGhlIHNhbWUgbGluZS4KKyMrYmVnaW5fc3JjIG9yZworVGhlIGZvbGxvd2lu ZyBsaW5lIG1heSBiZWNvbWUgYSBwYXRhZ3JhcGggc2VwYXJhdG9yLgorQEBjb21tZW50OiBt aWdodCBnaXZlIHVuZXhwZWN0ZWQgZWZmZWN0IEBACitQdXQgc29tZSB0ZXh0IGJlZm9yZSBA QGNvbW1lbnQ6IGEgYmV0dGVyIHZhcmlhbnQKK0BAIGFuZCBhZnRlciBpbnN0cmVhZC4KKyMr ZW5kX3NyYworCitBbHRlcm5hdGl2ZXMgYXJlOgorYSBbW2h0dHBzOi8vb3JnbW9kZS5vcmcv bWFudWFsL01hY3JvLVJlcGxhY2VtZW50Lmh0bWxdW21hY3JvXV0KK2V4cGFuZGluZyB0byBu b3RoaW5nLAorYSBbW2h0dHBzOi8vb3JnbW9kZS5vcmcvbWFudWFsL0FkZGluZy1IeXBlcmxp bmstVHlwZXMuaHRtbF1bY3VzdG9tIGxpbmsgdHlwZV1dCitleHBvcnRpbmcgdG8gZW1wdHkg c3RyaW5nLAorW1todHRwczovL29yZ21vZGUub3JnL21hbnVhbC9TdHJ1Y3R1cmUtb2YtQ29k ZS1CbG9ja3MuaHRtbF1bc291cmNlIGNvZGUgYmxvY2tzXV0KK3dpdGggZXhwb3J0aW5nIGFu ZCBldmFsdWF0aW9uIHN1cHByZXNzZWQgdGhyb3VnaCBkZWZhdWx0IGhlYWRlciBhcmd1bWVu dHMuCisKK1VuZm9ydHVuYXRlbHkgc2l0ZXMgZm9yIGhvc3Rpbmcgb2Ygb3BlbiBzb3VyY2Ug Y29kZSBwcm9qZWN0cworZG8gbm90IHN1cHBvcnQgc3VjaCB0cmlja3MgYW5kIGlubGluZSBj b21tZW50cyBtYXkgYXBwZWFyIGluIGZvcm1hdHRlZAorPVJFQURNRS5vcmc9IG9yIG90aGVy IGZpbGVzLgorCiAqIEJhY2t1cAogCiAjK2luZGV4OiBCYWNrdXAKLS0gCjIuMjUuMQoK --------------zc0DwQGBpSaj7cbj9D0IjYad--