1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
|
<!doctype html>
<html>
<head>
<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-54391264-2"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'UA-54391264-2');
</script>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="https://fonts.googleapis.com/css?family=Source+Sans+Pro" rel="stylesheet">
<link rel="shortcut icon" type="image/png" href="../../images/favicon.png">
<title>How to Build Ghostscript from Source Code</title>
<!-- Originally: make.txt -->
<link href="style.css" rel="stylesheet" type="text/css">
<link href="gs-style.css" rel="stylesheet" type="text/css">
</head>
<body>
<div class="header">
<div class="row">
<div class="col-lt-6 logo"><a href="https://www.ghostscript.com/"><img src="images/ghostscript_logo.png" width="108" height="119" alt=""></a></div>
<div class="col-6"><div class="row"><div class="artifexlogo"><a href="https://artifex.com" target="_blank"><img src="images/Artifex_logo.png" width="194" height="40" alt=""></a></div>
<div class="col-12"><div class="button button1"><a href="https://artifex.com/contact-us/" title="Contact Us" target="_blank">Contact Us</a></div>
<div class="button button2 hidden-xs"><a href="https://www.ghostscript.com/download.html" title="Download">Download</a></div></div></div>
</div>
</div>
</div>
<div class="banner">
<div class="row">
<div class="col-12">How to Build Ghostscript from Source Code</div>
</div>
</div>
<div class="main">
<div class="row">
<div id="sidebar">
<div class="sidebar-item"></div>
<div class="col-2 leftnav">
<ul>
<li><a href="https://www.ghostscript.com/">Home</a></li>
<li><a href="https://www.ghostscript.com/license.html">Licensing</a></li>
<li><a href="https://www.ghostscript.com/releases.html">Releases</a></li>
<li><a href="https://www.ghostscript.com/release_history.html">Release History</a></li>
<li><a href="https://www.ghostscript.com/documentation.html" title="Documentation">Documentation</a></li>
<li><a href="https://www.ghostscript.com/download.html" title="Download">Download</a></li>
<li><a href="https://www.ghostscript.com/performance.html" title="Performance">Performance</a></li>
<li><a href="http://jbig2dec.com/" title="jbig2dec">jbig2dec</a></li>
<li><a href="http://git.ghostscript.com/?p=ghostpdl.git;a=summary">Source</a></li>
<li><a href="http://bugs.ghostscript.com/">Bugs</a></li>
<li><a href="https://www.ghostscript.com/faq.html" title="FAQ">FAQ</a></li>
</ul>
</div>
</div>
<div class="col-10 page">
<!--START EDITING HERE-->
<!-- [1.0 begin visible header] ============================================ -->
<!-- [1.1 begin headline] ================================================== -->
<h1>How to build Ghostscript from source code</h1>
<!-- [1.1 end headline] ==================================================== -->
<!-- [1.2 begin table of contents] ========================================= -->
<h2>Table of contents</h2>
<blockquote><ul>
<li><a href="#General_overview">General overview</a></li>
<li><a href="#Acquiring">How to acquire the source code</a></li>
<ul>
<li><a href="#Acquiring_git">How to acquire the development source code</a></li>
</ul>
<li><a href="#Unpack">How to unpack the source code</a></li>
<ul>
<li><a href="#Tarfiles">How to unpack compressed tar files generally</a></li>
<li><a href="#Unpack_Ghostscript">How to unpack Ghostscript itself</a></li>
</ul>
<li><a href="#Bug_check">How to check for post-release bug fixes</a></li>
<li><a href="#Makefile_overview">How to prepare the makefiles</a></li>
<ul>
<li><a href="#Preparing_makefiles">Changes for your environment</a></li>
<li><a href="#Features_and_devices">Selecting features and devices</a></li>
<ul>
<li><a href="#Precompiled_data">Precompiled run-time data</a></li>
</ul>
<li><a href="#Makefile_setup">Setting up "makefile"</a></li>
<li><a href="#MSys/Mingw">MSys/Mingw</a></li>
<li><a href="#Invoke_make">Invoking "make"</a></li>
<li><a href="#Cross-compiling">Cross-compiling</a></li>
</ul>
<li><a href="#PC_build">How to build Ghostscript from source (PC version)</a></li>
<ul>
<li><a href="#Microsoft_build">Microsoft environment</a></li>
<li><a href="#Microsoft_build_64">Microsoft environment 64-bit</a></li>
<li><a href="#Microsoft_build_winrt">Microsoft environment WinRT</a></li>
<li><a href="#Self-extracting_executables">Making self-extracting Installers</a></li>
<li><a href="#Cygwin32_build">Cygwin32 gcc</a></li>
</ul>
<li><a href="#Mac_build">How to build Ghostscript from source (MacOS version)</a></li>
<ul>
<li><a href="#MacOSX">MacOS X</a></li>
</ul>
<li><a href="#Unix_build">How to build Ghostscript from source (Unix version)</a></li>
<ul>
<li><a href="#GNU_make">make tools</a></li>
<li><a href="#OS_specific_issues">OS-specific issues</a></li>
<ul>
<li><a href="#HP_RISC">H-P RISC workstations</a></li>
<li><a href="#IBMAIX">IBM AIX</a></li>
<li><a href="#Silicon_Graphics">Silicon Graphics</a></li>
<li><a href="#Sun">Oracle/Sun</a></li>
<li><a href="#Solaris">Solaris</a></li>
</ul>
</ul>
<li><a href="#Other_environments">Other environments</a></li>
<ul>
<li><a href="#No_multi_thread">Environments lacking multi-threading</a></li>
<li><a href="#Plan_9">Plan 9</a></li>
</ul>
<li><a href="#UFST_build">How to build Ghostscript with UFST</a></li>
</ul></blockquote>
<!-- [1.2 end table of contents] =========================================== -->
<!-- [1.3 begin hint] ====================================================== -->
<p>For other information, see the <a href="Readme.htm">Ghostscript
overview</a> and the instructions on how to <a href="Install.htm">install
Ghostscript</a>.</p>
<!-- [1.3 end hint] ======================================================== -->
<hr>
<!-- [1.0 end visible header] ============================================== -->
<!-- [2.0 begin contents] ================================================== -->
<h2><a name="General_overview"></a>General overview</h2>
<p>
This document describes how to build a Ghostscript executable from source
code. There are four major steps to building Ghostscript:</p>
<ol>
<li>Acquire the compressed archive files of source code for Ghostscript.</li>
<li>Unpack the archive files into the Ghostscript directory.</li>
<li>Configure the build to match your system and desired configuration options.</li>
<li>Invoke "<code>make</code>" to build the software.</li>
</ol>
<p>
The remainder of this document describes each of these steps in detail.
Note that some of this process is platform-dependent. After building
Ghostscript you must then install it; for that, see the
<a href="Install.htm">installation instructions</a>.</p>
<p>
Long term users of Ghostscript may notice the instructions for a number of
older systems have been removed from this document. There is no value judgment
implied in this, but recognition that the build system has changed considerably
in recent years, and several of these legacy systems are no longer easily
available to the development team. We will always consider contributions to
continue support for legacy systems.</p>
<hr>
<h2><a name="Acquiring"></a>How to acquire the source code</h2>
<p>
Building Ghostscript requires the Ghostscript source code itself, and in
some cases the source code for the third-party libraries that
Ghostscript uses.</p>
<p><a name="Authoritative_distribution_site"></a>
Official releases can be found under the AGPL license at</p>
<blockquote>
<a href="http://ghostscript.com/download/"
class="offsite">http://ghostscript.com/download/</a>
</blockquote>
<p>
Ghostscript source code is packaged in gzip-compressed tar archives (*<code>.tar.gz</code>).
(Unlike earlier versions, Ghostscript packages are now one, complete archive, including font files
and third party library dependency sources).</p>
<blockquote>
<code>ghostscript-</code>#.##<code>.tar.gz</code><br>
</blockquote>
<p>
("#.##" are version numbers.)
Software to decompress and extract both formats is available for almost
every platform for which Ghostscript is available -- including Unix, Linux,
MS Windows, and so on -- but it's up to you to locate that software.
See the section on <a
href="#Unpack">unpacking the source code</a>.</p>
<hr>
<h2><a name="Acquiring_git"></a>How to acquire the development source code</h2>
<p>
The Ghostscript team use <a href="http://git-scm.com/">git</a> for version
control.</p>
<p>
If you require a snapshot of the development code, the easiest way to get it
is to visit the web interface to our <code>git</code> repository:
<a href="http://git.ghostscript.com/?p=ghostpdl.git;a=summary">ghostpdl.git</a>
and click the "<code>snapshot</code>" link next to the specific commit
in which you are interested. After a short delay, that will download a complete
source tree for the given commit in a <code>gzipped</code> <code>tar</code>
archive.</p>
<p>
If you require access to several commits, or wish to regularly access the
latest development code, you are better to clone the entire <code>git</code>
repository, using:</p>
<blockquote>
<code>git clone git://git.ghostscript.com/ghostpdl.git</code>
</blockquote>
<p>which will create a local, read-only repository.</p>
<p>
Both the "<code>snapshot</code>" and the <code>git clone</code> methods
download the <code>Ghostscript</code> sources as part of the <code>GhostPDL</code>
source tree, which includes the <code>PCL/PXL</code> and <code>XPS</code>
interpreters also built on top of the <code>Ghostscript</code> graphics library.</p>
<p>
The <code>configure</code> script discussed later in the document is created as
part of the <code>Ghostscript</code> release process, and as the source tree
retrieved from <code>git</code> is "pre-release" code, it does not
include a pre-made <code>configure</code> script. See <a href="#autogen_sh">autogen.sh</a></p>
<hr>
<h2><a name="Unpack"></a>How to unpack the source code</h2>
<p>
Unfortunately, there are no generally accepted standards for how to package
source code into archives, so the instructions for unpacking Ghostscript are
longer than they should be. We begin with a brief explanation of how to
extract the two kinds of archive files.</p>
<h3><a name="Tarfiles"></a>How to unpack compressed tar files generally</h3>
<p>
Tar (<code>.tar</code>) files are the <em>de facto</em> standard for
archiving files on Unix (every Unix-like system has the <code>tar</code>
program), and programs to extract their contents are also widely available
for MS Windows, and most other environments. To economize on space and downloading
time, Ghostscript's tar files are compressed with GNU <code>gzip</code>, which
adds the suffix "<code>.gz</code>" to the file name, giving
"<code>.tar.gz</code>".</p>
<p>
To unpack a compressed tar file <code>MyArchive.tar.gz</code> you
must both decompress it and extract the contents. You can do this in two
steps, one to decompress the file and another to unpack it:</p>
<blockquote>
<code>gzip -d MyArchive.tar.gz</code>
<br><code>tar -xf MyArchive.tar</code>
</blockquote>
<p>
or in a pipeline:</p>
<blockquote>
<code>gzip -d -c MyArchive.tar.gz | tar -xf -</code>
</blockquote>
<p>
or, if you have a program like GNU <code>tar</code> that can handle
compressed tar files, with a single command:</p>
<blockquote>
<code>tar -zxf MyArchive.tar.gz</code>
</blockquote>
<p>
The <code>tar</code> program automatically preserves directory structure
in extracting files. The Ghostscript source archive puts all files under a
directory <code>ghostscript-</code>#.##, so using <code>tar</code> to unpack a
compressed archive should always properly create that directory, which we
will call the "ghostscript directory". Make sure you're positioned in the
<b><em>parent</em></b> of the ghostscript directory <b><em>before</em></b> unpacking
the files. If a subdirectory doesn't already exist, <code>tar</code>
creates it.</p>
<p>
Some other programs – under MS Windows, for instance – can also unpack
compressed tar files, but they may not automatically preserve directory
structure nor even extract files into the current directory. If you use
one of these, you must</p>
<ul>
<li>set the program's options to "Use folder names" or the equivalent, and</li>
<li>check that it is extracting files into the right place.</li>
</ul>
<p>
As both <code>tar</code> and <code>gzip</code> formats are now well supported
by several applications on MS Windows, we only supply the <code>tar.gz</code> archive.</p>
<blockquote>
<p>
<a href="http://www.winzip.com">
WinZip</a></p>
<p>
<a href="http://www.7-zip.org/">
7-zip</a></p>
<p>
<a href="http://www.info-zip.org/">
Info-ZIP</a></p>
</blockquote>
<p>
are respectively a commercial and two free applications which can decompress and extract
<code>.tar.gz</code> archives on MS Windows.</p>
<h3><a name="Unpack_Ghostscript"></a>How to unpack Ghostscript itself</h3>
<p>
At this point you have <a href="#Acquiring">acquired the source code</a>
and are ready to unpack it according to the <a href="#Tarfiles">preceding guidelines</a>. To unpack the Ghostscript
source, make the <b><em>parent</em></b> of the (new) gs directory the current directory.</p>
<blockquote><table>
<tr><th align="left" valign="top">2-step:</th>
<td> </td>
<td><code>gzip -d ghostscript-</code>#.##<code>.tar.gz</code><br><code>tar -xf ghostscript-</code>#.##<code>.tar</code></td></tr>
<tr><th align="left" valign="top">Pipe:</th>
<td> </td>
<td><code>gzip -d -c ghostscript-</code>#.##<code>.tar.gz | tar -xf -</code></td></tr>
<tr><th align="left" valign="top">GNU tar:</th>
<td> </td>
<td><code>tar -zxf ghostscript-</code>#.##<code>.tar.gz</code></td></tr>
</table></blockquote>
<p>
All the Ghostscript source files are now in subdirectories of the gs
directory.</p>
<blockquote><table>
<tr><th colspan="5">Ghostscript Core Source subdirectories</th></tr>
<tr><th valign="bottom" align="left">Subdirectory</th>
<th> </th>
<th valign="bottom" align="left">Contents</th></tr>
<tr><td><code>arch/</code></td>
<td> </td>
<td>Pre-defined architecture header files</td></tr>
<tr><td><code>base/</code></td>
<td> </td>
<td>Graphics library C source code and makefiles</td></tr>
<tr><td><code>contrib/</code></td>
<td> </td>
<td>Community contributed/supported output devices</td></tr>
<tr><td><code>devices/</code></td>
<td> </td>
<td>The output devices supported by the Ghostscript team</td></tr>
<tr><td><code>psi/</code></td>
<td> </td>
<td>PS interpreter C source code and makefiles</td></tr>
<tr><td><code>Resource/</code></td>
<td> </td>
<td>Postscript initialization, resource and font files</td></tr>
<tr><td><code>lib/</code></td>
<td> </td>
<td>PostScript utilities and scripts used with Ghostscript</td></tr>
<tr><td><code>doc/</code></td>
<td> </td>
<td>Documentation</td></tr>
<tr><td><code>man/</code></td>
<td> </td>
<td>Unix <code>man</code> pages</td></tr>
<tr><td><code>examples/</code></td>
<td> </td>
<td>Sample PostScript files</td></tr>
<tr><td><code>iccprofiles/</code></td>
<td> </td>
<td>Default set of ICC profiles</td></tr>
<tr><td><code>windows/</code></td>
<td> </td>
<td>Visual Studio for Windows specific project and solution files</td></tr>
<tr><td><code>toolbin/</code></td>
<td> </td>
<td>Useful (non-Postscript) tools, mostly for developer use only</td></tr>
</table>
</blockquote>
<p>Optionally, if you downloaded the GhostPDL archive, you may also have:</p>
<blockquote><table>
<tr><th colspan="5">Additional GhostPDL source subdirectories</th></tr>
<tr><th valign="bottom" align="left">Subdirectory</th>
<th> </th>
<th valign="bottom" align="left">Contents</th></tr>
<tr><td><code>pcl/</code></td>
<td> </td>
<td>PCL/PXL interpreter C source code, makefiles, fonts etc</td></tr>
<tr><td><code>xps/</code></td>
<td> </td>
<td>XPS interpreter C source code and makefiles</td></tr>
</table>
</blockquote>
<p>Supporting third party libraries will also be in their own sub-directories (e.g. <code>jpeg</code>, <code>freetype</code> and so on).</p>
<h4>Luratech compressor libraries</h4>
<p>Ghostscript has optional support for the Luratech proprietary JBIG2
and JPEG 2000 implementations. If you have the source code for these
and wish the compile them into Ghostscript, the build system expects
them to be in directories named <code>luratech/ldf_jb2</code> and
<code>luratech/lwf_jp2</code> in the top level gs source directory, alongside
the other third-party libraries. With the Luratech source directories in the
expected place, the build system will automatically include them.</p>
<p>
If you have the Luratech code but wish to build without it, on "configure"
based builds you can achieve this by doing:</p>
<blockquote>
<code>./configure --without-luratech</code>
</blockquote>
<p>
On Windows, you can achieve it by adding:</p>
<blockquote>
<code>NO_LURATECH=1</code>
</blockquote>
to your nmake command line.
<p>
With either of these options, the build will fall back to the defaults for
both JBIG2 and JPEG2000 decoding.</p>
<hr>
<h2><a name="Bug_check"></a>How to check for post-release bug fixes</h2>
<p>
Bug information and fixes are tracked on Ghostscript Bugzilla.
For more information, please visit</p>
<blockquote>
<a href="http://bugs.ghostscript.com">
http://bugs.ghostscript.com</a>
</blockquote>
<hr>
<h2><a name="Makefile_overview"></a>How to prepare the makefiles</h2>
<p>
The Ghostscript makefiles are very large and complex in order to deal with
the diverse requirements of all the different systems where they may be
used.</p>
<p>
Ghostscript has an automatic configuration script. If you're on unix or
a system that supports unix shell scripts, this is the easiest option to use.
Simply type:</p>
<blockquote>
<code>./configure</code>
</blockquote>
<p>from the top level of the ghostscript source directory. It should configure
itself based on what's available on your system, warn you of any missing
dependencies, and generate a Makefile. At this point you can skip to the
section <a href="#Invoke_make">invoking make</a> below. Also, many common
configuration options (like install location) can be set through options
to the configure script.</p>
<p>
Type '<code>./configure --help</code>' for a complete
listing. Note that the configuration option is only available with the
unix .tar distributions of the source.</p>
<p>
Note that if you're building Ghostscript from development source out of
a repository instead of from a released source package, you should run
'<code>./autogen.sh</code>' instead of <code>./configure.</code> This script
takes all the same options that configure does.</p>
<p>
If your system doesn't support the configure script or you don't wish to
use it, you can use the traditional ghostscript makefile system, editing
the options by hand to match your system as described below.
Fortunately, the only makefiles you're likely to want to change are
relatively small ones containing platform-specific information.</p>
<blockquote><a name="Platform-specific_makefiles"></a><table>
<tr><th colspan="3">Platform-specific makefiles</th></tr>
<tr><th align="left">Makefile</th>
<th> </th>
<th align="left">Used for</th></tr>
<tr><td><code>Makefile.in</code></td>
<td> </td>
<td>Template makefile for the autoconf build</td></tr>
<tr><td><code>psi/msvc.mak</code></td>
<td> </td>
<td>MS Windows with Microsoft Visual Studio 2003 and later.</td></tr>
<tr><td><code>base/unix-gcc.mak</code></td>
<td> </td>
<td>Unix with gcc</td></tr>
<tr><td><code>base/unixansi.mak</code></td>
<td> </td>
<td>Unix with ANSI C compilers other than gcc</td></tr>
</table>
</blockquote>
<p>
A number of platform indepdent makefiles in each of the core Ghostscript source directories.
Since these files can change from one Ghostscript version to another, sometimes
substantially, and since they all include documentation for the various
options, here we don't duplicate most of that documentation: we recommend
strongly that you review the entire makefile specific for your operating
system and compiler before building Ghostscript.</p>
<h3>Building against the Luratech compression libraries</h3>
<p>
To compile Ghostscript against the proprietary Luratech JBIG2 and JPEG
2000 implementations, simply ensure that the <code>luratech/ldf_jb2</code> and
<code>luratech/lwf_jp2</code> containing the Luratech code exist in the top level
gs source directory, and (re-)run <code>configure</code> (ensuring to <code>make clean</code> before
re-running make). The configure
script will detect the presence of the directories, and apply the appropriate
settings in the Makefile.</p>
<p>
If you have the Luratech directories in place, but want Ghostscript built
without it, you can run configure with the <code>--without-luratech</code> option, and
the script will behave as if the directories did not exist.</p>
<h3><a name="Preparing_makefiles"></a>Changes for your environment</h3>
<p>
Assuming you have opted not to use the <code>configure</code> script or
the default Microsoft Visual Studio bulid, you must
edit the platform-specific makefile to change any of these:</p>
<ul>
<li>The name of the makefile itself (<code>MAKEFILE</code> macro)</li>
<li>The locations to install Ghostscript files (<code>prefix</code> etc.)</li>
<li>The default search paths for the initialization and font files
(<code>GS_LIB_DEFAULT</code> macro)</li>
<li>The debugging options (<code>DEBUG</code> and <code>TDEBUG</code>
macros)</li>
<li>Which optional features to include (<code>FEATURE_DEVS</code>)</li>
<li>Which device drivers to include (<code>DEVICE_DEVS</code> and
<code>DEVICE_DEVS</code>{<em>1--20</em>} macros)</li>
<li>Default resolution parameters for some printer drivers
(<code>devs.mak</code> or <code>contrib.mak</code>, whichever defines
the driver)</li>
</ul>
<p> In general these will be set to commonly sensible values already, but
may not be ideal for your specific case.</p>
<p>
The <a href="#Platform-specific_makefiles">platform-specific makefiles</a>
include comments describing all these except the
<code>DEVICE_DEVS</code> options. These are described in
<code>devs.mak</code> and <code>contrib.mak</code>, even though the
file that must be edited to select them is the <a
href="#Platform-specific_makefiles">platform-specific makefile</a>.</p>
<p>
Some platform-specific options are described in the sections for individual
platforms. See the "Options" section near the beginning of the relevant
makefile for more information.</p>
<h3><a name="Features_and_devices"></a>Selecting features and devices</h3>
<p>
You may build Ghostscript with any of a variety of features and with any
subset of the available device drivers. The complete list of features is
in a comment at the beginning of <code>gs.mak</code>, and the complete
list of drivers in comments at the beginning of <code>devs.mak</code>
and <code>contrib.mak</code>. To find what devices a platform-specific
makefile selects to include in the executable, look in it for all lines of
the form</p>
<blockquote>
<code>FEATURE_DEVS=</code><em>{list of features}</em><br>
<code>DEVICE_DEVS</code>*<code>=</code><em>{list of devices}</em>
</blockquote>
<p>
For example, if the makefile has</p>
<blockquote><code>
FEATURE_DEVS=$(PSD)level2.dev
</code></blockquote>
<p>
indicating that only the PostScript Level 2 facilities should be included,
you might make it</p>
<blockquote><code>
FEATURE_DEVS=$(PSD)level2.dev $(PSD)pdf.dev
</code></blockquote>
<p>
to add the ability to interpret PDF files. (In fact,
<code>FEATURE_DEVS</code> in the current Unix makefiles already includes
<code>$(PSD)pdf.dev</code>.).</p>
<p>
It is extremely important that FEATURE_DEVS is set correctly. Currently,
the default builds will include a complete feature set, and as such most
of those building Ghostscript will have no need to change it. Only those
working in heavily resource constrained environment will want to experiment,
and it is vital that the implications of such changes be understood, otherwise
Ghostscript may behave in unexpected or apparently incorrect ways, or may
even fail to build.</p>
<p>
The Unix makefile also defines</p>
<blockquote><code>
DEVICE_DEVS=$(DD)x11.dev
</code></blockquote>
<p>
indicating that the X Windows driver should be included, but since
platform-specific makefiles as distributed normally include many of the
possible features and drivers, you will probably rather remove from the
makefile the features and drivers you don't want. It does no harm to
include unneeded features and devices, but the resulting executable will be
larger than needed.</p>
<p>
You may edit the <code>FEATURE_DEVS</code> line to select or omit any of
the features listed near the beginning of <code>gs.mak</code>, and the
<code>DEVICE_DEVS</code>* lines to select or omit any of the device
drivers listed near the beginning of <code>devs.mak</code> and
<code>contrib.mak</code>. GS_DEV_DEFAULT is a string containing whitespace
separate device names, and give the devices Ghostscript should attempt to use
(and the order) if no device is specified on the command line;
see the usage documentation for <a href="Use.htm#Output_device">how to
select an output device</a> at run time using the
<a href="Use.htm#DEVICE_switch"><code>-sDEVICE=</code></a> switch. If
you can't fit all the devices on a single line, you may add lines defining</p>
<blockquote>
<code>DEVICE_DEVS1=$(DD)</code><em>{dev11}</em><code>.dev</code> ... <code>$(DD)</code><em>{dev1n}</em><code>.dev</code>
<br><code>DEVICE_DEVS2=$(DD)</code><em>{dev21}</em><code>.dev</code> ... <code>$(DD)</code><em>{dev2n}</em><code>.dev</code>
</blockquote>
<p>
etc., up to <code>DEVICE_DEVS15</code>. Don't use continuation lines --
on some platforms they don't work.</p>
<p>
Note that if you want to include a driver named <em>xxx</em>, you must put
<code>$(DD)</code><em>xxx</em><code>.dev</code> in
<code>DEVICE_DEVS</code>*. Similarly, if you want to include a feature
related to the PostScript or PDF language interpreters (PostScript level
1 .. 3, or other language features such as the ability to read EPSF files or
TrueType font files), you must represent it as
<code>$(PSD)</code><em>xxx</em><code>.dev</code>.</p>
<h4><a name="Precompiled_data"></a>Precompiled run-time data</h4>
<p>
Ghostscript normally reads a number of external data files at run time:
initialization files containing PostScript code, fonts, and other resources
such as halftones. By changing options in the top-level makefile for the
platform, you can cause some of these files to be compiled into the
executable: this simplifies installation, improves
security, may reduce memory requirements, and may be essential if you are
planning on putting Ghostscript into ROM. Compiling these files into the executable
also means the executable is (largely) self-contained, meaning initialization
files, font files, resource files and ICC profile files are certain to be available
and accessible. In general, Ghostscript should initialize more quickly, and files
(especially PDF) files making heavy use of the built-in fonts will interpret more
quickly.</p>
<p>
For those distributing Ghostscript binaries, compiling those files into the executable
has another implication, any site-specific customizations (such as font and CIDFont
substitutions) are slightly more complex to implement - see:</p>
<blockquote>
<a href="Use.htm#Finding_files">How Ghostscript finds files</a>
</blockquote>
<p>for how to influence where Ghostscript searches for files. Furthermore, if the files
Ghostscript uses are also required to be accessible by applications other than Ghostscript
(the mostly case for this would be font files and ICC profile files), having those files
compiled into Ghostscript maybe suboptimal, essentially require two copies of the file
data to be distributed (one set built into Ghostscript, and the other as "normal" files
accessible outside of Ghostscript.</p>
<p>
Compiling the initialization files (<code>Resource/Init/gs_init.ps</code>, etc.)
into the executable is the default. To disable this, change the <code>1</code> to
a <code>0</code> in the line</p>
<blockquote><code>
COMPILE_INITS=1
</code></blockquote>
<p>
Or, if you use the <code>configure</code> based Unix-style build, you can disable
COMPILE_INITS by adding the option <code>--disable-compile-inits</code> to the invocation
of <code>configure</code></p>
<p>
Files are now compiled into the executable as a %rom% file system that can
be searched, opened, etc. as with the normal (%os%) file system. The data
is (mostly) compressed. Several of the initialisation files (those in <code>Resource/Init</code>)
are also converted to binary Postscript encoding, and "merged" into a single monolithic
file - this is done for both size and speed optimization. Files that are often customized for
individual installations (such as <code>Fontmap</code> and <code>cidfmap</code>) are not
merged into the single file and thus installation specific versions can be used.</p>
<p>
The set of files built into the %rom% file system
is specified in the <code>psi/psromfs.mak</code> file. By default the set
of files built into the rom file system comprises all the resource files
Ghostscript requires to run successfully (all the files under <code>Resource</code>
directory, and those under the <code>iccprofiles</code> directory). Refer to the file
<code>base/mkromfs.c</code> for a description of the parameters that
control source and destination pathnames, file enumeration exclusion,
compression, etc.</p>
<p>
Fonts normally are compiled into the executable using <code>mkromfs</code>
(above) from the Resource/Font/ directory.</p>
<p>
Similarly, Halftone resources can be compiled into the executable using
<code>mkromfs</code>, but also threshold-array halftones can be compiled
into the executable. See the "Compiled halftone" section of <code>int.mak</code>
for a sample makefile fragment, <code>genht.c</code> for the syntax of
halftone data files, and <code>lib/ht_ccsto.ps</code> for a sample data file.
Note that even though the data files use PostScript syntax, compiled halftones
do not require the PostScript interpreter and may be used with the graphics
library alone.</p>
<h3><a name="Makefile_setup"></a>Setting up "makefile"</h3>
<p>
After going through the steps just described to <a href="#Unpack">unpack
the sources</a>, configure the build and make any desired
<a href="#Preparing_makefiles">changes to the makefiles</a>.
As the final step in preparing to build Ghostscript you must usually
associate the name "<code>makefile</code>" with the correct makefile
for your environment so the <code>make</code> command can find it.
See the section on your particular platform for how to do that if
necessary.</p>
<p>
On unix systems, <code>./configure</code> (or if checked out of git,
<code>./autogen.sh</code>) should create a <code>Makefile</code> which works
in most scenarios. Manual tampering and editing should rarely be needed
nor recommended.</p>
<h3><a name="Invoke_make"></a>Invoking "make"</h3>
<dl>
<dt><code>make</code></dt>
<dd>Builds Ghostscript without debugging options.</dd>
</dl>
<dl>
<dt><a name="Debugging"></a><code>make debug</code></dt>
<dd>Builds Ghostscript with debugging options and additional internal error
checks. The program will be somewhat larger and slower, but it will behave
no differently unless you actually turn on debugging options at execution
time with the <code>-DDEBUG</code> or
<a href="Use.htm#Debugging"><code>-Z</code> command line switches</a>
described in the usage documentation.</dd>
</dl>
<dl>
<dt><code>make pg</code></dt>
<dd>On Unix platforms, builds with the <code>-pg</code> compiler
switch, creating an executable for time profiling.</dd>
</dl>
<dl>
<dt><code>make install</code></dt>
<dd>After building, installs the Ghostscript executables, support files,
and documentation, but does <b><em>not</em></b> install fonts. See the
<a href="Install.htm">installation documentation</a>.</dd>
</dl>
<dl>
<dt><code>make (debug)clean</code></dt>
<dd>Deletes all the files created by the build process (relocatables,
executables, and miscellaneous temporary files). If you've built an
executable and want to save it, move it first to another place, because
"<code>make clean</code>" deletes it.</dd>?
</dl>
<dl>
<dt><code>make so</code></dt>
<dd>On some platforms (Linux, *BSD, Darwin/Mac OS X, SunOS),
it is possible to build ghostscript as a shared object library.
There is a corresponding "<code>make soclean</code>" for cleaning up.</dd>
</dl>
<p>
<b><em>Note:</em></b> on most platforms some of these simple instructions don't
quite work in one way or another. Read the section on your specific
platform.</p>
<p>
<b><em>Note 2:</em></b> If you are attempting to build a statically linked
executable, you will probably need to add libraries to the linker options
(libraries that are normally pulled-in automatically by the dynamic linker).
These can be added at the make command line using the "EXTRALIBS=" option.
Unfortunately, the set of libraries that may be required varies greatly
depending on platform and configuration, so it is not practical to offer
a list here.</p>
<h3><a name="Cross-compiling"></a>Cross-compiling</h3>
<p>
Cross-compiling is not fully supported by the <code>configure</code> script (such
support is a work-in-progress).</p>
<p>
You can either use <code>base/unixansi.mak</code> or <code>unix-gcc.mak</code>
as the basis for a cross-compile makefile, or use <code>configure</code> to
create a basic <code>Makefile</code> as the basis. And modify to suit.</p>
<p>
You can set the compiler to your cross-compiler for <code>configure</code> by doing:</p>
<blockquote>
./configure CC=<cross-compiler executable>
</blockquote>
<p>
and <code>configure</code> will then run its checks (as best it can) with the
cross-compiler.</p>
<p>
If you do so, you should also give <code>configure</code> the option to set the
target architecture endianness: <code>--enable-big-endian</code> or <code>--enable-little-endian</code>.</p>
<p>
It would also be wise to review the settings shown in the output of <code>./configure --help</code> for
any that would be applicable to your target.</p>
<br>
<br>
<p>
The Ghostscript build system uses several interim executables, built and run on the <code>host</code>,
as such, even when cross-compiling, a <code>host native</code> compiler is also required. You must edit
your <code>makefile</code> to ensure that is available. Find the line that starts:</p>
<blockquote>
CCAUX=
</blockquote>
<p>
and set that to your <code>host compiler</code>.</p>
<p>
If you did not use <code>configure</code> or did not set the <code>CC</code> variable for <code>configure</code>,
you must also set the:</p>
<blockquote>
CC=
</blockquote>
<p>
to your cross-compiler.</p>
<p>
The Ghostscript build system uses a utility called <code>genarch</code>
(see <code>base/genarch.c</code> for details) to interrogate the environment and
generate a header file describing the architecture for which Ghostscript is being
built. As this is run on the <code>host</code> it will generate header for the
<code>host architecture</code> rather than that of the <code>target</code>.</p>
<p>
For cross compiling, you must create (or modify) a header file (<code>arch.h</code>)
which accurately describes the <code>target architecture</code>. Then you must
edit your <code>makefile</code> by finding the line:</p>
<blockquote>
TARGET_ARCH_FILE=
</blockquote>
<p>
and set it to the path to, and file name of your custom <code>arch.h</code> file. With that
setting, <code>genarch</code> will still be run, but rather than interrogate the current environment,
it will copy the contents of your custom <code>arch.h</code> to the build.</p>
<hr>
<h2><a name="PC_build"></a>How to build Ghostscript from source (PC version)</h2>
<p>
All Ghostscript builds in PC (DOS and MS Windows) environments are 32- or
64-bit: 16-bit builds are not supported. The relevant makefiles are</p>
<blockquote><table>
<tr><th colspan="5">PC makefiles</th></tr>
<tr><th align="left">Makefile</th>
<th> </th>
<th align="left">Construction tools</th>
<th> </th>
<th align="left">For environment</th></tr>
<tr><td valign="top"><code>msvc.mak</code></td>
<td> </td>
<td valign="top"><a href="#Microsoft_build">Microsoft Visual Studio .NET 2003 (or later)</a></td>
<td> </td>
<td valign="top">MS Windows 32/64-bit</td></tr>
<tr><td valign="top"><code>Makefile.in</code></td>
<td> </td>
<td valign="top"><a href="#Cygwin_build">Cygwin/gcc</a></td>
<td> </td>
<td valign="top"><a href="https://www.cygwin.com/">Cygwin</a> (Use Unix <code>configure</code>)</td></tr>
</table></blockquote>
<p>
Ghostscript requires at least MS Windows 95 (although we no longer actively test nor
support Win95, we have not deliverately done anything to break compatibility with it).
We recommend at least MS Windows NT 4.0.</p>
<p>
For building, Ghostscript requires at least Visual Studio .NET 2003, and we recommend
at least Visual Studio 2005 (required for 64 bit Windows support).</p>
<p>
Note that the <code>make</code> program supplied with Visual Studio (and earlier
Visual C++ versions) is actually called <code>nmake</code>. We refer to this
program generically as <code>make</code> everywhere else in this document.</p>
<p>
You must have <code>cmd.exe</code> in your path to build Ghostscript (using
the Visual Studio command prompt is ideal). After making any changes required to choose
features and devices to build into the executable, you can then invoke <code>make</code>
to build the executable.</p>
<p><a name="Make_windows"></a></p>
<h3><a name="Microsoft_build"></a>Microsoft Visual Studio</h3>
<h4><a name="Using_the_MS_Development_Environment"> </a>Using Microsoft Visual Studio</h4>
<p>
The Ghostscript source distribution ships with <code>project</code> and <code>solution</code>
files for Visual Studio 2005 and later. These can be found in the <code>windows</code> directory.
The <code>project(s)</code> are <code>nmake projects</code> which means that rather than Visual
Studio controlling the build directly, it delegates the build process the the <code>nmake</code>.</p>
<p>
Beyond lacking support for parallel builds (<code>nmake</code> cannot support parallel builds),
there should be little visible difference between a conventional VS project and an
<code>nmake project</code> to the user of the VS graphical interface. The only exception to that
is if you have to make changes to build options beyond those available in the defined build
configurations. In that case, you need to find the <code>Nmake</code> tab in the project
<code>Property Pages</code> and modify the appropriate entry: <code>Build Command Line</code>,
<code>Rebuild All Command Line</code> and/or <code>Clean Command Line</code>.</p>
<p>
NOTE: changing the <code>Output</code> property in the <code>Nmake</code> properties will not
change the name of the executable - to do that requires editing of the <code>psi/msvc.mak</code>
makefile, or you can add: <code>GS=myname.exe</code> to the <code>nmake</code> command line.</p>
<h4><a name="Using_the_command_line"></a>Using the command line</h4>
<p>Ghostscript can be made using the Windows command prompt or one of the various command
line shells made for Windows, as long as the command line syntax is compatible with the
Windows <code>CMD.exe</code>. The Visual Studio command prompt is ideal.</p>
<p>In order for the makefiles to work properly, two items may have to be changed.
An attempt is made to select the correct version of Microsoft Visual C++
based on the version of nmake. If this doesn't work it will default
to version 6.x.
If the auto-detection does not work, and you are not using version 6.x then before building,
in <code>psi\msvc.mak</code> find the line "<code>#MSVC_VERSION=6</code>" and change it to
"<code>MSVC_VERSION=4</code>", "<code>MSVC_VERSION=5</code>", "<code>MSVC_VERSION=7</code>"
or "<code>MSVC_VERSION=8</code>" and so on. </p>
<p>In some cases the location of the Microsoft Developer Studio, needs to be changed.
The location of Microsoft Developer Studio is defined by the value of <code>DEVSTUDIO</code>.
There are several different definitions of <code>DEVSTUDIO</code> in psi\msvc.mak.
There is one for each of the currently supported versions of Microsoft Visual
C++ (4, 5, 6, 7, 7.1 and 8). </p>
<p>The normal installation process for Microsoft Visual C++ includes setting the
location of the Microsoft Visual C++ executables (cl.exe, link.exe, nmake.exe,
rc.exe) in your PATH definition and the LIB and INCLUDE environment variables
are set to point to the Microsoft Visual C++ directories. If this is true then
the value for <code>DEVSTUDIO</code> can be changed to empty. I.e. <code>DEVSTUDIO=</code></p>
<p> If PATH, LIB, and INCLUDE are not correctly set then the value for <code>DEVSTUDIO</code>
needs to be defined. For example, for version 6.0, the default definition for
the location for the Microsoft Developer Studio is: <code>DEVSTUDIO=C:\Program
Files\Microsoft Visual Studio </code> If the path to Microsoft Developer Studio
on your system differs from the default then change the appropriate definition
of <code>DEVSTUDIO</code>. (Remember that there is a separate definition
of <code>DEVSTUDIO</code> for each version of MSVC, so be sure to change
the correct definition.) </p>
<p>To run the <code>make</code> program, give the command </p>
<blockquote><code>
nmake -f psi\msvc.mak
</code></blockquote>
<p>
Rather than changing psi/msvc.mak, these values can also be specified on
the make command line, I.e.</p>
<blockquote><code> nmake -f psi\msvc.mak MSVC_VERSION=6 DEVSTUDIO="C:\Program Files\Microsoft Visual Studio" <br>
nmake -f psi\msvc.mak MSVC_VERSION=7 DEVSTUDIO="C:\Program Files\Microsoft Visual Studio .NET"
</code></blockquote>
<p> Note that double quotes have been added around the path for <code>DEVSTUDIO</code>
due to the spaces in the path value.</p>
<p>
This command line can also be put into a batch file.</p>
<p> You may get warning messages during compilation about various undefined
and/or unsupported switches - this is because the compiler switches are set
in the makefiles, and are applied when building with all versions of Visual
Studio, but not all options are supported (or required) by all versions of
Visual Studio. These warnings are benign and can be ignored.</p>
<h4>Building with the Luratech compression libraries</h4>
<p>
If you wish to compile Ghostscript with the Luratech JBIG2 and JPEG 2000
implementations, the source should be installed in the top-level
directory of the Ghostscript source.
If you have an appropriately licensed source distribution this should
already have been done.</p>
<p>
With the Luratech source in the <code>luratech/ldf_jb2</code> and
<code>luratech/lwf_jp2</code> directories in the top level gs source
directory, the nmake makefile will detect their presence, and use them
automatically.</p>
<p>
If you have the Luratech code in place, but wish Ghostsrcipt to be built
without the Luratech decoders, you can do so by passing NO_LURATECH=1 on
the nmake command line, or add the define to your Visual Studio project.</p>
<h3><a name="Microsoft_build_64"></a>Microsoft Environment for 64-bit</h3>
<p>Building Ghostscript for 64-bit Windows (AMD64 processor) requires
Microsoft Visual Studio .NET 2005 or Microsoft Visual Studio 2008 or later
on 64-bit Windows. Cross compiling on 32-bit Windows is possible.</p>
<p>
Compiling for 64-bit is similar to the
<a href="#Microsoft_build">Microsoft Environment</a> instructions above,
but with the addition of a WIN64 define.</p>
<p>To make ghostscript use</p>
<blockquote><code>
nmake -f psi/msvc.mak WIN64=
</code></blockquote>
<h4><a name="Self-extracting_executables"></a>Making self-extracting installers</h4>
<p>
You can build self-extracting Windows installers based on
<code>NSIS (Nullsoft Scriptable Install System)</code>. To do so, use the <code>nsis</code>
makefile taget as well as any other options, for example:</p>
<blockquote><code>
nmake -f psi/msvc.mak WIN64= nsis
</code></blockquote>
<p>
will create an <code>nsis</code> based installer for Ghostscript built for 64 bit Windows
systems.</p>
<h3><a name="Microsoft_build_winrt"></a>Microsoft Environment for WinRT</h3>
<p>
Ghostscript can be built in the form of a win32 DLL for use within a Windows Runtime
application or Windows Runtime component. Building for WinRT requires use of
Microsoft Visual Studio 2012. There is a solution file that can be loaded into VS 2012,
in the directory <code>winrt</code></p>
<p>
The WinRT application or component should include <code>iapi.h</code> from
<code>gs/psi</code> and link with <code>gsdll32metro.lib</code> from
<code>gs/debugbin</code> or <code>gs/releasebin</code>. Also any app using
ghostscript either directly or via a component should add <code>gsdll32metro.dll</code>
as "content". This inclusion of the dll is necessary so that it
will be packaged with the app. If one wishes to be able to run the debugger on
ghostscript then <code>gsdll32metro.pdb</code> should also be added as content.</p>
<h3><a name="Cygwin32_build"></a>Cygwin32 gcc</h3>
<p>
It is possible to compile Ghostscript for MS Windows using the Cygwin32 gcc compiler,
GNU <code>make</code>, using the "configure" generated Makefile.</p>
<p>
Information about this compiler and environment is at the Cygwin site:</p>
<blockquote>
<a href="http://www.cygwin.com/">http://www.cygwin.com/</a>
</blockquote>
<h4><a name="MSys/Mingw"></a>MSys/Mingw</h4>
<p>The configure build can be used to build Ghostscript on MSys/Mingw systems,
but with a caveat. The msys-dvlpr adds header files into the compiler's header
search paths which cause a clash, and the build will fail as a result. If you
have the msys-dvlpr package installed, and until a better solution is available
you can work around this by temporarily renaming the "\mingw\msys\1.0\include"
directory so those headers are no longer found by the compiler.</p>
<hr>
<h2><a name="Mac_build"></a>How to build Ghostscript from source (MacOS version)</h2>
<h3><a name="MacOSX"></a>MacOS X</h3>
<p>
The unix source distribution (.tar.gz) builds fine on Darwin/MacOS X,
albeit without a display device. You can generally just use the <tt>Makefile</tt>
generated by <tt>configure</tt> as your top-level makefile and get a reasonable default
build. This will allow you to use Ghostscript from the command line as a BSD-layer
tool to rasterize postscript and pdf to image files, and convert between the
high-level formats supported by Ghostscript. See the instructions for the
unix build below for details of how to customize this build.</p>
<p>
NOTE: If you have MacPorts (http://www.macports.org/) installed, it can
"confuse" the configure script because it includes some librares which
duplicate the "system" ones. This can cause missing symbol link errors.
In order to resolve this, you can do:<code> LDFLAGS="-L/usr/lib" ./configure</code>.
That will force the linker to search the default directory first, and thus pick
up the system libraries first.</p>
<p>
It is also possible to build "universal binaries" for MacOS X, containing <code>i386</code>
and <code>x86_64</code> binaries in one file, using the <code>Makefile</code>
from <code>configure</code>. This can be achieved by using the following invokation of
<code>configure</code></p>
<blockquote>
<code>
./configure CC="gcc -arch i386 -arch x86_64 -arch ppc" CPP="gcc -E"
</code>
</blockquote>
<p>
You can choose the combination of valid architectures (i386/x86_64/ppc) that you
require.</p>
<p>
The separate options for <tt>CC</tt> and <tt>CPP</tt> are required because some of
the features used by <tt>configure</tt> to explore the capabilities of the preprocessor
are not compatible with having multiple <tt>-arch</tt> options.</p>
<p>
Building a shared library on MacOS X is the same as for other Unix-like systems, the
"configure" step is done normally, and the "so" target is given to the make invocation,
thus:</p>
<blockquote>
<code>
make so
</code>
</blockquote>
<p>The only difference compared to other Unix-like systems is that on OS X the resulting
shared library is created with the ".dylib" file name extension, instead of the more
usual ".so".</p>
<hr>
<h2><a name="Unix_build"></a>How to build Ghostscript from source (Unix version)</h2>
<p>
Ghostscript now ships with a build system for unix-like operating systems
based on GNU Autoconf. In general the following should work to configure
and build Ghostscript:</p>
<blockquote><pre>
./configure
make
</pre></blockquote>
<p>or</p>
<blockquote><pre>
./configure
make so
</pre></blockquote>
<p>for building ghostscript as a shared library.</p>
<p>Please report any problems with this method on your system as a bug.</p>
<p>
On modern unix systems, <code>./configure</code>
should create a <code>Makefile</code> which works
in most scenarios. Manual tempering and editing should rarely be needed
nor recommended.</p>
<p>
<a name="autogen_sh"></a>
Note that if you're building Ghostscript from development source out of
a repository instead of from a released source package, you should run
'<code>./autogen.sh</code>' instead of <code>./configure.</code> This script
takes all the same options that configure does.</p>
<p>
(deprecated; see Autoconf-based method above)
For the convenience of those already familiar with Ghostscript, the old method
based on hand-edited makefiles is still possible but no longer supported
(and in many cases, simply do not work without substantial
expert manual-editing effort). It may also be helpful in
getting Ghostscript to build on very old platforms. The rest of this section deals exclusively
with that older method and includes numerous pointers regarding legacy systems.</p>
<p>
(deprecated; see Autoconf-based method above)
Before issuing the <code>make</code> command to build Ghostscript, you
have to make some choices, for instance</p>
<ul>
<li>which compiler to use;</li>
<li>what features and devices to include;</li>
<li>whether to use system libraries for PNG and zlib;</li>
<li>and how to handle issues for your particular platform.</li>
</ul>
<p>
Be sure to check the sections on <a
href="#Tool_specific_issues">tool-</a>, <a
href="#OS_specific_issues">OS-</a>, and <a
href="#Hardware_specific_issues">hardware-</a>specific issues for notes
on your particular platform and compiler. In fact, that is the
<b><em>first</em></b> place to check if you build Ghostscript and it crashes
or produces obviously incorrect results.</p>
<h4><a name="GNU_make"></a>make tools</h4>
<p>
You require a make tool which supports separate directories for
the derived objects (such as object files, executables and dynamically created
header files) and the source files.</p>
<p>
In general, GNU make is the recommended choice, and some features (such as the
building of the Linux/Unix shared library build ("make so") are only available
with GNU make.</p>
<p>
Other <code>make</code> implementations are known to work, but are not guaranteed
to do so.</p>
<p>
<u><a name="GNU_make"></a>GNU make</u></p>
<p>
Current versions of GNU <code>make</code> have no problems building
Ghostscript.</p>
<h3><a name="OS_specific_issues"></a>OS-specific issues</h3>
<h4><a name="HP_RISC"></a>H-P RISC workstations</h4>
<ul>
<p>
(see Autoconf-based method above)</p>
<li>HP-UX versions before 11.0 do not support POSIX threads. Set
<code>SYNC=nosync</code> in the makefile before building.</li>
<li>Ghostscript builds on H-P machines with either GNU gcc or H-P's
ANSI-capable <code>cc</code>. The minimal, non-ANSI-capable
<code>cc</code> that shiped with some basic HPUX system does <em>not</em>
work. If <code>cc</code> on your system doesn't accept the
<code>-Aa</code> switch, then you need to get the full
<code>cc</code> or gcc.</li>
<li>If you use H-P's compiler, be sure you have upgraded to a recent
release. Many bizarre symptoms have been reported trying to build
Ghostscript with older, buggier compilers, for example:</li>
<ul>
<li>The link step fails with a message about "<code>max</code>" not being defined.</li>
<li>The build succeeds, but the resulting executable fails to start up,
with an error message like "Initializing... Unrecoverable error: typecheck
in .registerencoding".</li>
<li>The build succeeds, but the resulting executable produces a black
background on the first page of output.</li>
</ul>
<li>It is reported that On HPUX 9.* you need at least compiler patch
PHSS_5723 and dld.sl patch PHSS_5734 to build Ghostscript. (As of late
1997, those patches are long obsolete; the current patches are compiler
PHSS_10357 and dld.sl PHSS_11246. It is unknown whether current
Ghostscript releases work with compiler/dld.sl versions older than these.)</li>
<li>On HPUX 10.*, we don't know what combinations of compiler version and
switches work. It is reported that On HPUX 10.20, setting
"<code>CC=c89</code>" and "<code>CFLAGS=+O3 $(XCFLAGS)</code>"
works, contradicting the information in the next paragraph, but this may be
dependent on the specific compiler version.</li>
<li>In either HPUX version, you need to set
"<code>CC=cc -Aa</code>" (or use <code>-Ae</code> if you
prefer), and set
"<code>CFLAGS=-D_HPUX_SOURCE -O $(XCFLAGS)</code>". Higher
levels of optimization than <code>-O</code> may work depending on your
compiler revision; some users have reported success with
<code>+O3</code>, some have not.</li>
<li>Some users have reported needing <code>-DNOSYSTIME</code> and
<code>-D_POSIX_SOURCE</code> in <code>CFLAGS</code>, but recent tests
do not show these to be necessary.</li>
<li>If you use gcc, it's a good idea to have a recent release -- at the
very least 2.7.2.1 or later.You may be able to get a working
executable with an older gcc by removing <code>-O</code> from
<code>CFLAGS</code>.</li>
</ul>
<h4><a name="IBMAIX"></a>IBM AIX</h4>
<p>
We recommend installing gcc and GNU make, and using the Autoconf-based method.</p>
<p>
Other combinations are known to work, but are less well supported.</p>
<p>
Recent veresions of Ghostscript can trigger a 'TOC overflow' error with some compilers
on AIX. If this occurs, use the linker flag "-bbigtoc", which can either be added to
your configure options:
<p><code>configure LDFLAGS="-Wl,-bbigtoc"</code>
<p>Or on the make command line:
<p><code>make XLDFLAGS="-Wl,-bbigtoc"</code>
<h4>
<a NAME="Silicon_Graphics"></a>Silicon Graphics</h4>
<p>
(see Autoconf-based method above)</p>
<p>
Users have had a lot of problems with the MIPSpro compilers on SGI systems.
We recommend using gcc. If you do choose to use the MIPSpro compiler,
please read the following carefully.</p>
<ul>
<li>
To make the optimizer allocate enough table space, set</li>
<p><code>CFLAGS="-Olimit 2500"</code> (for older compilers)
<br><code>CFLAGS="-OPT:Olimit=2500"</code> (for newer compilers)</p>
<p>
MIPSpro compiler version 3.19 is "older", and 7.1 is "newer"; we aren't
sure at what point in between the latter syntax was introduced.</p>
<li>
With the compiler shipped with Irix 5.2, use the <code>-ansi</code>
option.</li>
<li>
The SGI C compiler may produce warnings about "Undefined the ANSI standard
library defined macro stdin/stdout/stderr". To suppress these warnings, add
"<code>-woff 608</code>" to the definition of <code>CFLAGS</code>.</li>
<li>
The SGI C compiler shipped with Irix 6.1 and 6.2 will not compile
<code>zlib/deflate.c</code> properly with optimization. Compile this file
separately without <code>-O</code>.</li>
<li>
With IRIX 6.5.x and the MIPSpro 7.x compilers there have been reports about
incorrect output and binaries that cause segmentation faults. Various
solutions have been suggested and you may want to try them in this order,
until you get a working binary:</li>
<ul>
<li>
Compile <code>idict.c</code> and <code>isave.c</code> separately
without optimization after doing a normal compile; then relink.e.g.:</li>
<p>
<code>cc -OPT:Olimit=2500 -I. -I./obj -o ./obj/idict.o -c ./idict.c</code><br>
<code>cc -OPT:Olimit=2500 -I. -I./obj -o ./obj/isave.o -c ./isave.c</code></p>
<li>
Set <code>CFLAGS=</code> (no optimization).</li>
<li>
Use only <code>-O2</code>. Compiler produces incorrect output
with <code>-O3</code> or "<code>-Ofast=ip32 -show</code>".</li>
<li>
Irix 6.5.1m with MIPSpro compiler 7.2.1.1m, Irix 6.5.3m with MIPSpro
compiler 7.2.1, and probably other 6.5x / 7.2x combinations require
compiling with the <code>-o32</code> option. Compiling with the (default)
<code>-n32</code> option produces non-working executables.
<code>-O2</code> is OK (possibly except for <code>idict.c</code>), but
not <code>-O3</code>.</li>
</ul>
</ul>
<h4><a name="Sun"></a>Oracle/Sun</h4>
<p>
see Autoconf-based method above)</p>
<ul>
<li>The Sun unbundled C compiler (SC1.0) doesn't compile Ghostscript
properly with the <code>-fast</code> option: Ghostscript core-dumps in
<code>build_gs_font</code>. With that compiler use <code>-g</code>,
or use gcc instead.</li>
<li>The Sun version of <code>dbx</code> often gives up with an error
message when trying to load Ghostscript. If this happens, use GNU
<code>gdb</code> instead. (<code>gdb</code> is more reliable than
<code>dbx</code> in other ways as well.)</li>
<li>A bug in some versions of <code>zlib</code> results in an undefined
symbol <code>zmemcmp</code> when compiling with Sun cc. Use gcc
instead.</li>
</ul>
<h4><a name="Solaris"></a>Solaris</h4>
<ul>
<li>Solaris 2.2 may require setting "<code>EXTRALIBS=-lsocket</code>".
Solaris 2.3 and later seem to require "<code>EXTRALIBS=-lnsl -lsocket -lposix4</code>".</li>
<li>For Solaris 2.6 (and possibly some other versions), if you set
<code>SHARE_LIBPNG=1</code>, <code>SHARE_ZLIB=1</code>, or
<code>SHARE_JPEG=1</code>, you may need to set</li>
<p>
<code>XLDFLAGS=-R /usr/local/</code>xxx<code>/lib:/usr/local/lib</code></p>
<p>
using the full path names of the relevant directories.</p>
<li>Solaris 2.<em>n</em> uses <code>/usr/openwin/share/include</code>
for the X11 libraries rather than <code>/usr/local/X/include</code>.</li>
<li>Solaris 2.<em>n</em> typically has Type 1 fonts in
<code>/usr/openwin/lib/X11/fonts/Type1/outline</code>.</li>
<li>For Solaris 2.<code>n</code> in the makefile you must change
the definition of <code>INSTALL</code> from "<code>install -c</code>" to
"<code>/usr/ucb/install -c</code>".</li>
<li>You may need to set <code>XLIBDIR</code> to the directory that holds
the X11 libraries, as for other SVR4 systems. Set <code>-DSVR4</code>
in <code>CFLAGS</code>.</li>
<li>If you are using the SunPRO C compiler, don't use optimization level
<code>-xO3</code>. On SPARC platforms the compiler hangs; on Intel
platforms the generated code is incorrect. With this compiler on Intel, do
not use the <code>-native</code> flag: floating point computations
become unacceptably inaccurate. You can use <code>-xcg92</code> (SPARC
V8) and <code>-dalign</code> for better performance.</li>
<li>One user reported compiling from source on a Linux NFS mounted
volume failed. Compiling from a local volume was the workaround.</li>
</ul>
<hr>
<h2><a name="Other_environments"></a>Other environments</h2>
<h3><a name="No_multi_thread"></a>Environments lacking multi-threading</h3>
<p>
All environments mentioned here by name have multi-threading capability.
However, if your environment doesn't, you can remove all need for
multi-threading by setting <code>SYNC=nosync</code> in the top-level
makefile. Note that you will not be able to use any so-called "async"
drivers (drivers that overlap interpretation and rasterization) if you do
this. No such drivers are in the <code>DEVICE_DEVS*</code> lists of any
makefile that we distribute.</p>
<h3><a name="Plan_9"></a>Plan 9</h3>
<p>
Use <code>unix-gcc.mak</code>, editing it to define</p>
<blockquote><code>
CC=cc
GCFLAGS=-D_BSD_EXTENSION -DPlan9
</code></blockquote>
<p>
You will also probably have to edit many path names.</p>
<hr>
<h2><a name="UFST_build"></a>How to build Ghostscript with UFST</h2>
<p>
<em>Note: This section is only for customers who have a Monotype Imaging UFST license.
Other users please skip this section.</em></p>
<p>
Ghostscript sources do not include UFST sources. You need to obtain them separately.
The Ghostscript distributed source include only some source modules that provide a
bridge to UFST. You will also need an additional, UFST specific makefile: contact
Ghostscript support for more information</p>
<p>
If optioned in, the Ghostscript build system will build the UFST as part of the normal
bulid process (previously, the UFST was required to be built separately).</p>
<p>
To build Ghostscript with UFST, specify additional options for "make":</p>
<dl>
<dt><code>UFST_BRIDGE=1</code></dt>
<dd>forces the UFST bridge to build.</dd>
<dt><code>UFST_ROOT=path</code></dt>
<dd>specifies the path to UFST root directory or folder.</dd>
<dt><code>UFST_CFLAGS=options</code></dt>
<dd>specifies C compiler options for UFST library. Refer to UFST manual for information about them.</dd>
<dt><code>UFST_LIB_EXT=extension</code></dt>
<dd>sets the file name extension for object libraries. You must use the appropriate one for your platform and linker.</dd>
</dl>
<p>An example for Unix/GCC :</p>
<blockquote>
<tt>UFST_BRIDGE=1 UFST_ROOT=../ufst UFST_CFLAGS=-DGCCx86 UFST_LIB_EXT=.a</tt>
</blockquote>
<p>Starting with Ghostscript 9.x (Summer 2010), the above options are conveniently
inserted in the <code>Makefile</code> with
(this also automatically disable the freetype bridge):</p>
<blockquote>
<code>./configure --with-ufst=../ufst</code>
</blockquote>
<p>For Windows/MSVC you need only specify UFST_ROOT.
msvc.mak sets the other options automatically.</p>
<!-- [2.0 end contents] ==================================================== -->
<!-- [3.0 begin visible trailer] =========================================== -->
<hr>
<p>
<small>Copyright © 2000-2019 Artifex Software, Inc. All rights reserved.</small>
<p>
This software is provided AS-IS with no warranty, either express or
implied.
This software is distributed under license and may not be copied, modified
or distributed except as expressly authorized under the terms of that
license. Refer to licensing information at http://www.artifex.com/
or contact Artifex Software, Inc., 1305 Grant Avenue - Suite 200,
Novato, CA 94945, U.S.A., +1(415)492-9861, for further information.
<p>
<small>Ghostscript version 9.50, 15 October 2019
<!-- [3.0 end visible trailer] ============================================= -->
<!--FINISH EDITING HERE-->
</div>
</div>
</div>
<div class="footer">
<div class="row">
<div class="col-7 footleft">
<ul>
<li><a href="https://artifex.com/contact-us/" target="blank">CONTACT US</a></li>
<li><a href="https://artifex.com/about-us/" target="blank">ABOUT</a></li>
<li><a href="https://ghostscript.com/security.html">SECURITY</a></li>
</ul>
</div>
<div class="col-1 footcenter">
<ul>
<li><a href="https://artifex.com/support/" target="blank">SUPPORT</a></li>
<li><a href="https://artifex.com/blog/artifex/" target="blank">BLOG</a></li>
<li><a href="https://artifex.com/privacy-policy/" target="blank">PRIVACY</a></li>
</ul>
</div>
<div class="col-ft-3 footright"><img src="images/Artifex_logo.png" width="194" height="40" alt=""/> <br>
© Copyright 2019 Artifex Software, Inc. <br>
All rights reserved.
</div>
</div>
</div>
<script src="http://cdnjs.cloudflare.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
<script src="index.js"></script>
</body>
</html>
|