X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=doc%2Fsdccman.lyx;h=b961c03f6b1b3112e83bb261fbd9fb75c89b3a53;hb=315208ed05c5115661982da0deff5558c74042be;hp=651e1db2bcd2d0099c57a98c92dac4224b0edc42;hpb=19eb37fd0abc83f9e2491a3f9ac2033363954852;p=fw%2Fsdcc diff --git a/doc/sdccman.lyx b/doc/sdccman.lyx index 651e1db2..b961c03f 100644 --- a/doc/sdccman.lyx +++ b/doc/sdccman.lyx @@ -333,7 +333,7 @@ Installation Install and search paths \layout Standard -Linux (and other gcc-builds like Solaris, Cygwin, Mingw and OSX) by default +Linux (and other gcc-builds like Solaris, Cygwin, Mingw32 and OSX) by default install in /usr/local. You can override this when configuring with ---prefix-path. Subdirs used will be bin, share/sdcc/include, share/sdcc/lib and share/sdcc/doc. @@ -482,7 +482,7 @@ So, for windoze it is highly recommended to set the environment variable rd paths. \layout Subsection -Linux and other gcc-based systems (cygwin, mingw, osx) +Linux and other gcc-based systems (cygwin, mingw32, osx) \layout Enumerate @@ -583,7 +583,8 @@ Windows Install Using a Binary Package Download the binary package and unpack it using your favorite unpacking tool (gunzip, WinZip, etc). This should unpack to a group of sub-directories. - An example directory structure after unpacking the mingw package is: c: + An example directory structure after unpacking the mingw32 package is: + c: \backslash usr \backslash @@ -616,7 +617,7 @@ Adjust your environment variable PATH to include the location of the bin directory or start sdcc using the full path. \layout Subsubsection -Windows Install Using Cygwin and Mingw +Windows Install Using Cygwin and Mingw32 \layout Standard Follow the instruction in @@ -1713,16 +1714,6 @@ Linker Options \labelwidthstring 00.00.0000 -\series bold --o\SpecialChar ~ - -\series default -the output path resp. - file where everything will be placed -\layout List -\labelwidthstring 00.00.0000 - - \series bold -L\SpecialChar ~ ---lib-path @@ -2017,6 +2008,15 @@ Other Options \labelwidthstring 00.00.0000 +\series bold +--c1mode +\series default + reads the preprocessed source from standard input and compiles it. + The file name for the assembler output must be specified using the -o option. +\layout List +\labelwidthstring 00.00.0000 + + \series bold -E \series default @@ -2027,6 +2027,19 @@ Other Options \labelwidthstring 00.00.0000 +\series bold +-o\SpecialChar ~ + +\series default +The output path resp. + file where everything will be placed. + If the parameter is a path, it must have a trailing slash (or backslash + for the Windows binaries) to be recognized as a path. + +\layout List +\labelwidthstring 00.00.0000 + + \series bold ---stack-auto \series default @@ -2286,6 +2299,24 @@ cyclomatic complexity -V \series default Shows the actual commands the compiler is executing. +\layout List +\labelwidthstring 00.00.0000 + + +\series bold +---no-c-code-in-asm +\series default + Hides your ugly and inefficient c-code from the asm file, so you can always + blame the compiler :). +\layout List +\labelwidthstring 00.00.0000 + + +\series bold +---i-code-in-asm +\series default + Include i-codes in the asm file. + Looks like noise but is most helpfull for debugging the compiler itself. \layout Subsubsection Intermediate Dump Options @@ -2408,6 +2439,116 @@ Will create a dump of iCode's, after register assignment, into a file named Will cause all the above mentioned dumps to be created. \layout Subsection +Environment variables +\layout Standard + +SDCC recognizes the following environment variables: +\layout List +\labelwidthstring 00.00.0000 + + +\series bold +SDCC_LEAVE_SIGNALS +\series default + SDCC installs a signal handler to be able to delete temporary files after + an user break (^C) or an exception. + If this environment variable is set, SDCC won't install the signal handler + in order to be able to debug SDCC. +\layout List +\labelwidthstring 00.00.0000 + + +\series bold +TMP,\SpecialChar ~ +TEMP,\SpecialChar ~ +TMPDIR +\series default + Path, where temporary files will be created. + The order of the variables is the search order. + In a standard *nix environment these variables are not set, and there's + no need to set them. + On Windows it's recommended to set one of them. +\layout List +\labelwidthstring 00.00.0000 + + +\series bold +(coming\SpecialChar ~ +soon:\SpecialChar ~ +SDCC_BIN_PATH) +\series default + Path, see +\begin_inset Quotes sld +\end_inset + +2.1 Install and search paths +\begin_inset Quotes srd +\end_inset + +. +\layout List +\labelwidthstring 00.00.0000 + + +\series bold +(coming\SpecialChar ~ +soon:\SpecialChar ~ +SDCC_INCLUDE_PATH) +\series default + Path, see +\begin_inset Quotes sld +\end_inset + +2.1 Install and search paths +\begin_inset Quotes srd +\end_inset + +. +\layout List +\labelwidthstring 00.00.0000 + + +\series bold +(coming\SpecialChar ~ +soon:\SpecialChar ~ +SDCC_LIB_PATH) +\series default + Path, see +\begin_inset Quotes sld +\end_inset + +2.1 Install and search paths +\begin_inset Quotes srd +\end_inset + +. +\layout List +\labelwidthstring 00.00.0000 + + +\series bold +SDCCDIR\SpecialChar ~ +(soon\SpecialChar ~ +replaced\SpecialChar ~ +by:\SpecialChar ~ +SDCCPATH) +\series default + Path, see +\begin_inset Quotes sld +\end_inset + +2.1 Install and search paths +\begin_inset Quotes srd +\end_inset + +. +\layout Standard + +There are some more environment variables recognized by SDCC, but these + are solely used for debugging purposes. + They can change or disappear very quickly, and will never be documentated. +\layout Subsection + MCS51/DS390 Storage Class Language Extensions \layout Standard @@ -2892,9 +3033,9 @@ Interrupt Numbers and the corresponding address & descriptions for the Standard \begin_inset Tabular - - - + + + \begin_inset Text @@ -3755,7 +3896,7 @@ The same goes the other way, ie. labels defines in inline assembly CANNOT be accessed by C statements. \layout Subsection -int(16 bit) and long (32 bit) Support +int (16 bit) and long (32 bit) Support \layout Standard For signed & unsigned int (16 bit) and long (32 bit) variables, division,