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 IG7LAITtCmObCAAAbAwnHQ (envelope-from ) for ; Sun, 28 Aug 2022 06:22:28 +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 OM/PAITtCmMdWQEAauVa8A (envelope-from ) for ; Sun, 28 Aug 2022 06:22:28 +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 999C2F4C1 for ; Sun, 28 Aug 2022 06:22:27 +0200 (CEST) Received: from localhost ([::1]:49564 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oS9oY-0000d4-Qg for larch@yhetil.org; Sun, 28 Aug 2022 00:22:26 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:52600) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oS9nV-0000cL-JT for emacs-orgmode@gnu.org; Sun, 28 Aug 2022 00:21:21 -0400 Received: from mail-pl1-x632.google.com ([2607:f8b0:4864:20::632]:33741) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oS9nT-0002h0-MK for emacs-orgmode@gnu.org; Sun, 28 Aug 2022 00:21:21 -0400 Received: by mail-pl1-x632.google.com with SMTP id w2so5085581pld.0 for ; Sat, 27 Aug 2022 21:21:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:from:to:cc; bh=J43xgtnVbsnZv7nzLh7nA+RS5pzT+NeNnaqOpOx8KUo=; b=Yb/eK2bJxlg8SltDydgN+/DEMMZeXWtTXrv2qDZnbDzb4e350t707QsAOxQCk9i5/g /gOJ86jJba41v+9BgTRBIhQXtwTdIX0a74lcwi3InVMS88dkf1XAqGLUxbHkRPg0eRHK FkHwj9t66cP7ZeRkdeuOZFUzH66C5RmsAdBSKh9jFVvk6T9cTIoe2zYS9epE6juCdDen r6rGqsjwNlBkZRABDkdLkG10zjD916lIkgPrqg3uuZGpUU+IAxtjreb9u+Vk0KZF3vkT mfmidu++0ufGZ890EWpGpt2IsI2rFsYihhDPs75nv5cnfKLt7peRPnW/J/rjB6nP+ppS k7WQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:x-gm-message-state:from:to:cc; bh=J43xgtnVbsnZv7nzLh7nA+RS5pzT+NeNnaqOpOx8KUo=; b=m8guOKkbeNjnJsv3NEyjobFvoRhhj96HanK88uhNmnRxQf8VIweM3asR0oyFWKMrYW o2l2j/l7W2vCk6CBihEWhV9IltNEhThTeH8GuL/eh7DFEucVPkpFDbJp79hWKmsY0+Rr 2yktWF2KEUpF1qd7CJaxI77gWbwrQz984yZ1o1xI3yEmDaUiJBLBwt76+4CUs2tPpFTE FMBgC8UOlXlC5X/mOR3alaRIR9SoxStjh35kinZ2/knjvOHjovcaANIBJhQ4iKae+GnS BWdBmc1KeVGImvTMgbeHDxTfeaTkLOwM/7b0Lb6LeXFL524KIoBz0r7A+cwxNddN8jr0 F/LQ== X-Gm-Message-State: ACgBeo2S824Tv+zY5YCW9PxCcF+SjZclnDDi4yz/kmnP1gFzCCmGjk07 opYcf6EiOgKJVemj9jls5xs= X-Google-Smtp-Source: AA6agR5rSSEz6CJSddQidXUnJ1pXu7szRNGXImdd/toGagaNHOZRBQMHcY6P9e/7dnaeYu4kL3eXsA== X-Received: by 2002:a17:90a:e58a:b0:1fa:c67c:6107 with SMTP id g10-20020a17090ae58a00b001fac67c6107mr12350405pjz.50.1661660478230; Sat, 27 Aug 2022 21:21:18 -0700 (PDT) Received: from localhost ([2409:8a70:2b3:c8a0:8ec6:81ff:fe70:339d]) by smtp.gmail.com with ESMTPSA id x19-20020aa78f13000000b005382b7c1015sm139825pfr.182.2022.08.27.21.21.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 27 Aug 2022 21:21:17 -0700 (PDT) From: Ihor Radchenko To: Rudolf =?utf-8?Q?Adamkovi=C4=8D?= Cc: emacs-orgmode@gnu.org Subject: Re: Improve the docstring for 'org-html-mathjax-options' In-Reply-To: References: Date: Sun, 28 Aug 2022 12:22:19 +0800 Message-ID: <87h71xuhdw.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::632; envelope-from=yantar92@gmail.com; helo=mail-pl1-x632.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 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_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1661660547; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=J43xgtnVbsnZv7nzLh7nA+RS5pzT+NeNnaqOpOx8KUo=; b=pDd4XAWledpH8e6fydzHB0HpaEm5qx9Lc6sSztSxBt41BINlupgJt0UJ8VdBpJsefWMrLE B7bOvl1jPLY9UZzh9aIEKv7ar8k5R+YqrHZDWV3xjN9Sb9HAa/yMNc70HHAzmJwt2OG1W2 H4l59r/PTt0VEn66soKDh11o3HeH0K9fYYnuWx6XC9sqmQaVTPpkPCgFtxLhpSbHRpi5p7 +sIxnNKP+Ab9rFglSRb5a6KwHH3KEHPJHP1/BQ0k2YnGzkVYZKXspQeylkL+f7I42cLQ+K QLYL3Y3Oxe3L5YZHZf+AfnyJlYdJZLgXaQRY15XK5oqzJQMm5qxbmmv1xsXCJg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1661660547; a=rsa-sha256; cv=none; b=R4IBl0IgVOzloTpCY2nHozj1aLRQx0wOTzOEq8gRoH7j2CgUA5SFJRITiwbekBmD7sHp/b C4pP6UAz0mbrtnQCQKqpxgM9726d6F8owdRI/fMq1JzbOsX/rbuxzvpIe880MluNgr+Mwe Uzv2u+nTln47ZqcmXn5niOtjsxXsZYLR7apGtCEc68LLfrreGZ0jcMKNouVk9fsy1dXaaN OnZWTFvwCg9sO1/6T+BKzktfOFlTaddwv7GuQkdQ60+Ryk8UwsEdatt+Qzpb5/Gno5Y1at XBD4BIzBiZGoRG4tIiJisXixd0NilxuBGmkofgGN3DKpIGcxO+JuWnZR0UFXMA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b="Yb/eK2bJ"; dmarc=pass (policy=none) header.from=gmail.com; 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: -1.80 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b="Yb/eK2bJ"; dmarc=pass (policy=none) header.from=gmail.com; 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: 999C2F4C1 X-Spam-Score: -1.80 X-Migadu-Scanner: scn1.migadu.com X-TUID: WhL2oow9OOq/ > Subject: [PATCH] Fix incorrectly documented MathJax options I am going through some old bug reports and there was another related report about this docstring. Rudolf, since you are probably more familiar with MathJax, may you please take a look at the report below and tell us if the suggestions are sensible? https://orgmode.org/list/m2lf0j77jh.fsf@ego.team Y. E. via "General discussions about Org-mode." (2021-12-17) (2021 emacs-orgmode.gnu.org inbox maillist) Subject: [BUG] org-html-mathjax-options docstring [9.5.1 (release_9.5.1-11-g96d91b @ /emacs-28.0.90/lisp/org/)] It seems the docstring of org-html-mathjax-options may need to be updated. I tried setting 'autonumber' to "None", as the docstring suggests, but only the lower-cased "none" worked fine. Also, MathJax documentation for 2.7 (the version I've got HTML rendered with by org-mode) mentions "AMS", not "AMS Math" (http://docs.mathjax.org/en/v2.7-latest/tex.html). Another option that needs attention is 'indent'. The docstring contains the phrase 'Valid values are "left" and "right"'. This phrase should be changed to something like 'An example of a valid value is "2em"' or simply removed, I think. -- Ihor Radchenko, Org mode contributor, Learn more about Org mode at https://orgmode.org/. Support Org development at https://liberapay.com/org-mode, or support my work at https://liberapay.com/yantar92