From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms1.migadu.com with LMTPS id iBT2EpyoJmaECgEA62LTzQ:P1 (envelope-from ) for ; Mon, 22 Apr 2024 20:12:44 +0200 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id iBT2EpyoJmaECgEA62LTzQ (envelope-from ) for ; Mon, 22 Apr 2024 20:12:44 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=Bp1WGgkT; 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"; dmarc=pass (policy=none) header.from=posteo.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1713809564; 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=OBq5CwnFsIJ5MMNezPrA5VtAS+CIAAeXsSO564KqmAs=; b=DXt8FmP/ZgugjqkE/ft/dlUh2pQS/phrOvHeafUOBiS8x8k3+k99iD0Om1d1bBj0XR9EiZ YQvzyjajrY73vVkBj3a08DRbUpAxO97WABu42ZAcaYPaH/cVaGVdKYLoDZFJIxsIzbTyll jn/gp9mtB+akTc9h8kjzO5vsxyhww9ATruGUMFAJvaPi5hfx2p5myrF9ezXofvxsXILvf3 YTs3LLMgdEEW3fZG7TrKZfVVlZpbplR+YmvWAA3PFusGC4+EvfXvEvnCrVmu4694uVTD4K +SEUuJccHxpw/pgo21u1xrz/E1mij0Me3xVV79rfOtWFMXicX3uQ+aqnJCZ0mg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1713809564; a=rsa-sha256; cv=none; b=lL7VaCEoO0RB99cNH0hpdEGFVfJRa37EEdYRtxTqCYoSQntLpHGuO3QffuJwUWYPNHKEGk +UBUY8ekYFNmEgqz5AQ1gHJ+gWwYqE2hYtAGjtfI5bwMyQeX3tXIps8W/CDTRHN7U8cxE/ qq9AZbJ6fn2zdv6fO9CQ3Jptp3SUt70pJPWzbJHoGd9UIX9ek7R9bQkZ9jRQZaLrEjzZDH NTUsGxpLO3RjrvzpWU40hUjsqVyAbjVkP9pRex05kKy2V9FMxrbvUgmiSNLaHXC0dVtNlO W68YzrFMp9yuzh8HK/FpCg2yDJ91UrjmaFeJnf4jpE+7KhsllRf7pZDP7+/udA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=Bp1WGgkT; 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"; dmarc=pass (policy=none) header.from=posteo.net 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 15D025100C for ; Mon, 22 Apr 2024 20:12:44 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ryy93-0003KB-N5; Mon, 22 Apr 2024 14:12:02 -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 1ryy90-0003Ju-GB for emacs-orgmode@gnu.org; Mon, 22 Apr 2024 14:11:58 -0400 Received: from mout02.posteo.de ([185.67.36.66]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ryy8x-0007hu-Bp for emacs-orgmode@gnu.org; Mon, 22 Apr 2024 14:11:58 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id D88CD240101 for ; Mon, 22 Apr 2024 20:11:52 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1713809512; bh=OBq5CwnFsIJ5MMNezPrA5VtAS+CIAAeXsSO564KqmAs=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type: Content-Transfer-Encoding:From; b=Bp1WGgkTA/DmDNITXEZevXeHxhT6xps52u+1NE5Gv7ICEZIOcvRMHocMAKgpwy4DM DppMiwLW1PpkZ9GF3EbOryLpdbC0zRf7jihy9DsKhpnrrdStRZ0o1K54BEdCtWOL5H JJCqwbDlpyBSYS+glc3W5T/ovP1KoMySVbE2wvY5Y6glwfpBsLSUiFOzOvZJaWXYxu IxgtNv6J8o3sCklKelB2AiDNP1BSGPtGrTriwda2Og9BXkIuUQUtZG54vQB6RN7S7a yTOlIbsTtPXo85bv3bmTbtY6m56e3KIeKr461SdUmBUgnwzVN1bnSIjQ4IrE7X4Vnw T4JpG4Bwn8zrg== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4VNYHC1Pdtz6tm4; Mon, 22 Apr 2024 20:11:50 +0200 (CEST) From: Ihor Radchenko To: =?utf-8?Q?Jo=C3=A3o?= Pedro Cc: emacs-orgmode@gnu.org Subject: Re: [DOC] Mismatch on doc regarding position of src block switches In-Reply-To: <87zftm2ltt.fsf@ergo> References: <87zftm2ltt.fsf@ergo> Date: Mon, 22 Apr 2024 18:12:40 +0000 Message-ID: <87zftls1uv.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=185.67.36.66; envelope-from=yantar92@posteo.net; helo=mout02.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 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_MED=-2.3, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 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 X-Migadu-Spam-Score: -5.09 X-Spam-Score: -5.09 X-Migadu-Queue-Id: 15D025100C X-Migadu-Scanner: mx13.migadu.com X-TUID: YZqrudwqQ/Hm Jo=C3=A3o Pedro writes: > I've noticed that in (org)Literal Examples[0], when documenting the switc= hes for example and source blocks, it is mentioned that they should be plac= ed at the *end* of the #+BEGIN line, while both in (org)Structure of Code B= locks[1] and the Org Syntax document[2] the switches are documented to be p= laced right after the language (when appropriate), which is the correct pla= cement for it. Thanks for reporting! Fixed, on bugfix. https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=3Da9275d5fd > I've also noticed that the Org Syntax for blocks (greater or lesser) don'= t mention example blocks having optional switches. We deliberately limit the number of details in the syntax spec. For now, we just say that lesser blocks can have arbitrary DATA at the begin line. --=20 Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at