Bug 197975 - textproc/mgdiff take MAINTAINERship
Summary: textproc/mgdiff take MAINTAINERship
Status: Closed FIXED
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Jan Beich
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-02-24 01:19 UTC by Chris Hutchinson
Modified: 2015-02-24 16:18 UTC (History)
1 user (show)

See Also:


Attachments
svn diff for textproc/mgdiff (16.50 KB, patch)
2015-02-24 01:19 UTC, Chris Hutchinson
no flags Details | Diff
QA session LOG for textproc/mgdiff (33.47 KB, text/plain)
2015-02-24 01:20 UTC, Chris Hutchinson
no flags Details
svn diff for textproc/mgdiff [UPDATED] as per Jan Beich' recommendations (16.62 KB, patch)
2015-02-24 14:48 UTC, Chris Hutchinson
no flags Details | Diff
svn diff for textproc/mgdiff [UPDATED] as per Jan Beich' recommendations (16.62 KB, patch)
2015-02-24 14:50 UTC, Chris Hutchinson
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Chris Hutchinson 2015-02-24 01:19:23 UTC
Created attachment 153408 [details]
svn diff for textproc/mgdiff

I use this, and have improved the current FreeBSD
port installation. So I thought I'd like to
Maintain it. I think there are additional improvements
that can be made, maybe even make a Gtk3 counterpart.

Changes worth noting:
adds a color icon
creates a mgdiff.desktop entry
MAINTAINER
WWW

Changes
Makefile
pkg-descr
pkg-plist

Adds
files/mgDIFF-48x48.xpm

Removes
files/pkg-message

Please find svn diff, and QA session LOG, attached,
for necessary bits to make this happen.

Thanks!

--Chris
Comment 1 Chris Hutchinson 2015-02-24 01:20:29 UTC
Created attachment 153409 [details]
QA session LOG for textproc/mgdiff
Comment 2 Jan Beich freebsd_committer freebsd_triage 2015-02-24 13:39:29 UTC
Comment on attachment 153408 [details]
svn diff for textproc/mgdiff

> USES=		imake motif
> USE_XORG=	ice sm x11 xext xmu xp xt
>-SUB_FILES=	pkg-message
> 
>+DESKTOP_ENTRIES=	"mgdiff" "GUI front end to the UNIX diff command" \
>+			"mgDIFF-48x48" \
>+			"mgdiff" "GNOME;GTK;Motif;Development;System;" \

Why the app is listed in GNOME and GTK categories but has no such dependencies?

>+WWW: http://BSDforge.com/projects/textproc/mgdiff/

WWW doesn't match MASTER_SITES. Did you take upstream maintainership as well?

> post-install:
>-	@${MKDIR} ${STAGEDIR}${PREFIX}/lib/X11/mgdiff
>-	${INSTALL_DATA} ${WRKSRC}/mgdiff.x[bp]m ${STAGEDIR}${PREFIX}/lib/X11/mgdiff
>+	@${MKDIR} ${STAGEDIR}${PREFIX}/share/pixmaps
>+	${CP} ${FILESDIR}/mgDIFF-48x48.xpm ${STAGEDIR}${PREFIX}/share/pixmaps/mgDIFF-48x48.xpm

Why different case: mgDIFF vs. mgdiff? share/pixmaps icons aren't themed, so Icon=mgdiff-48x48 in .desktop file won't match other colorless variants. Here's a quick test for Gtk behavior via attachment 153255 [details]

  $ icon-lookup
  usage: icon-lookup icon_theme icon_name size flags

  $ icon-lookup test mgdiff 0 0
  /usr/local/share/pixmaps/mgdiff.xpm
  $ icon-lookup test mgdiff 48 0
  /usr/local/share/pixmaps/mgdiff.xpm

  $ icon-lookup test mgdiff-48x48 0 0
  /usr/local/share/pixmaps/mgdiff-48x48.xpm
  $ icon-lookup test mgdiff-48x48 48 0
  /usr/local/share/pixmaps/mgdiff-48x48.xpm

