Need advanced help producing a 4.x palm/guikachu port (revised)

Eric P. Scott eps+guikachu at ana.com
Tue Sep 14 11:00:48 PDT 2004


Guikachu is a graphical tool for laying out Palm OS user
interfaces.  Its only real competition is the Java-based
pilrcedit, which hasn't been updated in about four years.

Guikachu has two branches: "stable" releases are designated
1.4.x; "development" releases, 1.5.x.  There are significant
differences between them, which suggests creating separate
palm/guikachu and palm/guikachu-devel ports.  Note that the 1.4.x
series is based on GNOME 1.4, while the 1.5.x series expects
GNOME 2.6.  The remainder of this document concerns the most
recent stable version, Guikachu 1.4.2.

My intended goal is to have a port that will work on FreeBSD
4.10-RELEASE.  There are specific issues here that may not
pertain to FreeBSD 5.x, so those of you who only develop for 
-CURRENT can stop reading now.

Guikachu is a nontrivial application, with hundreds of source
files and dependencies on about five dozen shared libraries.

The first obstacle you'll run into is that Guikachu will not
build with the compiler in the base system, gcc 2.95.4.  It
requires some flavor of gcc 3.x.  The problem here is that
gcc 2 and gcc 3 produce different (i.e. incompatible) objects
from C++ sources, and they will not link together.  This means
that simply declaring USE_GCC=3.3 is not sufficient; the
configure script will fail.  If you try adding
--disable-gtkmmtest and --disable-sigctest to CONFIGURE_ARGS, the
sources will compile, but the build will die when it gets to the
link stage.

Fortunately, only four of the libraries Guikachu needs are
C++-based, so if those can be built statically, it's possible to
produce viable executables.


For the record, Guikachu's expected prerequisites "should be"

LIB_DEPENDS=	gnomemm-1.2.10:${PORTSDIR}/x11-toolkits/gnome-- \
	Magick++.6:${PORTSDIR}/graphics/ImageMagick
USE_GNOME=      libglade gnomevfs


Guikachu's use of ImageMagick (specifically, libMagick++) makes
things particularly unpleasant.

At the moment, I have a manual package-building procedure.  I'm
almost certainly taking The Wrong Approach, so I'm putting what I
have out there in the hope that someone will figure out The Right
Way and submit it for inclusion in the Ports collection.


How to reproduce what I have on a 4.10-RELEASE system:


Run /stand/sysinstall

Go to Configure > Packages

Select and install the following packages (which should bring in
their dependencies):

gnome > gnomevfs-1.0.5_5
gnome > libglade-0.17_3
graphics > ImageMagick-5.5.7.16_1
lang > gcc-3.3.4_20040411

It is not necessary to install the  gnome > gnomemm-1.2.4_2
package.

You may also find it convenient to fetch an extra copy of
ImageMagick-5.5.7.16_1.tgz at this time.

[No, I haven't looked into what happens if you try to use
ImageMagick 6.whatever.]


Delete the installed copy of ImageMagick:

pkg_delete -v ImageMagick-5.5.7.16_1

