Changes between Initial Version and Version 1 of Documentation/BuildingStXTroubleshooting

Timestamp:

Dec 11, 2013, 11:49:56 PM (10 years ago)

Author:

jan vrany

Comment:

--

Documentation/BuildingStXTroubleshooting

@@ +1 @@
+= Troubleshooting Smalltalk/X build process =
+
+Despite all the time we invest into a new build environment, the building process is still not 
+fool proof and things may go wrong. Easily than you may think :-) This page contains description of 
+some of common problems and provides some hints.
+
+Obviously, this list is incomplete and we'll add more as we'll go by...
+
+== How to generate symbols ==
+You cannot compile librun? Do you have your symbols.h empty?
+{{{
+cd <builder>/build/stx/librun
+rm -rf symbols.h
+make STC=../stc/stc symbols.h
+}}}
+
+== I updated {{{rbspec}}} files, re-compiled but the new projects are not included ==
+ * Go to the <buildtree>/builder/build/projects/smalltalk
+ * Use
+{{{
+make clobber
+rake compile
+}}}
+
+== How to create *.c file? ==
+For example, you have {{{InstvarAccessSample.st}}}. To create *c file, type:
+{{{
+make InstvarAccessSample.c
+}}}
+
+Do not forget to delete the *c file after it becomes obsolete. rake/make '''does not''' automatically delete the *c files, but it uses them to do the *so library.
+
+== I have a build error ==
+This might be tricky, now
+
+=== stx: not founf ===
+{{{
+/bin/sh: stc: not found
+make[1]: *** [__STANDARD_C_RULE__] Error 127
+}}}
+
+Use 
+{{{
+make STC=../stc/stc
+}}}
+
+
+== Why there are no sources for librun and stc? ==
+These sources are not available. You have to either ask [http://www.exept.de eXept] or
+use precompiled versions.