X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=doc%2Fsdccman.lyx;h=1be9988329041bd2e8979637028c5ba56b3ba562;hb=737dac29e879ca0925019d8db9cf0e0195798c31;hp=4b6e8028e48d5eadec7e9bf167d431d0efb851e6;hpb=0b4f65e90705f8658cfff3ab6a6d450d8ae5dfad;p=fw%2Fsdcc diff --git a/doc/sdccman.lyx b/doc/sdccman.lyx index 4b6e8028..1be99883 100644 --- a/doc/sdccman.lyx +++ b/doc/sdccman.lyx @@ -104,7 +104,7 @@ SDCC Compiler User Guide \begin_layout Date \size normal -SDCC 2.7.2 +SDCC 2.7.3 \size footnotesize \newline @@ -6279,6 +6279,28 @@ sdcclib libint.lib _moduint.rel \family sans \series bold sdcclib libint.lib _mulint.rel +\family default +\series default + +\newline + +\end_layout + +\begin_layout Standard +Or, if you preffer: +\family sans +\series bold + +\newline + +\end_layout + +\begin_layout Standard + +\family sans +\series bold +sdcclib libint.lib _divsint.rel _divuint.rel _modsint.rel _moduint.rel _mulint.rel +\family default \series default \newline @@ -6287,7 +6309,120 @@ sdcclib libint.lib _mulint.rel \begin_layout Standard If the file already exists in the library, it will be replaced. - To see what modules and symbols are included in the library, options -s + If a list of .rel files is available, you can tell sdcclib to add those + files to a library. + For example, if the file 'myliblist.txt' contains +\family sans +\series bold + +\newline + +\end_layout + +\begin_layout Standard + +\family sans +\series bold +_divsint.rel +\end_layout + +\begin_layout Standard + +\family sans +\series bold +_divuint.rel +\end_layout + +\begin_layout Standard + +\family sans +\series bold +_modsint.rel +\end_layout + +\begin_layout Standard + +\family sans +\series bold +_moduint.rel +\end_layout + +\begin_layout Standard + +\family sans +\series bold +_mulint.rel +\family default +\series default + +\newline + +\end_layout + +\begin_layout Standard +Use +\family sans +\series bold + +\newline + +\end_layout + +\begin_layout Standard + +\family sans +\series bold +sdcclib -l libint.lib myliblist.txt +\family default +\series default + +\newline + +\end_layout + +\begin_layout Standard +Additionally, you can instruct sdcclib to compiles the files before adding + them to the library. + This is achieved using the environment variables SDCCLIB_CC +\begin_inset LatexCommand \index{SDCCLIB_CC} + +\end_inset + + and/or SDCCLIB_AS +\begin_inset LatexCommand \index{SDCCLIB_AS} + +\end_inset + +. + For example: +\family sans +\series bold + +\newline + +\end_layout + +\begin_layout Standard + +\family sans +\series bold +set SDCCLIB_CC=sdcc -c +\end_layout + +\begin_layout Standard + +\family sans +\series bold +sdcclib -l libint.lib myliblist.txt +\family default +\series default + +\newline + +\end_layout + +\begin_layout Standard +To see what modules and symbols are included in the library, options -s and -m are available. For example: \newline @@ -8090,6 +8225,38 @@ status collapsed Causes the linker to use old style for allocating memory areas. \end_layout +\begin_layout List +\labelwidthstring 00.00.0000 + +\series bold +- +\begin_inset ERT +status collapsed + +\begin_layout Standard + + +\backslash +/ +\end_layout + +\end_inset + +-acall-ajmp +\series default +\InsetSpace ~ + +\begin_inset LatexCommand \index{-\/-acall-ajmp} + +\end_inset + + Replaces the three byte instructions lcall/ljmp with the two byte instructions + acall/ajmp. + Only use this option if your code is in the same 2k block of memory. + You may need to use this option for some 8051 derivatives which lack the + lcall/ljmp instructions.. +\end_layout + \begin_layout Standard \begin_inset VSpace bigskip \end_inset @@ -35618,6 +35785,34 @@ replace { lcall %1 } by { acall %1 } replace { ljmp %1 } by { ajmp %1 } \end_layout +\begin_layout Standard +(NOTE: from version 2.7.3 on, you can use option - +\emph on + +\begin_inset ERT +status collapsed + +\begin_layout Standard + + +\backslash +/ +\end_layout + +\end_inset + + +\emph default +-acall-ajmp +\begin_inset LatexCommand \index{-\/-acall-ajmp} + +\end_inset + +, which also takes care of aligning the interrupt vectors properly.) +\newline + +\end_layout + \begin_layout Standard The \emph on