From owner-dev-commits-doc-all@freebsd.org Sun Feb 14 08:26:44 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id DCC8054E991 for ; Sun, 14 Feb 2021 08:26:44 +0000 (UTC) (envelope-from debdrup@freebsd.org) Received: from freefall.freebsd.org (freefall.freebsd.org [96.47.72.132]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "freefall.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4DdgLr5zhYz4jw7 for ; Sun, 14 Feb 2021 08:26:44 +0000 (UTC) (envelope-from debdrup@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1613291204; h=from:from: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; bh=W9mZ6qziku8rS2+rL0XkU4s4IVWIAVH8wR9hR9aBYTQ=; b=VQrcWrmkuu9/ZBMPelzV39N4RHYZAudsl5E8udpuRwh6KaZHT7JyvtMbFkBxP2G6Kwrcf3 mG2m81pGzAS15NDtAtim3wAnORg4oSoEUG9zMenyLzCKBH9WpWoDEapA5YyEJ5uE9jZiuK koFDBO/+Nhzmoxx0UiK4OSfTWSbDmbI+r1yd5yZut3zerOIPCee85LWnOt3gzdJMITJ3Z7 9ZnaOHISdwoKK/IT4BK1dqobY/ySg5lEm8ji9ikCYG3j5CEYh8heqH/klDs667Mg/gKz75 T1EMMGe1lqL0jVEfJs5By4Zn3uirs/M8k13yqKIewdGfsqpIhmGGcr96SGkcPw== Received: by freefall.freebsd.org (Postfix, from userid 1471) id C2AAA17B3B; Sun, 14 Feb 2021 08:26:44 +0000 (UTC) Date: Sun, 14 Feb 2021 09:26:42 +0100 From: Daniel Ebdrup Jensen To: dev-commits-doc-all@FreeBSD.org Subject: Re: git: fb36cfdfb2 - main - Add gitref macro to reference a git hash Message-ID: <20210214082642.fxqkrrfc74dfhjwq@nerd-thinkpad.local> Mail-Followup-To: Daniel Ebdrup Jensen , dev-commits-doc-all@FreeBSD.org References: <202102132122.11DLMjKB065979@gitrepo.freebsd.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="eluusl5uvn4s6hnt" Content-Disposition: inline In-Reply-To: <202102132122.11DLMjKB065979@gitrepo.freebsd.org> ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1613291204; h=from:from: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; bh=W9mZ6qziku8rS2+rL0XkU4s4IVWIAVH8wR9hR9aBYTQ=; b=DSTY+XT5J0xvOS2B/N4mzfFaKM/WCbLhOxUcJsQL0c/U5UCLUZZ7BRfFLIZ5siebfmOb6y 0BtioFkjRO1wTa+A7Kup1yBW3kFDpiTKjlyoLtvEOqCqZ/lom4HfS4cnE6RQv1KvbRI1W4 kVuvAQMezso7VyZ+lvNFEXAVBlypeqsBemOnt6ktcjk5eoKWW9m8qacQzZ3Iim+BTQX/7H s6Y51m8J0MdKn6q+bWoIqgE/Jh6LJ4U2Ibx55vRlwmVXt1uCmOSqWSUpebYPraahT+N9Kr L0nizR1azkvjPmfNMUVaCedHnlmX8MuUjuLMAPblRJ50gfDsdJDnuPdT/NpTCw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1613291204; a=rsa-sha256; cv=none; b=UuVcYzA/GSj0Qr2NkCDdT2nY1ZaSzyHR/RI5EOe0Z+T+ymHK/tzN8pKGRrakVpYQWQYtsM W1a8h1RKfAz3I0qTRs56R/iDauDAih9mJ8WPyA91W6z7+OMWI5aOSUpLu5UaBGwPc83qEC 26F1Nd+PcwrR+iof2t1/bmggbq9rvimYKhs+lEHiJEyU0NYbDMY1WMq3KP3PfJ+amJ6kps B+w3MQoDL5GiYdnTTVaZ0f+IsWM42q5Ft48EEh7th+rve4h/EdrtdFh9apQj8S8ti+Ed1c IXkyNTFyoM4pPrnQdLh4uOxag1BkKaHdCtO2F7EQ5o6Oignx2NqQWzBoUiMByw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 14 Feb 2021 08:26:44 -0000 --eluusl5uvn4s6hnt Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Feb 13, 2021 at 09:22:45PM +0000, Sergio Carlavilla Delgado wrote: >The branch main has been updated by carlavilla: > >URL: https://cgit.FreeBSD.org/doc/commit/?id=3Dfb36cfdfb2dd5e9ebe217d82060= 9d96fb73d8cc8 > >commit fb36cfdfb2dd5e9ebe217d820609d96fb73d8cc8 >Author: Sergio Carlavilla Delgado >AuthorDate: 2021-02-13 21:16:57 +0000 >Commit: Sergio Carlavilla Delgado >CommitDate: 2021-02-13 21:22:34 +0000 > > Add gitref macro to reference a git hash > > With this extension a git hash can be easily referenced. > > The porters handbook versions chapter uses this extension > as an example in the FreeBSD 14.0 version table. > > An example of use > > gitref:hash[repository=3D"src|doc|ports",length=3Dhash-longitude] > > The repository should be src, doc or ports. > And if no length it's specified the macro will use 12 characters > of the specified hash. > > PR: 253050 > Submitted by: jhb@ >--- > documentation/config/_default/config.toml | 2 +- > .../books/porters-handbook/versions/chapter.adoc | 8 +++---- > shared/lib/GitReferencesMacro/extension.rb | 25 +++++++++++++++++= +++++ > shared/lib/git-macro.rb | 5 +++++ > website/config/_default/config.toml | 2 +- > 5 files changed, 36 insertions(+), 6 deletions(-) > Hi folks, It appears that there are multiple ways of going about things, because I=20 implemented this via shortcodes in commit 5476df45eb06, but this is=20 clearly the superior solution. I'll revert what I added, when I do a pass on the release notes, which=20 I'll go do now. :) Yours, Daniel Ebdrup Jensen --eluusl5uvn4s6hnt Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmAo3sJfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87pSFAgApIwJeaM1rCgSxhWi7etzvjODLfsU0BnfnFpVci7bhslbcvJkAohW6Obv f41dF8IP5XWT5/G7rYNpAKDiLVYvFyZzg+SArwU35ZennLRrPEAC9dV6dS0RuX9C Z3T4FAbGL4I0wmQsBJhuJYto8wI8rO0OhTV9OuobPFJoFCCqYbqsUzFNrnPsKegb aeObLChMzrU5AwGWkwjYE3E40vkLMNIvkbqBCkMG718SojOByKaxnvUcu4I8CD5f ruHjcld5ufYEhOAL9LteSa1BNYGanZfE1rZXagWz840rkkh+uzBynz1Z+Eh/o7Kz wSBAYZElZyJx0gQ3WvqNLC2iM12Euw== =hslZ -----END PGP SIGNATURE----- --eluusl5uvn4s6hnt--