Cross-compiling doc update

This commit is contained in:
nhmall
2020-05-31 12:41:36 -04:00
parent 8a91a22df9
commit 157d54ca27
+28 -24
View File
@@ -1,4 +1,4 @@
Cross-compiling NetHack 3.7 Last edit: December 1, 2019 Cross-compiling NetHack 3.7 Last edit: May 31, 2020
The NetHack 3.7 build process differs from the build process of previous The NetHack 3.7 build process differs from the build process of previous
versions in some important ways that make it possible to use a cross-compiler versions in some important ways that make it possible to use a cross-compiler
@@ -281,16 +281,19 @@ On the HOST, here are the mandatory things that have to be built.
for use in linking other HOST utilities if the HOST-native obj files for use in linking other HOST utilities if the HOST-native obj files
produced from them are still around. produced from them are still around.
NOTE: Other source files (src/drawing.c) that need to NOTE: There are some source files that need to be compiled for linking
be compiled for native HOST utilities, also need to be compiled again into utilities that are needed on the HOST side, but that are also
later as TARGET obj files for linking into the TARGET executable. It is needed again later as TARGET obj files for linking into the TARGET
important to keep the compiled HOST-side obj files produced by the HOST executable, and therefore must be compiled twice.
native compiler, and the TARGET-side obj files produced by the They include: src/drawing.c, src/objects.c, src/monst.c,
cross-compiler separate and distinct from one another. That can be done src/alloc.c, util/panic.c. It is important to keep the compiled
either by naming the differing object files a little differently HOST-side obj files produced by the HOST native compiler distinct from
(perhaps with a suffix), or by placing the HOST-side obj files and the the TARGET-side obj files produced by the cross-compiler. That can be
TARGET-side obj files into different folders during the build process. accomplished either by naming the generated object files a little
Whatever works best for your cross-compile. differently (perhaps with a suffix) between the HOST-side and the
TARGET-side, or by placing the HOST-side obj files and the TARGET-side
obj files into distinct, different directories during the build process.
Use whatever method works best for your cross-compile effort and tools.
util/dlb util/dlb
@@ -356,23 +359,24 @@ Using the cross-compiler, build the following targets:
-DCROSSCOMPILE and -DCROSSCOMPILE_TARGET -DCROSSCOMPILE and -DCROSSCOMPILE_TARGET
core sources (2019): src/allmain.c, src/alloc.c, src/apply.c, core sources (2019): src/allmain.c, src/alloc.c, src/apply.c,
src/artifact.c, src/attrib.c, src/ball.c, src/bones.c, src/artifact.c, src/attrib.c, src/ball.c,
src/botl.c, src/cmd.c, src/dbridge.c, src/decl.c, src/bones.c, src/botl.c, src/cmd.c, src/dbridge.c,
src/detect.c, src/dig.c, src/display.c, src/dlb.c, src/decl.c, src/detect.c, src/dig.c, src/display.c,
src/do.c, src/do_name.c, src/do_wear.c, src/dog.c, src/dlb.c, src/do.c, src/do_name.c, src/do_wear.c,
src/dogmove.c, src/dokick.c, src/dothrow.c, src/dog.c, src/dogmove.c, src/dokick.c,
src/drawing.c, src/dungeon.c, src/eat.c, src/end.c, src/dothrow.c, src/drawing.c, src/dungeon.c,
src/engrave.c, src/exper.c, src/explode.c, src/eat.c, src/end.c, src/engrave.c, src/exper.c,
src/extralev.c, src/files.c, src/fountain.c, src/explode.c, src/extralev.c, src/files.c,
src/hack.c, src/hacklib.c, src/insight.c, src/fountain.c, src/hack.c, src/hacklib.c,
src/invent.c, src/isaac64.c, src/insight.c, src/invent.c, src/isaac64.c,
src/light.c, src/lock.c, src/mail.c, src/light.c, src/lock.c, src/mail.c,
src/makemon.c, src/mapglyph.c, src/mcastu.c, src/makemon.c, src/mapglyph.c, src/mcastu.c,
src/mdlib.c, src/mhitm.c, src/mhitu.c, src/minion.c, src/mdlib.c, src/mhitm.c, src/mhitu.c, src/minion.c,
src/mklev.c, src/mkmap.c, src/mkmaze.c, src/mkobj.c, src/mklev.c, src/mkmap.c, src/mkmaze.c, src/mkobj.c,
src/mkroom.c, src/mon.c, src/mondata.c, src/monmove.c, src/mkroom.c, src/mon.c, src/mondata.c,
src/monst.c, src/mplayer.c, src/mthrowu.c, src/muse.c, src/monmove.c, src/monst.c, src/mplayer.c,
src/music.c, src/nhlsel.c, src/nhlua.c, src/nhlobj.c, src/mthrowu.c, src/muse.c, src/music.c,
src/nhlsel.c, src/nhlua.c, src/nhlobj.c,
src/o_init.c, src/objects.c, src/objnam.c, src/o_init.c, src/objects.c, src/objnam.c,
src/options.c, src/pager.c, src/pickup.c, src/options.c, src/pager.c, src/pickup.c,
src/pline.c, src/polyself.c, src/potion.c, src/pline.c, src/polyself.c, src/potion.c,