From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id SMTnLuTCnWTScAAASxT56A (envelope-from ) for ; Thu, 29 Jun 2023 19:44:04 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id sP2qLuTCnWQxNwAAauVa8A (envelope-from ) for ; Thu, 29 Jun 2023 19:44:04 +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 E5B153D4C8 for ; Thu, 29 Jun 2023 19:44:03 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qEvfe-0003Pi-48; Thu, 29 Jun 2023 13:43:06 -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 1qEvfc-0003PL-ST for emacs-orgmode@gnu.org; Thu, 29 Jun 2023 13:43:04 -0400 Received: from sender4-op-o15.zoho.com ([136.143.188.15]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qEvfZ-0001PU-4I for emacs-orgmode@gnu.org; Thu, 29 Jun 2023 13:43:02 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1688060577; cv=none; d=zohomail.com; s=zohoarc; b=lJqPzk9d+ny+YDnEGY+40qnNZ+mGofZrdHpfzqc1kqGMiZlm+4wKhP4ncdA0EwMwXydUXqUO8+nFT2C1rcI7gNZC83daYq6dbfB7kDMaIjRTXYSohtIyGRdDsj+yN8J50C+pJO+3ulNY4UbmWro5ovkiukXnjw5zA5TFKQUMWtE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1688060577; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=nvPI4Lj0WLAIu3918uRifF8kfv9pSiO7/V/ePRKfDN4=; b=WXfHubRWKHUimhu++9r+XL+sd2YTZWnB7zhl80m3JpCv/JKz2TUUgCQ5fzQ5u8SgH0G9rTozXEZD0JF7zjYSPZHU+FaEYeQdHGbf7bs0quJGfit+Y6Z2Mfll36ubq2ascJUaNT+tlthA46LY/Ki5In5xZPC9YiRgCFw7DI3caw8= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass header.i=excalamus.com; spf=pass smtp.mailfrom=matt@excalamus.com; dmarc=pass header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1688060577; s=zmail; d=excalamus.com; i=matt@excalamus.com; h=Date:Date:From:From:To:To:Cc:Cc:Message-ID:In-Reply-To:References:Subject:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Message-Id:Reply-To; bh=nvPI4Lj0WLAIu3918uRifF8kfv9pSiO7/V/ePRKfDN4=; b=QoAsILxNRCRLl5wHLyp50GQ640bDubVvpTn4gnNp/0VdDNgUb1NYKHe5dukEZez1 TLIeFC4suU3BiqDaXL5VGiGIB3mVWzJUtn/6BmzIUZpuh0eyu4yEn/ZDNnLCxeNrg6y pmBrm1d0gHFBmOP/wX+sRa9s+jDpGp5G+rJ/NmR8= Received: from mail.zoho.com by mx.zohomail.com with SMTP id 1688060575746377.73014776750813; Thu, 29 Jun 2023 10:42:55 -0700 (PDT) Date: Thu, 29 Jun 2023 19:42:55 +0200 From: Matt To: "Ihor Radchenko" Cc: "emacs-orgmode" Message-ID: <18908403fad.cfd2f3811001966.2175626053308101114@excalamus.com> In-Reply-To: <87pm5ewoqb.fsf@localhost> References: <1890389c8ff.c8d13885752260.8791711332615822478@excalamus.com> <87pm5ewoqb.fsf@localhost> Subject: Re: Export Documentation Confusions MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 7bit Importance: Medium User-Agent: Zoho Mail X-Mailer: Zoho Mail Received-SPF: pass client-ip=136.143.188.15; envelope-from=matt@excalamus.com; helo=sender4-op-o15.zoho.com 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, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Seal: i=2; s=key1; d=yhetil.org; t=1688060644; a=rsa-sha256; cv=pass; b=NC+rm//IjQGpuD7wCbgXSGhKnmeB06dWR2AFndreBPL0RkVsIeP7T6uk1WK+r8bAZ99DyX nhBwprWUN+3HDMDko2XB286a4XNs5bdZecUZFjlRsIB9x3x0wb2lcCRYKKbEwIo0zkHdV5 KFUNrkaL+kIpqepibba8bjaMo4HEfP4ykPz6PKoQSgZTdjx5B39i7O7zeZGaddBoTO554A CUlZlDBV+y+KB/M4KNRIiPfViUAxVmHODuuIEjOAq51rkQmgU3+M2zyiXDzQgOFiIZQvzP 2cH49zL1oPvQ7tIbZ43u8dc6RXaiPGsGxmaRTRoRVoa1OKH1EyDclMfQho4rBA== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=excalamus.com header.s=zmail header.b=QoAsILxN; dmarc=none; arc=pass ("zohomail.com:s=zohoarc:i=1"); 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-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1688060644; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=nvPI4Lj0WLAIu3918uRifF8kfv9pSiO7/V/ePRKfDN4=; b=aejgdAFmhWEKc0JYwDawYm9QQ946qWk4YQWWLU/5vFXzrkULoqxNX6dalS+bDFOktZ6nH/ PAb1njCR1cCNsTlzwkW9AFYvS3NPSMpDCIc+WbKanDz+ZjeojTnIPkh/NxkOxQ5LdxzsA/ 8yj87S2xgML+vQkKF6d8ivnNc6bHwtnYvVW35UI1QFF8rnal1wb5hBhBkyqH7WAgIaK4Gq a+6Eajz5UnBiePiDeeLisXVPCOj+U1XBu8NmQWKsTHMEINp8jn7kam7Z7d9TvgnxaOieOA OgGy5r9LrgCK2CAbi0V9z4LaxOl/Hj/PhDF6nZloucD4xVwJPJDr4x+LrToiPg== Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=excalamus.com header.s=zmail header.b=QoAsILxN; dmarc=none; arc=pass ("zohomail.com:s=zohoarc:i=1"); 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-Scanner: scn0.migadu.com X-Migadu-Spam-Score: -8.83 X-Spam-Score: -8.83 X-Migadu-Queue-Id: E5B153D4C8 X-TUID: 19Nw6dNnY565 ---- On Thu, 29 Jun 2023 12:24:12 +0200 Ihor Radchenko wrote --- > > - Section 13.18: Export in Foreign Buffers > > > > The section uses the term "foreign buffer" without providing a definition. > > > > Proposed solution: Change wording from "foreign buffers" to "Convert Region" and "non-Org" buffer. > > "Convert region" may be still confusing. Maybe something like > "Convert Org region to other markup syntax"? How about renaming the section to "Export Region"? I was getting ahead of myself. The confusion was about "foreign buffers" and not the meaning of "export". > > - Section 13.18: Export in Foreign Buffers > > > > There was confusion caused by the function names. > > We can also create more intuitive function aliases. How about `org-export-region-to-...`? This would correspond nicely with options given by `org-export-dispatch`.