yq: documentation & completion

[danchr]

Description

Partly inspired by the Debian rules, which also include a manual page and the license file. While at it, I also added shell completion and the bundled examples.

I included a patch to suppress an issue where showing the manual which trigger a warning:

$ man yq
This manpage is not compatible with mandoc(1) and might display incorrectly.

Type(s)

• bugfix
• enhancement
• security fix

Tested on

macOS x.y
Xcode x.y / Command Line Tools x.y.z

Verification

Have you

• followed our Commit Message Guidelines?
• squashed and minimized your commits?
• checked that there aren't other open pull requests for the same change?
• referenced existing tickets on Trac with full URL in commit message?
• checked your Portfile with port lint --nitpick?
• tried existing tests with sudo port test?
• tried a full install with sudo port -vst install?
• tested basic functionality of all binary files?
• checked that the Portfile's most important variants haven't been broken?

[macportsbot]

Notifying maintainers:
@herbygillot for port yq.

[herbygillot]

It looks like the depends_build statement you added for pandoc is overwriting the one implicitly set by the golang portgroup.

Try changing it to depends_build-append.

[mascguy]

It looks like the depends_build statement you added for pandoc is overwriting the one implicitly set by the golang portgroup.

Try changing it to depends_build-append.

Yep, this explains why go isn't being found:

sh: /opt/local/bin/go: No such file or directory

[danchr]

It looks like the depends_build statement you added for pandoc is overwriting the one implicitly set by the golang portgroup.

Try changing it to depends_build-append.

Ah, sorry, what a rookie mistake 😁 Fixed!

[mascguy]

It looks like the binaries for pandoc may be stale:

dyld[3845]: Library not loaded: /opt/local/lib/libz.1.dylib

Referenced from: /opt/local/bin/pandoc

[herbygillot]

It looks like the binaries for pandoc may be stale:

dyld[3845]: Library not loaded: /opt/local/lib/libz.1.dylib

Referenced from: /opt/local/bin/pandoc

This looks like pandoc needs an explicit dependency listed for zlib, which it currently doesn't have: https://ports.macports.org/port/pandoc/details/

[danchr]

Oddly enough, the build still fails on macOS 14? 🤔

[herbygillot]

Oddly enough, the build still fails on macOS 14? 🤔

I think we're still seeing issues with pandoc, unfortunately.