From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id KKODM7aJtGPsIwEAbAwnHQ (envelope-from ) for ; Tue, 03 Jan 2023 21:01:58 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id ULHLMraJtGPqEAEAG6o9tA (envelope-from ) for ; Tue, 03 Jan 2023 21:01:58 +0100 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 99546178BC for ; Tue, 3 Jan 2023 21:01:58 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pCnTC-0003Ny-6i; Tue, 03 Jan 2023 15:01:10 -0500 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 1pCnT9-0003Ne-4U for emacs-orgmode@gnu.org; Tue, 03 Jan 2023 15:01:07 -0500 Received: from mail-pf1-x42f.google.com ([2607:f8b0:4864:20::42f]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pCnT7-0005uO-FN for emacs-orgmode@gnu.org; Tue, 03 Jan 2023 15:01:06 -0500 Received: by mail-pf1-x42f.google.com with SMTP id 124so21375886pfy.0 for ; Tue, 03 Jan 2023 12:01:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:message-id:in-reply-to:date:subject:to:from:user-agent :references:from:to:cc:subject:date:message-id:reply-to; bh=idjiayGQlGEBGnITxgfIktivVSs/QKyaboLTg5GXqBQ=; b=I/KN/FRSj48U69I2I6k+oaRlmiV2uBgGEIBXTWJoegU/Z8VBnNpDT6RudGMkCMYy9H WkfVaN8kJr83TOqQ5EtMwFyRtK60TGzbYyzffG/KMr4vqrVHyGBxrKfLonATUdrUgFEm 0s6s0GjUhcfT1wqmrPcHsjKQ3zH+l1MX3Tby1r6x1mnTxhcQaKRDByBlEzP8cL7/EKUY dSdG0Hqub06V7PaunjIIW5bV9LMo/5OIG91/HIg0Ohqs5phEbEbWfFML9C0RiKpO6Opi RX6qJToamcxEgOgMWfsw7jsnaXsjmz14kvptQ+X43yec13EQG18NLPKNcJbh3L8OUWEv 1/pw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=mime-version:message-id:in-reply-to:date:subject:to:from:user-agent :references:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=idjiayGQlGEBGnITxgfIktivVSs/QKyaboLTg5GXqBQ=; b=m8iJabeRJgbilAfez9FsqLCeJiVH0w/RLjkCyglf2iZHpZ7KkxwoEo+3vVrZIhSzEU HbqhVHRrgvpx1uDAbd5Jf5HRFh4q4FWbT9qr/CoUThG9r4Db1JBTxDqj7JUgeBXZmhcj PMbl8Ss0xcb3Srkm0jUxL77BEiWOQQEAjdTPNATtJ/1nCmcFzAPruY4r1d0LAjoT4lyp qFWzOspyVS/gKx3jPaFY9c0zEcy4ED60sCJmAiZX8/xYsAh0OPswSYFwvIs5UYL2723T F8jfUCFLnkzZAapi3D9SaGldRSSWcOpuQnRosEbDjqgLekDGBYdg0FcRo9bDakSj3HGE fq2g== X-Gm-Message-State: AFqh2kqSm9khmKqbUK3SRSz+XUBIoZ8o75cIzaR0PQS7cYBq+r+2HUA7 Ac4izpGreEVXhXJm+U/O3rHfY+9a7Cw= X-Google-Smtp-Source: AMrXdXvamZFCU1cq+Bm+YYdbY4oGV6nNVdise8mHx30OJ+QZbpBRt0+ko+DIn6nnb/rTnLBxxYZFLQ== X-Received: by 2002:a62:65c3:0:b0:566:900d:6073 with SMTP id z186-20020a6265c3000000b00566900d6073mr42777969pfb.24.1672776063302; Tue, 03 Jan 2023 12:01:03 -0800 (PST) Received: from dingbat (203-173-24-107.dyn.iinet.net.au. [203.173.24.107]) by smtp.gmail.com with ESMTPSA id m27-20020a62a21b000000b0057fdaff3fa0sm21556557pff.15.2023.01.03.12.01.01 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 03 Jan 2023 12:01:02 -0800 (PST) References: <4NmYHp2V9Nz6tmJ@submission01.posteo.de> User-agent: mu4e 1.9.11; emacs 29.0.60 From: Tim Cross To: emacs-orgmode@gnu.org Subject: Re: Intention of verbatim text? Date: Wed, 04 Jan 2023 05:58:20 +1100 In-reply-to: <4NmYHp2V9Nz6tmJ@submission01.posteo.de> Message-ID: <86ilhnbd6t.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::42f; envelope-from=theophilusx@gmail.com; helo=mail-pf1-x42f.google.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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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 ARC-Seal: i=1; s=key1; d=yhetil.org; t=1672776118; a=rsa-sha256; cv=none; b=BiIeOrP04QNqlCUQB4ZS0/vhWXlEIoOvHVyAUxYUqUYkdkWdBhtEBoAOOBU2//L3OE3xhY kBfk63faaGsKdqls97vbBWrN5j1Tj9x9XvFf/CTm/UGTtBW2oY8Cyw6jenq5eMHjS8XCb2 TLoSaBcgzfZBCc0YlR5r31gVD+YnYZnc6ypia7IV8iChMc9PoqISxBYbuyIFvf+704STJK cgKmkui4FZww4aU0fQajRm9pq+cTQwjE0r8ZAbl9Epnuu20urZhb+Zxi02zWtKjyHzb87E XMJVIIw/ggMs/CSbUz6Zz5TNwfWvGZnxcqIs40jjqMZ9h69QvMwHpeY5Pikabw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b="I/KN/FRS"; 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=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1672776118; 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:dkim-signature; bh=idjiayGQlGEBGnITxgfIktivVSs/QKyaboLTg5GXqBQ=; b=hLLzFoxNh9SD26DUygwIwNn/ERzihEp4zo1jJPm8MhqV5yuRoUDBjCFXuKQto5G6vTIEIg tbqDsawrl5Q+2vcuO1RcnXGcCaddZpoMAeoLB/4JeNMq5HIsso/Mln2uTpwlT3U84x/zQw RqbGfXJ9Vjl+bP3aK7/e9LX0RH2JevZ4RV1u3UWQxoWPVk4f//dRDPh8ze4J9gPCwTuBU+ 1f7CzEnCXeEcqyF7zykTq3dxcaJKkQyjKaMQhlQhqCtXkIG+JQ/3a9GAJ4RaIOGB0qP/xU XFJf3U3Zmp5qhb0Obq0ilnxU7YOaycCDKVZwhcyHuyJ/rjnI9zuQnzMBKXcxUQ== X-Spam-Score: -7.47 X-Migadu-Queue-Id: 99546178BC Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b="I/KN/FRS"; 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=gmail.com X-Migadu-Scanner: scn0.migadu.com X-Migadu-Spam-Score: -7.47 X-TUID: YfHmQ+l24LSJ writes: > Hi, > > in org you can have inline verbatim and code text elements like this. > > Example with =verbatim= and ~code~. > > I would like to understand what "verbatim" really means. What is the > semantic behind it? What content should go in there? > > > I'm aware of the separation of content and its presentation. > I'm also aware of the different renderings in my Emacs. Booth are > monotype but with different colors. > > The org html export to create both with tag. So in HTML output > there is no difference between verbatim and code anymore. > > I also read a lot about the HTML tags code, pre, kbd and samp. > > I wonder that maybe I totally misunderstand the intention of > "verbatim"? > > The background of my question is that I have my own > org-to-html-converter [1] and try to decide how to treat =verbatim=. > Which HTML tag should I use. > > Thanks > Christian > > [1] -- IMO (and it is just my opinion, not that of the org developers), the main use of verbatim (i.e. =text=) is to escape any further interpolation as org markup. It basically says, when exporting, export 'as is' with no further processing. Consider a situation where you want to write A_B, but don't want it to be interpreted as A with a subscript B. There are a number of ways to handle this. One is to set the #+OPTION to ^:nil and turn off the behaviour for the whole file or you can use =A_B= to just turn it off for that use (though this does have other possibly unintended side-effects, such as a font change, but I'm really just trying to illustrate the point here). I would have to look more closely at the output of the HTML export to verify your assertion that both verbatim and code are rendered the same. With respect to 'phrases', I guess there is no real difference in outcome. However, the standard HTML code tag does not preserve line breaks. Traditionally, for blocks of code, the code tag would also be wrapped in the pre tag. However, things have evolved and now it is much more common to see just the code tag with an additional CSS class which is used to manage the preservation of line breaks and whitespace. From a purely tecnical 'correctness' standpoint, I would argue that =text= should be rendered as 
text
and not text. When exporting data, we don't have any semantic markers/information for =textg=, so wrapping it in a semantic tag like is IMO incorrect as we are imposing a semantic interpretation without justification. .