Re: git: fb36cfdfb2 - main - Add gitref macro to reference a git hash

Daniel Ebdrup Jensen <[email protected]> Sun, 14 Feb 2021 09:26:42 +0100

Newsgroups	gmane.os.freebsd.devel.cvs.doc
Message-ID	<[email protected]>

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=fb36cfdfb2dd5e9ebe217d820609d96fb73d8cc8
>
>commit fb36cfdfb2dd5e9ebe217d820609d96fb73d8cc8
>Author:     Sergio Carlavilla Delgado <[email protected]>
>AuthorDate: 2021-02-13 21:16:57 +0000
>Commit:     Sergio Carlavilla Delgado <[email protected]>
>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="src|doc|ports",length=hash-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 
implemented this via shortcodes in commit 5476df45eb06, but this is 
clearly the superior solution.

I'll revert what I added, when I do a pass on the release notes, which 
I'll go do now. :)

Yours,
Daniel Ebdrup Jensen

signature.asc (application/pgp-signature, 618 B)