comparison doc/manual/manual_build.tex @ 76:7ca46969e0ad

- tweaks in manual, mainly for html generation
author cslag
date Mon, 21 Mar 2016 01:15:37 +0100
parents 8326c5ced916
children b47168dacba6
comparison
equal deleted inserted replaced
75:a59ae4370202 76:7ca46969e0ad
50 This is a detailed overview of platforms and their build tools that are known to build 50 This is a detailed overview of platforms and their build tools that are known to build
51 \product{dyncall}:\\ 51 \product{dyncall}:\\
52 \\ 52 \\
53 53
54 54
55 \begin{tabular}{l l l} 55 \begin{tabular*}{0.75\textwidth}{lll}
56 \textbf{{\large Platform}} & Build Tool(s) & Compiler, SDK \\ 56 \textbf{Platform} & Build Tool(s) & Compiler, SDK \\
57 \hline 57 \hline
58 \textbf{{\large Windows}} & nmake,Visual Studio & cl, cygwin (gcc), mingw (gcc) \\ 58 \textbf{Windows} & nmake,Visual Studio & cl, cygwin (gcc), mingw (gcc) \\
59 \textbf{{\large Unix-like}} & GNU/BSD/Sun make & gcc, clang, sunc \\ 59 \textbf{Unix-like} & GNU/BSD/Sun make & gcc, clang, sunc \\
60 \textbf{{\large Plan9}} & mk & 8c \\ 60 \textbf{Plan9} & mk & 8c \\
61 \textbf{{\large Haiku/BeOS}} & GNU make & gcc \\ 61 \textbf{Haiku/BeOS} & GNU make & gcc \\
62 \textbf{{\large iOS/iPhone}} & GNU make & gcc and iPhone SDK on Mac OS X \\ 62 \textbf{iOS/iPhone} & GNU make & gcc and iPhone SDK on Mac OS X \\
63 \textbf{{\large Nintendo DS}} & nmake & devkitPro\cite{devkitPro} tools on Windows \\ 63 \textbf{Nintendo DS} & nmake & devkitPro\cite{devkitPro} tools on Windows \\
64 \textbf{{\large Playstation Portable}} & GNU make & psptoolchain\cite{psptoolchain} tools \\ 64 \textbf{Playstation Portable} & GNU make & psptoolchain\cite{psptoolchain} tools \\
65 65 \end{tabular*}\\
66 \end{tabular}\\
67 66
68 \pagebreak 67 \pagebreak
69 68
70 \subsection{Build instructions} 69 \subsection{Build instructions}
71 70
78 ./configure [--option ...] 77 ./configure [--option ...]
79 \end{lstlisting} 78 \end{lstlisting}
80 79
81 Available options (omit for defaults): 80 Available options (omit for defaults):
82 81
83 \begin{tabular}{ll} 82 \begin{tabular*}{0.75\textwidth}{ll}
84 {\tt --help} & display help \\ 83 {\tt --help} & display help \\
85 {\tt --prefix=\textit{path}} & specify installation prefix (Unix shell) \\ 84 {\tt --prefix=\textit{path}} & specify installation prefix (Unix shell) \\
86 {\tt --target=\textit{platform}} & MacOSX,iOS,iPhoneSimulator,PSP,... \\ 85 {\tt --target=\textit{platform}} & MacOSX,iOS,iPhoneSimulator,PSP,... \\
87 {\tt --sdk=\textit{version}} & SDK version \\ 86 {\tt --sdk=\textit{version}} & SDK version \\
88 \end{tabular} 87 \end{tabular*}
89 88
90 \paragraph{Windows flavour, and cross-build from Windows (PSP, NDS, etc.)} 89 \paragraph{Windows flavour, and cross-build from Windows (PSP, NDS, etc.)}
91 90
92 \begin{lstlisting} 91 \begin{lstlisting}
93 .\configure [/option ...] 92 .\configure [/option ...]
94 \end{lstlisting} 93 \end{lstlisting}
95 94
96 Available options: 95 Available options:
97 96
98 \begin{tabular}{ll} 97 \begin{tabular*}{0.75\textwidth}{ll}
99 {\tt /?} & display help \\ 98 {\tt /?} & display help \\
100 {\tt /prefix \textit{path}} & set installation prefix (GNU make only) \\ 99 {\tt /prefix \textit{path}} & set installation prefix (GNU make only) \\
101 {\tt /prefix-bd \textit{path}} & set build directory prefix (GNU make only) \\ 100 {\tt /prefix-bd \textit{path}} & set build directory prefix (GNU make only) \\
102 {\tt /target-x86} & build for x86 architecture (default) \\ 101 {\tt /target-x86} & build for x86 architecture (default) \\
103 {\tt /target-x64} & build for x64 architecture \\ 102 {\tt /target-x64} & build for x64 architecture \\
104 {\tt /target-psp} & build for PlayStation Portable (homebrew SDK) \\ 103 {\tt /target-psp} & build for PlayStation Portable (homebrew SDK) \\
105 {\tt /target-nds-arm} & build for Nintendo DS (devkitPro, ARM mode) \\ 104 {\tt /target-nds-arm} & build for Nintendo DS (devkitPro, ARM mode) \\
106 {\tt /target-nds-thumb} & build for Nintendo DS (devkitPro, THUMB mode) \\ 105 {\tt /target-nds-thumb} & build for Nintendo DS (devkitPro, THUMB mode) \\
107 {\tt /tool-msvc} & use Microsoft Visual C++ compiler (default) \\ 106 {\tt /tool-msvc} & use Microsoft Visual C++ compiler (default) \\
108 {\tt /tool-gcc} & use GNU Compiler Collection \\ 107 {\tt /tool-gcc} & use GNU Compiler Collection \\
109 {\tt /asm-ml} & use Microsoft Macro Assembler (default) \\ 108 {\tt /asm-ml} & use Microsoft Macro Assembler (default) \\
110 {\tt /asm-as} & use the GNU Assembler \\ 109 {\tt /asm-as} & use the GNU Assembler \\
111 {\tt /asm-nasm} & use NASM Assembler \\ 110 {\tt /asm-nasm} & use NASM Assembler \\
112 {\tt /config-release} & build release version (default) \\ 111 {\tt /config-release} & build release version (default) \\
113 {\tt /config-debug} & build debug version \\ 112 {\tt /config-debug} & build debug version \\
114 \end{tabular} 113 \end{tabular*}
115 114
116 115
117 \paragraph{Plan 9 flavour} 116 \paragraph{Plan 9 flavour}
118 117
119 \begin{lstlisting} 118 \begin{lstlisting}
120 ./configure.rc [--option ...] 119 ./configure.rc [--option ...]
121 \end{lstlisting} 120 \end{lstlisting}
122 121
123 Available options (none, at the moment): 122 Available options (none, at the moment):
124 123
125 \begin{tabular}{ll} 124 \begin{tabular*}{0.75\textwidth}{ll}
126 {\tt --help} & display help \\ 125 {\tt --help} & display help \\
127 \end{tabular} 126 \end{tabular*}
128 127
129 128
130 \item Build the static libraries \product{dyncall}, \product{dynload} and \product{dyncallback} 129 \item Build the static libraries \product{dyncall}, \product{dynload} and \product{dyncallback}
131 \begin{lstlisting} 130 \begin{lstlisting}
132 make # for {GNU,BSD} Make 131 make # for {GNU,BSD} Make