source: git/doc/HACKING.htm

Last change on this file was b1c66e1, checked in by Olly Betts <olly@…>, 7 weeks ago

Use wx 3.2.4 for mingw build

  • Property mode set to 100644
File size: 5.6 KB
Line 
1<HTML><HEAD>
2<TITLE>Survex Hacker's Guide</TITLE>
3<STYLE type="text/css"><!--
4BODY, TD, CENTER, UL, OL {font-family: sans-serif;}
5-->
6</STYLE>
7</HEAD><BODY BGCOLOR=white TEXT=black>
8<H1>Hacking Survex</H1>
9
10<p>(That's hacking in the "tinkering with code" sense, not in the
11"breaking into other people's computer systems" sense).
12
13<p>This is currently a random collection of notes that need to be written
14down while I remember.  With time it should evolve into a more
15coherent document.  If you have any questions which this should answer
16but doesn't then ask me and I'll add them.
17
18<H2>Network code debugging</H2>
19
20<P>You can pick which network simplifications are attempted using "-z"
21with an argument listing code letters.  So:
22
23<ul>
24<li>-z=    no special simplifications (articulation still performed)
25<li>-z=l   remove "lollipops"
26<li>-z=p   remove parallel legs
27<li>-z=d   convert deltas to stars
28</ul>
29
30<P>And you can combine these in any combination:
31
32<ul>
33<li>-z=lp  remove "lollipops" and parallel legs
34<li>-z=lpd remove "lollipops" and parallel legs; convert deltas to stars
35</ul>
36
37<P>"-z=lpd" is the default (in 0.99 at least - more transformations may
38conceivably be added in future, although the simple common cases are
39already covered).
40
41<H2>Developing on Unix Platforms</H2>
42
43<P>You'll need automake 1.5 or later (earlier versions don't support
44per-executable CFLAGS; 1.6 has been tested and works, but wasn't a
45very stable release - automake 1.6.1 is a better bet)
46and autoconf 2.50 or later (autoconf 2.52, 2.53, 2.64 and 2.71 have all
47been used successfully).
48
49<p>The wxWidgets library is used for aven's UI.  Currently >= 3.0.0 is
50supported.
51
52<p>The PROJ library is used for coordinate conversions.  Currently >= 6.2.0 is
53supported.
54
55<P>The Perl Locale::PO module is used for process message translation files.
56
57<P>For building the documentation you'll need docbook-utils (also
58known as docbook-tools) and w3m.
59
60<P>And for building unifont.pixelfont, you'll need unifont installed.
61
62<P>On Debian, you can install the required packages using:
63
64<pre>
65sudo apt-get install autoconf automake liblocale-po-perl libproj-dev libwxgtk3.0-gtk3-dev inkscape netpbm docbook-utils w3m unifont
66</pre>
67
68<H2>Building on Non-Unix Platforms</H2>
69
70<H3>Mingw (Microsoft Windows)</H3>
71
72<P>Currently I build this with a Linux hosted cross-compiler.  I use
73the packaged cross-compiler in the debian testing/unstable distribution:
74
75<pre>
76sudo apt-get install mingw-w64-i686-dev
77</pre>
78
79<p>
80I then install the various libraries by compiling from source.  For wxWidgets
81I apply a
82<a href="https://survex.com/software/wxWidgets-3.2.4.patch">patch</a> to
83disable a pointless and annoying compiler ABI check
84(with this check aven stops working each time my cross compiler package is
85upgraded to a new GCC version; without it everything works fine).
86</p>
87
88<p>
89Then I configure, build and install with:
90</p>
91
92<pre>
93./configure --prefix=/usr/i686-w64-mingw32 --host i686-w64-mingw32 --with-msw --with-opengl --enable-display --disable-shared host_alias=i686-w64-mingw32 DOCBOOK_TO_MAN="xmlto man --skip-validation"
94make
95sudo make install
96</pre>
97
98<p>
99For sqlite (needed by PROJ):
100</p>
101
102<pre>
103wget https://www.sqlite.org/2021/sqlite-autoconf-3360000.tar.gz
104tar xvf sqlite-autoconf-3360000.tar.gz
105mkdir BUILD
106cd BUILD
107../configure --prefix=/usr/i686-w64-mingw32 --host i686-w64-mingw32 --disable-shared --disable-fts4 --disable-fts5 --disable-json1 --disable-rtree host_alias=i686-w64-mingw32
108make
109sudo make install
110</pre>
111
112<p>
113For PROJ 8.2.0 (TIFF apparently useful for some grids, but would also need libtiff):
114</p>
115
116<pre>
117mkdir BUILD
118cd BUILD
119../configure --prefix=/usr/i686-w64-mingw32 --host i686-w64-mingw32 --disable-shared host_alias=i686-w64-mingw32 --without-curl --disable-tiff
120make
121sudo make install
122</pre>
123
124<p>
125For ffmpeg 4.4.1:
126</p>
127
128<pre>
129sudo apt-get install yasm
130mkdir BUILD
131cd BUILD
132../configure --prefix=/usr/i686-w64-mingw32 --cross-prefix=i686-w64-mingw32- --enable-cross-compile --target-os=mingw32 --arch=i686 --disable-shared --disable-decoders --disable-demuxers --disable-programs --disable-network --disable-bsfs --disable-protocols --disable-devices
133make
134sudo make install
135</pre>
136
137<P>Building on Windows in a native mingw environment will probably
138require tinkering.  Best bet is probably to install bash and use the
139current configure script.  I'm happy to help if you want to try this,
140and I'll incorporate patches provided they're fairly clean.
141
142<H2>Microsoft Windows Installer Builder</H2>
143
144<P>We use <A HREF="http://www.jrsoftware.org/isinfo.php">InnoSetup</A> to
145build the MS Windows Installer.  Survex 1.4.2 was built using InnoSetup
1466.2.0.
147
148<P>Here are some random notes:
149
150<H3>Packages Needed</H3>
151
152<P>On Debian unstable/testing:
153
154<pre>
155sudo apt-get install wine wx3.0-i18n
156</pre>
157
158<P>And then run:
159
160<pre>
161wine ~/Downloads/innosetup-6.2.0.exe
162</pre>
163
164<H3>Translations</H3>
165
166<P>In addition to the translations included with InnoSetup as standard, we also
167add these, which you can find in the <code>lib</code> subdirectory of Survex's
168source tree:
169
170<UL>
171<li>ChineseSimplified.isl (6.1.0+)
172<li>ChineseTraditional.isl (6.1.0+)
173<li>EnglishBritish.isl (6.1.0+)
174<li>Greek.isl (6.1.0+)
175<li>Hungarian.isl (6.1.0+)
176<li>Indonesian.isl (6.1.0+)
177<li>Romanian.isl (5.5.3+)
178</UL>
179
180These are taken from the <a href="https://jrsoftware.org/files/istrans/">Inno
181Setup Translations</a> page.
182
183<H3>survex.iss</H3>
184
185<P>This file is generated by configure (from the template survex.iss.in).
186We could instead have a static survex.iss which uses #include to pull in
187a file with the Survex version info in, but the current method works well
188enough so we'll stick with it for now (I suspect #include was introduced since
189we started using InnoSetup).
190
191</BODY></HTML>
Note: See TracBrowser for help on using the repository browser.