Bug 245657

Summary: [PATCH] devel/git: build with asciidoctor
Product: Ports & Packages Reporter: Bjorn Neergaard <bjorn>
Component: Individual Port(s)Assignee: Renato Botelho <garga>
Status: Closed FIXED    
Severity: Affects Only Me CC: andymenderunix
Priority: --- Keywords: patch
Version: LatestFlags: bugzilla: maintainer-feedback? (garga)
Hardware: Any   
OS: Any   
Attachments:
Description Flags
asciidoctor.patch none

Description Bjorn Neergaard 2020-04-16 06:44:29 UTC 
Created attachment 213452 [details]
asciidoctor.patch

Python 2 and Asciidoctor are both deprecated and scheduled to be removed from ports at the end of the year -- in addition, upstream has supported the asciidoctor gem as a documentation build tool for some time now. As such, we can switch over to asciidoctor instead in ports.

Currently however, contrib/subtree does not build with asciidoctor 2.x. As such, backport a patch from upstream [1] to enable building with newer versions of asciidoctor. This patch can/should be dropped once upstream includes the aforementioned patch in the next release.


[1]: https://github.com/gitgitgadget/git/pull/600
Comment 1 Andy Mender 2020-04-18 15:20:21 UTC 
(In reply to Bjorn Neergaard from comment #0)
There is an update to textproc/asciidoc to use the Python3 port of the project waiting for review here bug #245723. Would that be worth considering?
Comment 2 Bjorn Neergaard 2020-04-18 16:04:12 UTC 
I do think this is the better route to go -- upstream is moving to asciidoctor as their build tool, instead of asciidoc3, and asciidoc3 installs as a2x3, instead of a2x. As such we would still have to patch git (or have the asciidoctor port install a symlink). If we go this route, once the upstream patch is merged in the next version, no patches/FreeBSD-specific behavior is needed.
Comment 3 Andy Mender 2020-04-19 09:08:58 UTC 
Yes, then I agree that asciidoctor indeed makes more sense for git.
Comment 4 commit-hook freebsd_committer freebsd_triage 2020-05-08 12:32:59 UTC 
A commit references this bug:

Author: garga
Date: Fri May  8 12:32:45 UTC 2020
New revision: 534399
URL: https://svnweb.freebsd.org/changeset/ports/534399

Log:
  devel/git: Use rubygem-asciidoctor to build docs

  asciidoctor and python2 are deprecated and upstream is moving to
  asciidoctor gem as default tool to build documentation

  PR:		245657
  Submitted by:	Bjorn Neergaard <bjorn@neersighted.com>
  Sponsored by:	Rubicon Communications, LLC (Netgate)

Changes:
  head/devel/git/Makefile
  head/devel/git/files/patch-contrib__subtree__Makefile