>+	${INSTALL_DATA} ${WRKSRC}/mgdiff.x[bp]m ${STAGEDIR}${PREFIX}/share/pixmaps

Note, XBM format isn't supported by Icon Theme spec (v0.11). And mgdiff.xbm is already embedded in the binary.

  $ fgrep -r .xbm .
  ./Makefile.ini:MISC     = Makefile Imakefile mgdiff.xbm Mgdiff.ad
  ./Makefile.ini:mgdiff.o : mgdiff.c mgdiff.h externs.h patchlevel.h mgdiff.xbm
  ./mgdiff.c:#include "mgdiff.xbm"
Comment 3 Jan Beich freebsd_committer freebsd_triage 2015-02-24 13:56:50 UTC
Comment on attachment 153408 [details]
svn diff for textproc/mgdiff

Also bump PORTREVISION for the following changes aren't cosmetic:
- Provide .desktop file
- Add 48x48 color icon
- Drop pkg-message by moving icons under share/pixmaps

>+	${CP} ${FILESDIR}/mgDIFF-48x48.xpm ${STAGEDIR}${PREFIX}/share/pixmaps/mgDIFF-48x48.xpm

Use INSTALL_DATA like the line below.

>+	${INSTALL_DATA} ${WRKSRC}/mgdiff.x[bp]m ${STAGEDIR}${PREFIX}/share/pixmaps
Comment 4 Chris Hutchinson 2015-02-24 14:26:36 UTC
(In reply to Jan Beich from comment #2)
> Comment on attachment 153408 [details]
> svn diff for textproc/mgdiff
> 
> > USES=		imake motif
> > USE_XORG=	ice sm x11 xext xmu xp xt
> >-SUB_FILES=	pkg-message
> > 
> >+DESKTOP_ENTRIES=	"mgdiff" "GUI front end to the UNIX diff command" \
> >+			"mgDIFF-48x48" \
> >+			"mgdiff" "GNOME;GTK;Motif;Development;System;" \
> 
> Why the app is listed in GNOME and GTK categories but has no such
> dependencies?
It's just a standard template I use. No harm comes from listing them.
No warnings will be emitted either.
> 
> >+WWW: http://BSDforge.com/projects/textproc/mgdiff/
> 
> WWW doesn't match MASTER_SITES. Did you take upstream maintainership as well?
Upstream hasn't, to the best of my knowledge, *ever* provided a WWW. As a
WWW wasn't provided in src, or the port, I felt others would benefit
from having one. As to take upstream maintenance; I'm waiting to see
if the original author expresses any objection (I've contacted him).
> 
> > post-install:
> >-	@${MKDIR} ${STAGEDIR}${PREFIX}/lib/X11/mgdiff
> >-	${INSTALL_DATA} ${WRKSRC}/mgdiff.x[bp]m ${STAGEDIR}${PREFIX}/lib/X11/mgdiff
> >+	@${MKDIR} ${STAGEDIR}${PREFIX}/share/pixmaps
> >+	${CP} ${FILESDIR}/mgDIFF-48x48.xpm ${STAGEDIR}${PREFIX}/share/pixmaps/mgDIFF-48x48.xpm
> 
> Why different case: mgDIFF vs. mgdiff?
Cause it was easier for me to [visually] differentiate it.
> share/pixmaps icons aren't themed, so
> Icon=mgdiff-48x48 in .desktop file won't match other colorless variants.
> Here's a quick test for Gtk behavior via attachment 153255 [details]
> 
>   $ icon-lookup
>   usage: icon-lookup icon_theme icon_name size flags
> 
>   $ icon-lookup test mgdiff 0 0
>   /usr/local/share/pixmaps/mgdiff.xpm
>   $ icon-lookup test mgdiff 48 0
>   /usr/local/share/pixmaps/mgdiff.xpm
> 
>   $ icon-lookup test mgdiff-48x48 0 0
>   /usr/local/share/pixmaps/mgdiff-48x48.xpm
>   $ icon-lookup test mgdiff-48x48 48 0
>   /usr/local/share/pixmaps/mgdiff-48x48.xpm
Thanks!
> 
> >+	${INSTALL_DATA} ${WRKSRC}/mgdiff.x[bp]m ${STAGEDIR}${PREFIX}/share/pixmaps
> 
> Note, XBM format isn't supported by Icon Theme spec (v0.11). And mgdiff.xbm
> is already embedded in the binary.
> 
>   $ fgrep -r .xbm .
>   ./Makefile.ini:MISC     = Makefile Imakefile mgdiff.xbm Mgdiff.ad
>   ./Makefile.ini:mgdiff.o : mgdiff.c mgdiff.h externs.h patchlevel.h
> mgdiff.xbm
>   ./mgdiff.c:#include "mgdiff.xbm"
I intended to incorporate the new colored one globally. But need to add
more applications to the box I'm developing on, in order to create the
SVG format I intend to use. The box I develop on is slated for an
update [FreeBSD] so decided to wait until then, before adding the
additional applications. The one I provided, will suffice during the
[short] interim.

Thanks for all your attention to this, Jan Beich.

--Chris
Comment 5 Chris Hutchinson 2015-02-24 14:48:10 UTC
Created attachment 153436 [details]
svn diff for textproc/mgdiff [UPDATED] as per Jan Beich' recommendations

I think this will pretty much satisfy your comments
above.

PORTREVISION
change case of icon && install method

Next version gets consistent, && colored icons!

Thanks again, for taking the time to look at this, Jan Beich.

--Chris
Comment 6 Chris Hutchinson 2015-02-24 14:49:11 UTC
(In reply to Chris Hutchinson from comment #5)
> Created attachment 153436 [details]
> svn diff for textproc/mgdiff [UPDATED] as per Jan Beich' recommendations
> 
> I think this will pretty much satisfy your comments
> above.
> 
> PORTREVISION
> change case of icon && install method
> 
> Next version gets consistent, && colored icons!
> 
> Thanks again, for taking the time to look at this, Jan Beich.
> 
> --Chris

forgot to tick the obsoletes... box.
sorry.
Comment 7 Chris Hutchinson 2015-02-24 14:50:23 UTC
Created attachment 153437 [details]
svn diff for textproc/mgdiff [UPDATED] as per Jan Beich' recommendations

There. That should get it.
Comment 8 commit-hook freebsd_committer freebsd_triage 2015-02-24 15:29:00 UTC
A commit references this bug:

Author: jbeich
Date: Tue Feb 24 15:28:00 UTC 2015
New revision: 379808
URL: https://svnweb.freebsd.org/changeset/ports/379808

Log:
  - Provide .desktop file
  - Drop pkg-message by moving icons under share/pixmaps
  - Add 48x48 color icon
  - Add WWW link
  - Define LICENSE
  - Fix spelling of UNIX
  - Pass maintainership

  PR:		197975
  Submitted by:	Chris Hutchinson <portmaster@bsdforge.com>

Changes:
  head/textproc/mgdiff/Makefile
  head/textproc/mgdiff/files/mgdiff-48x48.xpm
  head/textproc/mgdiff/files/pkg-message.in
  head/textproc/mgdiff/pkg-descr
  head/textproc/mgdiff/pkg-plist
Comment 9 Jan Beich freebsd_committer freebsd_triage 2015-02-24 15:30:54 UTC
Thanks. Committed after fixing a few typos.
Comment 10 Chris Hutchinson 2015-02-24 16:18:03 UTC
(In reply to Jan Beich from comment #9)
> Thanks. Committed after fixing a few typos.

Thank you, Jan Beich!

--Chris