(Obviously, if you've installed anything else that depends on
ImageMagick, you'll need to remove it first.)


Make a copy of /usr/ports/graphics/ImageMagick/ somewhere with
enough space to build from source.  You'll need to modify this
copy to build only a static libMagick++ while keeping libMagick
shared.  First, add this patch:

# This is a shell archive.  Save it in a file, remove anything before
# this line, and then unpack it by entering "sh file".  Note, it may
# create directories; files and directories will be owned by you and
# have default permissions.
#
# This archive contains:
#
#	files/patch-cxxstatic
#
echo x - files/patch-cxxstatic
sed 's/^X//' >files/patch-cxxstatic << 'END-of-files/patch-cxxstatic'
X--- Magick++/lib/Makefile.in.orig	Thu Feb  5 16:19:42 2004
X+++ Magick++/lib/Makefile.in	Mon Aug  9 15:06:23 2004
X@@ -76,7 +76,7 @@
X 	$(AM_CXXFLAGS) $(CXXFLAGS)
X CXXLD = $(CXX)
X CXXLINK = $(LIBTOOL) --mode=link $(CXXLD) $(AM_CXXFLAGS) $(CXXFLAGS) \
X-	$(AM_LDFLAGS) $(LDFLAGS) -o $@
X+	$(AM_LDFLAGS) $(LDFLAGS) -static -o $@
X SOURCES = $(libMagick___la_SOURCES)
X DIST_SOURCES = $(libMagick___la_SOURCES)
X RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \
X@@ -403,8 +403,8 @@
X 
X 
X # Add -no-undefined once Cygwin supports throwing C++ exceptions from DLLs.
X-libMagick___la_LDFLAGS = \
X-	-version-info $(LIBRARY_CURRENT):$(LIBRARY_REVISION):$(LIBRARY_AGE)
X+#libMagick___la_LDFLAGS = \
X+#	-version-info $(LIBRARY_CURRENT):$(LIBRARY_REVISION):$(LIBRARY_AGE)
X 
X libMagick___la_LIBADD = ../../magick/libMagick.la
X include_HEADERS = Magick++.h
END-of-files/patch-cxxstatic
exit


Next, adjust the packing list accordingly:

*** pkg-plist.orig	Fri Feb 13 15:10:11 2004
--- pkg-plist
***************
*** 433,440 ****
  lib/ImageMagick/type.mgk
  lib/libMagick++.a
  lib/libMagick++.la
! lib/libMagick++.so
! lib/libMagick++.so.6
  lib/libMagick.a
  lib/libMagick.la
  lib/libMagick.so
--- 433,440 ----
  lib/ImageMagick/type.mgk
  lib/libMagick++.a
  lib/libMagick++.la
! @comment lib/libMagick++.so
! @comment lib/libMagick++.so.6
  lib/libMagick.a
  lib/libMagick.la
  lib/libMagick.so


Build and install this version of the port temporarily:

make USE_GCC=3.3 NOPORTDOCS=yes
make install


Now, we're ready to build Guikachu.  "Be afraid.  Be very
afraid."

begin 644 guikachu-1.4.2-port.tar.gz
M'XL("-*I/T$``V=U:6MA8VAU+3$N-"XR+7!O<G0N=&%R`.U<>W?:N!+??_&G
MT-+T;K*I`?/,IIL](>!03GGD`&E[[]FS/L86Q!N_CFV:I$V_^YV1']A``&?3
M]-X6]8&EF9\TTHQ&(_EAR[J1_^GKID*A7*A5*O#+TN(ONQ8*R%*L%JLU*!>*
MA6+EI\I7EHNEF>O)#C3I6):WCF\3/=FIXM,*^?62C?J?SK1K6;F:?25#V$[_
M0J%:JE6%`M-_J2J4=_I_AI34?U>^IA--IT_;!JBV4"V7'])_I08Z!_T+M5JQ
M7"L64?_@"8#_:<58G7YP_;\@/7I#;,OQ7*)8NDX53[-,8 at 2&0":6<YP)[8-[
M09JR1XGB4/A1CS.9(S*D-BG"#`?:^RO+ at ++,OZV90WJR0<D;ZE#RNVL9=&RI
M=Z>J9<B:F5,LXP_N!0#VSAU*SX;-/<AQ%_W!J%?OBB?SYK#HG3 at 8MON]DXR0
M*^>*7*,^$EO]05L<GF30=LG4A-JY;GTX$@?2L#U"PI7GV<?YO"(KWLS-.3.=
M?LI9SC1O.];?T$%W;O"J=6/JEJSF.:BBW1O!/W$`->-XG`;2(91K]+M=L3<Z
MR0RH"]U3*!%5S;,<'"!R at 8+TA\2]<SUJN!QW+HX:;Z2F>"'VFB#/WN=>OR=^
M:(.,O=&7X[W/V+%ALSWXDE?I1ZKG=6WL:E/E\/!8N:+*M3LSR)]<9AWN5A!X
MS[+T:PV[XUWS_".A.'PIP%-'MJ\TQ<VW#7E*N_)44ZXC,-=IG\U[[1-SU8UX
MCKL<BM('Z6(@GK<_G&3NJ,M*6KT^F@,,SE275>JK^N,D(#8:)YE2KN1GNO6W
MH at _,:1.B at NV:5-U_WQZ]Z5^.I%YG>``:[)VW6Y<#4:H/6L/#DPS/JYHKCW7*
MF[K+772 at N]+P\@PHP'^2/04S-:CID2QW-NB_%<$$,UDHLS5=9G-D(FNZ2VXT
M[XH`@`25J5DN1W67^G*)HY'X8>1+MM0"<IJJ-F&L%^*@4Y'.+MN=YGP$8#Q'
M_7Y'>H=&*?A]'8CMWD6GW at CZV^I=2E'7_*(5/44I>3`3P^!M!T;G]F3O\_O!
M6U0):CQ at 0!M<1_>-!8UU3D;;C;4H]MY!@TQS*+U/D"[JHS<Q"/44F&Z]RWH'
M*(VW]988[SBKK=-NC(9S5\`+N<JO),JQ6</_RG&VY7H\O?4<F.K''!CNJ`X2
M\PVR-,<(#WR*/@,[^N77_(WE7/]">&5">&;QT00D]R1>23@&_*U]-B&$?ZB)
M^)Q:WQ*;JR28=IM:XT`9O"U[RA5T[G3OL]AXT_]"LB<G)^1LINFJ9DX)K%^>
MII!Y#X":13DC0Y$:W294"N+D_VKWAJ-ZIS.4AF]`/?E7 at GO_U_V+^U^">1]3
MJE];%!)PF7U%)2LX7M-;J@`!I^`7$LSAA/5DDC8*.F:EV44[A7$SV7P,NC2?
MH.Z5[%`5"A:-,\MJ"OT!N`,2=%"J#R4H'K#6>GWIXFT+9DX+79I?IIG0BJX?
ML)'JPO`XDU6]VV+8V;1:,^K9_%\QOQ at -.7G-9,__%7=^R]0'%!;2%\8,N\9X
M[O^U-'PQS-)L9YC<YTZ_4>^<U8?BE_N8-2Z-^GUVP5R843]H*HSZ:#-Y>N4R
M>;91+$[22+4\R.[+FG1DWUSG#^D[5J!:BKM"CV2MWU^[:BR;@._1'C8"G_Z_
M9`:^1,$B$O`>LP#BYS""Z/71QS?[C2&K)#(`\4.]>]$1F?-'0N,":K<'?NW#
M00-,XU8V;!UFXZ]+[&!)8'?O>P!!Q/!-?2!B]CBX;@TNEMH((@60SO27EM_'
MKIK#.#5G7/_!/3K^3^[_P%X\S9Q83[C!^&GC_J\@E*OA_J]8*0AL_U<JUW;[
MOV=(W6:%[,>B+-ACY6!`<M-/!^2$@-HJY2.A6*D<R7*QH(Y552 at +<J%X=%0K
MTG*1&[;_(Z[!"WBL5Q,>;YZ[])53<OZCXW:?_!1P^_._8K5:J>+\9^=`N_._
MKY]6Z9]M.'A9?JHV-OA_</]"Z/]+)0'M1*BRWZ<28%WZP?7/PR;TUM!Y33 at R
M>8,Z4PH11LYRM&EF*'ND/IL24B.%\G'IM^/2D7_2=PB;S"5,YCU$G'@82(Z(
M4`/>XU+19S\])3RL(*]JY-#_.3WEB#L;DRGU)-U29%U2(&!UJ<>1SQS!9-R1
M_3UJ*A9&Y+B0G$JO.3Z@[,FZ)KL2.YX\(7MB[]WG;$MJ0.0T%$=2O=.N#[-?
MR/T]!.$SU\&M7#ZH/\>0V=?<X2.K0F&Q0E7VY*5*B2_["^)2>DV0*BL>=4C8
M#\(865A*$EA80*'.`Z@`A^HWH8A#Y?_ at 4&&"F'1_KWO9&;4A(I3ZEZ.+R]%!
M.%J8\!@2.Z3+T-"^"W$AN:9W+GEI6ZQ[KC2^DY#(4)FP3O(S[E9\%%+X3%BA
M<:UJ3D"!NE4--C4-V30M+SC^114""U4\RPD:/B9[/_]IXOBNJN85 at 5B@EKXR
M$D]?DEG+IB;QA^,5R?[!@/D]*#AO=\3L8EN,.\FSNA4<2<^A:!0 at GOK!T/?W
MD/O@]?<6RJSQ_^.G:F.3_Q>JA<C_5PO%P/\+.___#`G]/_-FX;X]<O_HS]']
M"^#/2\=E6`%*<_>_"%GP_L!=*,R]OU`57 at EE<AC\HE-#YR1IIN^;8)J%)IA#
M`E08<(3DO?T$X#AD.V$7Z#IY0S,H^AID1O'@^B"/A3SN:+G#E71V!A#C(G at I
M->NC^KQ1UN+!7$)DP09EV]8UA=T+<)<JCA%YATYA7^W<<8=K(;XL*X$D#@S%
MBP2*$W$5>D':BF5RO`;_+[5B:[>&;+O<X4JJ+T/(0Y!GJ3D;5H1HQQ<7]Y:/
MBG^K(ILO3*MAF1/B*E?4D+\W]_E_G];X?^6IVMC at __'0)_+_M4K at _XL[__\<
M"?V_ZRC;N/_"W/TO(!:]?_6X4(MY_TH9`UK_!WW_\/*LV1X,P:?<:"IL`ER,
M7 at V>^C?4-?#"S>!.:<"VMQ]<'Y#(-7%\N]?H7#9%GZ$U>MOM2HWS3KT%7)#'
M.Y")DG?GPS"7 at 42@Z$.W$X=TZDTQEK]H?SB[/%_$M/!H.L;5K;?:C;<7%W$^
MY.3;>_LP3.A5V;5GV5*0S\-OQ-;T[Y6VH5KHX<F?V>RRL\[^F5U at 9S=JQ&4`
MVZ'0!/]E^VV]\>928MU;1D1SG]UC#Y`)X'F_-UJ#FUBFYZ["C>J#EK at ."1,/
MM,^K=()X[O`'4&AB?8T/VG>K58)_FN)%IWWF*Q9UA)E0A>%U-.YA0:`NEMW%
M#5\IK5G_U:=J8\/Z7ZJ4BM'S?W at OR%__=\__/4<*U__8"KQ-+"`D8X$'T(MQ
M`?P]BL<%@A\7"$%<H-S>3G1YZDHN]?#,+YX'LHYE^NFW6OIW"WH:UY__9BOZ
M;IU^G++80CV6E6MJJCA at H+/8M,Y=00/QO*+X3:(``1$NH'2JW]E7`3E,)*A*
MI_A$)6//).G^3H!1 at LNP`3_+?]3<2(X$P:&3&(QE%Z`S3]/C+"R?%!"8'>IJ
MGR@^+L-X8]FPNGD1/Q=WN9"Q$R+//(M/5KI8%'!Z]-:;R;Z(X7789O"\;$"=
MYY;$U^4Q]9G\J[""\<SS+),1 at DM%(3[)GKE7,7(L&[%`@Y.)YFEAZWXFK-NE
M.CNQYSU8)::4*6>IS*^+$/:0\-BZ955%F:@E77-]];.+H'L at HV7/['C]R8*P
M<E=Q+%T?R[Y]S'.AI#BL_$2CNAJ-<I"-."+->PFEH^&.-0_\0#0%@FRD(CDR
MW>`2*?\G$>N:^._)W at +9=/Y3*$?G/^5BK12<_^^>_WF.%,9_FK5-V%=,AGU)
MT&*T]]NQ4-WJ%.C6T(FCV&N.??Y9S+<01 at 3;_HVAQ"[H>^Z@[ULKZD>-^DP+
MGW[%DY9!'5^M`LWIVEBS<KO[-=][6K/^3YZJC4WG/Z7B?/TO"^']_]WS7\^1
MPO4_N!/SB/M`*Y`+D4"E`+AG/_<)=D;ICQ`RVZPEJ5;\="O((]>/QZT>S[;2
M?TMUK%K7OU>EL`4=5N]@6DJR-.Q?#AI,29XUG>HTVO(GLM&.FYJ><X>[6?\B
M*C=G!A_1YIG83MV=T^>9B(ZG'G.&6"[B8,<COE#1:4F0C7B<X/5K7K&,L05L
M"P4+1S\A5R([%]FQ;.IX=^'>/YF/3CD\1S.G?'A`$<]&->&!`A+9KQ*%FV&%
M\T.TQ9+Y\8,3ES>1C5I!&XE8,K'<PFE04FC>LEW at 7RR),`L$WG:TC]$QVTKB
M6B@?:@3J(-NP!4=`#[!%)VU;,"G*+EY-F9+QGWT]!4_B*LZ3MK'I_:]R at 3W_
M7Z at 4\/L_P?M?M>HN_GN&U`I43S27R(2MB/&'#=ESY=&I,T&GA4^R6Y/($7/^
M(YKA9S#Z0WXLNQ#^V99R#>$<?C!AYE''?>5_*4$F,Y<Z1#.A;"(#'.JAQEC'
M6ENX<.8XKNV_BDGFLDW(G34C-[+IP1I&/FKN#.AW3)R at 579.ZP+X_?OWQV3[
M#X#\Z`YC>?[;Z%J?M(WU\U\0"M5J\/Y7H53PW_^JE,NEW?Q_AC36S$C]7#Q3
MQ!-9ZBGYJ6*9D[S_^.Y\XO#Q>X$!<1U[-.$C9O:2^IJ'GB-L\OGF!9B;;^+7
M/2P;;RS.(;"(7<,^(<%]175[;NJ-O'\;!T(CS]#7,B9N at VYBGG^CQ%)XY,XI
MKKL5(@>(L65=KV763)7>;I8"1F.VM<BV!FX2_'!>5E4,R]BCVUL!_"&$\,M4
MK9NTL*ECS=)C8\K`CQ)\U. at -/W7HG8N[M7]4S>/`_NW<QV']>Z5 at UH^#XQM*
MVR/QTUO!:.-3^^D4'0.G`,6,<&L0+$C4\U+T"[],01UJ*FGZ@]LP7H7_\`-@
M*6&:FA*`CR2D0Z0S*1]B:VD[XF^E'@5BN]]T0+8U3 at GQ-_^;0-$1`!CH9F\7
M<F_A^&<NCL]&MN"H99DQ>J]H[N/QC:)-/.P%HSA/<'(U7UO6OW6S#AIG2!P]
M at 5.>CBU=S7FWWH,,[!F?AQD`OIY#IQL87&\3PYT!S6RB"\(FCMHJ!G9R-Q\J
MEEWDB9^W45RN>3T7*<`G;H;8:2`8HO.*I8,738E:XG_YLM<9OGSIP_P#SKS\
M*6=8^4Y#ZHK#8;TE#F.&:*U$*')JA)L6`1O!E`AJ2HWZ(T"ML[2@:>K^7SFI
M$;.TB+]32V5<IT;H:1%F:H2='N&E1TAG@[0@)[5*W-1J=YW3CNR9J6$?TR*\
MU*+-4EO+S0:+##^M]1)2[&-7+U_F&U>R.:4=:[J6*_K4V#9,.=G8CD\SU_(-
MQ'JS*ZYE<=F7OW"1WD[$&#^+LS'&SRGI(5=;0R`P3]$`<F]=-X17,]US4W8B
M@=JZK?GE]BW%,-&Y1QQZJFJ.8Y"':]B"FPN*MXETM^#=R++`D(AW'J#YL<UJ
;6BR,6,WQHQ^:[M(N[=(N?0?IOX,%KT\`9@``
`
end


Run  make  as a non-root user.  Be warned: this part will
probably take a long time!

As root:

make install
make package

The resulting guikachu-1.4.2.tgz can be redistributed at this
point, but we really should put things back to normal on the
build system:

pkg_delete -v guikachu-1.4.2
pkg_delete -v ImageMagick-5.5.7.16_1

Now you can:

pkg_add -v /path/to/ImageMagick-5.5.7.16_1.tgz
[the real one, if you saved it earlier; otherwise, use sysinstall
as before]

pkg_add -v guikachu-1.4.2.tgz


You should now have a properly installed Guikachu!


Hints:

HTML help installs in /usr/X11R6/share/gnome/help/guikachu/C/

If you're using WindowMaker, copy guikachu.png
(/usr/X11R6/share/gnome/pixmaps/) to ~/GNUstep/Library/Icons/
so you can display an appropriate icon on its application tile.


What's next?  Again, I'm looking for someone else to take over
all responsibility for this port; I've spent as much time on it
as I care to.  Important: I don't recommend committing something
without first figuring out why it crashes (badly!) if you select
a font for a label that uses code points that aren't in the font.
[Discovered in 1.4.1; still not fixed in 1.4.2.]

Minimal case:

Launch guikachu.  Click Add, OK.  Double-click on FORM1.  Click
the large A on the Widget palette.  Then click somewhere on the
form to place the object.  Click again to bring up the label's
Properties.  Change the Font from Regular to Symbol11.  This
will generate either a Bus error or a Segmentation fault.

It's probably really simple to fix, but someone else is going to
have to pursue this.

Please continue discussion on the freebsd-gnome mailing list;
any replies sent directly to me will most likely be discarded
unread due to [necessarily] highly aggressive spam-filtering.

Thanks in advance for your time, and congratulations are in order
for anyone who achieves a successful outcome.

Cheers,

					-=EPS-


More information about the freebsd-ports mailing list