Bug 267268

Summary: sysutils/libudisks: Rework port
Product: Ports & Packages Reporter: Daniel Engberg <diizzy>
Component: Individual Port(s)Assignee: Daniel Engberg <diizzy>
Status: Closed FIXED    
Severity: Affects Only Me CC: diizzy, eduardo, grahamperrin, pauamma
Priority: --- Keywords: needs-qa
Version: LatestFlags: pauamma: maintainer-feedback+
Hardware: Any   
OS: Any   
Attachments:
Description Flags
Patch for libudisks
none
Patch for libudisks v2
none
Patch for libudisks v3 pauamma: maintainer-approval+

Description Daniel Engberg freebsd_committer freebsd_triage 2022-10-22 11:56:05 UTC
Created attachment 237521 [details]
Patch for libudisks

- Use upstream release archive as recommended by Porters Handbook (USE_GITHUB section) which also removes dependency of gtk-doc
- Update comments in Makefile
- Use framework helpers for DOCS
- Rearrange Makefile to improve readability

Compile tested on FreeBSD 13.1-STABLE
Comment 1 Daniel Engberg freebsd_committer freebsd_triage 2022-10-22 11:57:21 UTC
I have a Poudriere build running but it'll take some time (5-6h or so) as it pulls in rust it and my box is slow. You can of course review the changes irregardless.
Comment 2 Daniel Engberg freebsd_committer freebsd_triage 2022-10-22 14:20:13 UTC
Created attachment 237525 [details]
Patch for libudisks v2

Cosmetic change, make portlint happy
Comment 3 Daniel Engberg freebsd_committer freebsd_triage 2022-10-22 15:51:16 UTC
Created attachment 237530 [details]
Patch for libudisks v3

Fix dependencies and options for building udisksctl's manpage

Poudriere testport OK 12.3-RELEASE (amd64)
Comment 4 Daniel Engberg freebsd_committer freebsd_triage 2022-10-22 15:53:27 UTC
Not sure how if its worth making a separate option for manpage(s) but that's what pulls in gtk-doc and friends.
Comment 5 Pau Amma 2022-10-23 13:55:41 UTC
It's going to take me some time to understand your changes, but I welcome the opportunity, if only because it may point out to parts of the PHB I misunderstood, and perhaps to ways to make them clearer.

(In reply to Daniel Engberg from comment #4)
I'm fine with adding MANPAGES as a default option (or a default if UDISKSCTL is built), assuming it only pulls in gtk-doc for building.
Comment 6 Pau Amma 2022-10-24 06:44:26 UTC
(In reply to Pau Amma from comment #5)

Noting here that when I was slogging through the PHB while working on the initial port 3 years ago, I got the impression that "If the distribution file comes from a specific commit or tag on GitHub for which there is no officially released file" (https://docs.freebsd.org/en/books/porters-handbook/makefiles/#makefile-master_sites-github) applied in whatever wording it had then. (The GitHub UI may have been misleading or confusing me.) So no clarification needed there.
Comment 7 Pau Amma 2022-10-24 17:50:48 UTC
Comment on attachment 237530 [details]
Patch for libudisks v3

Patch looks good to me. Noting that since I'm still mentored as a doc committer and not a ports committer at all, it's probably faster for one to take care of the rest.
Comment 8 commit-hook freebsd_committer freebsd_triage 2022-10-30 20:07:25 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/ports/commit/?id=9e33b6856e0e9fe01cb064db9488e137fe4e7b40

commit 9e33b6856e0e9fe01cb064db9488e137fe4e7b40
Author:     Daniel Engberg <diizzy@FreeBSD.org>
AuthorDate: 2022-10-30 19:52:48 +0000
Commit:     Daniel Engberg <diizzy@FreeBSD.org>
CommitDate: 2022-10-30 20:05:13 +0000

    sysutils/libudisks: Rework port

    - Use upstream release archive as recommended by Porters Handbook
      (USE_GITHUB section) which also removes dependency of gtk-doc
      except when UDISKSCTL is enabled
    - Update comments in Makefile
    - Use framework helpers for DOCS
    - Rearrange Makefile to improve readability

    PR:             267268
    Reviewed by:    pauamma (maintainer)

 sysutils/libudisks/Makefile  | 46 +++++++++++++++------------------
 sysutils/libudisks/distinfo  |  6 ++---
 sysutils/libudisks/pkg-plist | 61 --------------------------------------------
 3 files changed, 24 insertions(+), 89 deletions(-)
Comment 9 Daniel Engberg freebsd_committer freebsd_triage 2022-10-30 20:58:57 UTC
Committed, thanks