From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms1.migadu.com with LMTPS id KHz+KkhUPmboPwAAe85BDQ:P1 (envelope-from ) for ; Fri, 10 May 2024 19:07:20 +0200 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id KHz+KkhUPmboPwAAe85BDQ (envelope-from ) for ; Fri, 10 May 2024 19:07:20 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=b3OQo0Ih; 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" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1715360840; a=rsa-sha256; cv=none; b=gX6veYt7kbObbA1sDqPvZ+yoeNJrrRVEr3xkif6r7GrXGu6Fgxg614nPGCiyryTjtIn80r 8nM/1KFi/KJASlIntwMKfNOvGli6FuOnrg8O61S7K+z2Ie5SOZI5ZE0xNr8yg6NguMw/mf lsEadyaOuyludW798BVQ6bPUEPyC9LU6U415Nf74tAMvqgznZH4fAqPemNp7oaNsiKzQBr qFCCaevFGaGRRNR5zBO/DLG3ex6ryM3Ez0Xfl3/rFwanosFQCYSKnVks5I8Tiw93sUyRTY x7Oa39TLvtWnpr38vSOaAvG7jjmfpX4ixzLvN9fQJIUz9wl97vY6NaCwcxZAnw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=b3OQo0Ih; 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" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1715360840; 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=OAk2Zn6X/u7g1fvU9MMGhYvy4sZzRIMpE1Uy/NRmahA=; b=h+WiPQ/7lXg0EaUsRT9gFtMbsfWvt1huqPrGg7If+hgCi9wbgPeRF/uHoHCHUtSRJ8Fk9O TZiD2RwpIwgzvyeCnrmY6u3hclA4tJtY248C9JjkHtQ9w2YeDccvarHobeykjHzemvoplI AnhPpLb8bhlS2h1ncPF8Hc1AzypObyEQq1q2vMV0ExfiI08jGvO6mo1qAf16WKySZHsyE2 xghY3fypnMotB1DevP6+ZCtWytMiXqjVg0EDjh+ui6tj9duMByLLwjC4iJalBIg1wJ89d0 3pVwrQ2qspioJGY6Zyt58IYTTbZzLyakIpAOaEDtSDixLwZF3f2SJH4X0frjIQ== 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 7B31332C82 for ; Fri, 10 May 2024 19:07:20 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1s5Thd-0001cD-6Q; Fri, 10 May 2024 13:06:38 -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 1s5ThY-0001ZP-NN for emacs-orgmode@gnu.org; Fri, 10 May 2024 13:06:33 -0400 Received: from mail-ot1-x329.google.com ([2607:f8b0:4864:20::329]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1s5ThW-0008Bp-PE for emacs-orgmode@gnu.org; Fri, 10 May 2024 13:06:32 -0400 Received: by mail-ot1-x329.google.com with SMTP id 46e09a7af769-6f05b8fc6c1so1184439a34.0 for ; Fri, 10 May 2024 10:06:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1715360787; x=1715965587; darn=gnu.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=OAk2Zn6X/u7g1fvU9MMGhYvy4sZzRIMpE1Uy/NRmahA=; b=b3OQo0IhCBtviEy54RPhQ/Ra8R8cNm1tdKkBiUmtWu2qBC26drFI+xGXCR4U+NVXr6 +6ERgIo7LttaRFbtnlfmszot3mVrj7fqPi0RVOzP58bU/lWuLDidKAej53m+y7CfDsIs frUbpHPwjFupE06eVfnuLanci+5zDeM+7BS0QN/DHGCjNagD3yTd4zAmOcUO53r4J2m5 E0hd7sq59VvPe2ma4hFi+qTmbZady6GZb50AwZeuoEczkK+TuqSkG7Y6F2UAL73LdDvs RsXLASc5jAKjdS0uX+wN+jReH5Q7UsJuwEephLXW7KhzVP8RoSLOz97FxfU1obtH7kVN DRNg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1715360787; x=1715965587; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=OAk2Zn6X/u7g1fvU9MMGhYvy4sZzRIMpE1Uy/NRmahA=; b=puvIoGlssK4r9xecg0VQB3zAJoxfQWbxDLKBX245sCPauzDWCyWjHZ3JzO5Ffg/9qC qQLnAvsExse0BEfhOUTwe+2SIAASxWCqwreN1n5Rt+9FqRrIDz1vSdGdoIWd4qhrpudH pSl5BzhUrY8z8HPOSjEtaR7srGatbumhJaPkX7/JAtSZVj66C8rGJdigrkoXq1duPJ0V Gt5XAGZj4Bt+AdXcn55P4F0US2bhOiQIXxENHDyF4OW0eLVSo2SljvrtwKn8H71L+aIU VmHhT1Rtmugo9ualkYE2kb11lMEPXvD+kn23ZnRmfhGXjMyPnLyeXemT7zvYLq+7s2N+ eIzQ== X-Gm-Message-State: AOJu0Yw53Zlpr9hTPXFW/xHa8Npdp7fVIbKQIpoPxDcL4cy4Sk2Emq8/ 6usxmfZY2k5MGBFTQc5HaOultUVMtHkrJvoVUDg43dqwNX0M0buFvccyLrXquHK3kxfQEjv/kqL fagJPceyDDbcGp4fzyRx4iAtrcrOzn8SkNDM= X-Google-Smtp-Source: AGHT+IGqCnKwHwup1hrPXlThiRdt9fYQcSsaC0p2jNXw1bZwbgOp22RbG/tk0YQYAFDOFh18WbhZqCPVUjuczTgUTwY= X-Received: by 2002:a05:6830:1086:b0:6f0:e313:5bc4 with SMTP id 46e09a7af769-6f0e9106849mr3542290a34.6.1715360787214; Fri, 10 May 2024 10:06:27 -0700 (PDT) MIME-Version: 1.0 References: <87a5l3wcqf.fsf@localhost> In-Reply-To: <87a5l3wcqf.fsf@localhost> From: =?UTF-8?Q?Andr=C3=A1s_Simonyi?= Date: Fri, 10 May 2024 19:06:16 +0200 Message-ID: Subject: Re: [PATCH] org-manual: Rewrite opening section in Citation handling To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2607:f8b0:4864:20::329; envelope-from=andras.simonyi@gmail.com; helo=mail-ot1-x329.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 X-Migadu-Queue-Id: 7B31332C82 X-Migadu-Scanner: mx12.migadu.com X-Migadu-Spam-Score: -8.21 X-Spam-Score: -8.21 X-TUID: JzO7EaO6d3o0 Dear Ihor, thanks for working on this, I agree that the current version, especially the introduction, was too technical, so that is a very good direction to take. Some comments on the proposed changes: > Org mode will gather citation metadata from =3D#+bibliography=3D database > and use it to typeset the exported document in arbitrary formats. > For example, below snippet shows ASCII export output. Hopefully native speakers will chime in, but the phrase "below snippet" sounds strange to me, I feel that "the snippet below" would be a better solution. Also, maybe a "the" could be inserted before "=3D#+bibliography=3D database". > Org mode ships with several built-in citation processors tailored to > work with LaTeX export and BiBTeX bibliographies (=3Dbibtex=3D, > =3Dbiblatex=3D, and =3Dnatbib=3D processors), or with more generic Citati= on > Style Language bibliographies (=3Dcsl=3D processor). Perhaps the second part of the sentence would be a bit more precise along the following lines: "or with more generic bibliography and citation formats described using/in the Citation Style Language (=3Dcsl=3D processor)" and maybe "Citation Style Language" could link to the CSL site https://citationstyles.org/. > The default citation processor is =3Dbasic=3D - it works with arbitrary > export formats and recognized both BiBTeX and CSL bibliographies. Here I think there is a typo as "recognized" should be "recognizes". > At least one =3DPRINT_BIBLIOGRAPHY=3D keyword must be present in the > document to render citations on export. That is not true in general, as the csl processor and most probably some others too can render citations without a bibliography; there are even citation styles (typically, note-based ones) that are designed to work without a bibliography and specify all bibliographic data in citations. Because of this I suggest removing or at least rewriting this sentence. best wishes, Andr=C3=A1s On Mon, 6 May 2024 at 10:44, Ihor Radchenko wrote: > > Hi, > > The current version of Citation handling section of the manual is rather > technical. I tried to rewrite it aiming for ordinary users not familiar > with Org mode internals. > > Please, let me know if it reads better. > > > -- > Ihor Radchenko // yantar92, > Org mode contributor, > Learn more about Org mode at . > Support Org development at , > or support my work at