From: bernhardheld Date: Fri, 14 Feb 2003 22:37:41 +0000 (+0000) Subject: * doc/sdccman.lyx: Environment variables, -o and other minor things X-Git-Url: https://git.gag.com/?a=commitdiff_plain;h=c385de6ebbfa9ebc8a02d95d1b31be656af6b445;p=fw%2Fsdcc * doc/sdccman.lyx: Environment variables, -o and other minor things git-svn-id: https://sdcc.svn.sourceforge.net/svnroot/sdcc/trunk/sdcc@2271 4a8a32a2-be11-0410-ad9d-d568d2c75423 --- diff --git a/ChangeLog b/ChangeLog index 2ea5e440..6588b6a0 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2003-02-14 Bernhard Held + + * doc/sdccman.lyx: Environment variables, -o and other minor things + 2003-02-14 * src/xa51/main.c: before anyone really tries to use it :) diff --git a/doc/sdccman.lyx b/doc/sdccman.lyx index 651e1db2..84368988 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 @@ -2027,6 +2018,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 @@ -2408,6 +2412,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 +3006,9 @@ Interrupt Numbers and the corresponding address & descriptions for the Standard \begin_inset Tabular - - - + + + \begin_inset Text @@ -3755,7 +3869,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,