X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=doc%2Fsdccman.lyx;h=4d528bf077c291ab369e58f1985b815f5ae0562f;hb=HEAD;hp=fabc8d8dd1cdcc6a04ea8989aaa4c5a4694579b6;hpb=dc6e77e0ac4f2f22846a0dbbbd835cf0198362d7;p=fw%2Fsdcc diff --git a/doc/sdccman.lyx b/doc/sdccman.lyx index fabc8d8d..4d528bf0 100644 --- a/doc/sdccman.lyx +++ b/doc/sdccman.lyx @@ -114,13 +114,13 @@ SDCC Compiler User Guide \begin_layout Date \size normal -SDCC 2.8.9 +SDCC 2.9.1 \size footnotesize \newline -$Date:: $ +$Date:: $ \newline -$Revision: 5272$ +$Revision$ \end_layout \begin_layout Standard @@ -203,7 +203,7 @@ name "aslink" \end_inset -, an open source retargetable assembler & linker. +, an free open source retargetable assembler & linker. SDCC has extensive language extensions suitable for utilizing various microcont rollers and underlying hardware effectively. @@ -735,11 +735,7 @@ Open Source \begin_layout Standard All packages used in this compiler system are \emph on -open source -\emph default - and -\emph on -freeware +free open source \emph default ; source code for all the sub-packages (pre-processor, assemblers, linkers etc.) is distributed with the package. @@ -4245,7 +4241,7 @@ Unpack the file using a command like: \family sans \series bold -"tar -xvzf sdcc-src-yyyymmdd-rrrr.tar.bz2 +"tar -xvjf sdcc-src-yyyymmdd-rrrr.tar.bz2 \begin_inset Quotes srd \end_inset @@ -4984,13 +4980,28 @@ cd ~\InsetSpace ~ \InsetSpace ~ \InsetSpace ~ \InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ # cd $HOME \end_layout \begin_layout Standard \family typewriter -tar -xzf sdcc.src.tar.gz\InsetSpace ~ +tar -xjf sdcc-src-yyyymmdd-rrrr.tar.bz2\InsetSpace ~ # extract source to directory sdcc \end_layout @@ -5006,6 +5017,21 @@ mkdir sdcc.build\InsetSpace ~ \InsetSpace ~ \InsetSpace ~ \InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ # put output in sdcc.build \end_layout @@ -5026,6 +5052,21 @@ cd sdcc.build \InsetSpace ~ \InsetSpace ~ \InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ +\InsetSpace ~ # configure is doing all the magic! \end_layout @@ -7853,7 +7894,7 @@ name "-\\/-lib-path " \begin_inset LatexCommand index -name "-L -\\/-lib-path" +name "-L " \end_inset @@ -10137,6 +10178,41 @@ name "Options other" \begin_layout List \labelwidthstring 00.00.0000 +\series bold +-v\InsetSpace ~ +- +\begin_inset ERT +status collapsed + +\begin_layout Standard + + +\backslash +/ +\end_layout + +\end_inset + +-version +\begin_inset LatexCommand index +name "-\\/-version" + +\end_inset + + +\begin_inset LatexCommand index +name "-v" + +\end_inset + + +\series default + displays the sdcc version. +\end_layout + +\begin_layout List +\labelwidthstring 00.00.0000 + \series bold -c\InsetSpace ~ - @@ -10160,7 +10236,7 @@ name "-\\/-compile-only" \begin_inset LatexCommand index -name "-c -\\/-compile-only" +name "-c" \end_inset @@ -21078,8 +21154,26 @@ name "printf()" \family typewriter printf_large.c \family default - does not support float (except on ds390). - To enable this, recompile it with the option + does not support float +\begin_inset LatexCommand index +name "Floating point support" + +\end_inset + + (except on ds390), only +\begin_inset LatexCommand index +name "" + +\end_inset + + +\begin_inset LatexCommand index +name "printf floating point support" + +\end_inset + + will be printed instead of the value. + To enable floating point output, recompile it with the option \emph on - \begin_inset ERT @@ -21107,7 +21201,7 @@ name "USE\\_FLOATS" \emph on - \begin_inset ERT -status collapsed +status open \begin_layout Standard @@ -21236,7 +21330,7 @@ mcs51 \begin_layout Standard printf \begin_inset LatexCommand index -name "printf" +name "printf()" \end_inset @@ -22382,7 +22476,7 @@ name "heap (malloc)" \begin_layout Verse \family typewriter -sdcc -c _heap.c -D HEAD_SIZE=2048 +sdcc -c _heap.c -D HEAP_SIZE=2048 \end_layout \begin_layout Standard @@ -24202,6 +24296,49 @@ status collapsed \begin_inset Text +\begin_layout Standard +SDCC_CHAR_UNSIGNED +\begin_inset LatexCommand index +name "SDCC\\_CHAR\\_UNSIGNED" + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +when +\emph on +- +\begin_inset ERT +status collapsed + +\begin_layout Standard + + +\backslash +/ +\end_layout + +\end_inset + +-funsigned-char +\emph default + option is used +\end_layout + +\end_inset + + + + +\begin_inset Text + \begin_layout Standard SDCC_STACK_TENBIT \begin_inset LatexCommand index @@ -25647,31 +25784,45 @@ name "PIC" \end_layout \begin_layout Standard -18F: 2220, 2221, 2320, 2321, 2331, 2410, 2420, 2423, 2431, 2450, 2455, 2480, - 24j10 +18F: 2220, 2221, 2320, 2321, 2331, 23k20 \end_layout \begin_layout Standard -18F: (2510,) 2515, 2520, 2523, 2525, 2550, 2580, 2585, 25j10, 2610, 2620, - 2680, 2682, 2685 +18F: 2410, 2420, 2423, 2431, 2450, 2455, 2480, 24j10, 24k20 \end_layout \begin_layout Standard -18F: 4220, 4221, 4320, 4321, 4331, 4410, 4420, 4423, 4431, 4450, 4455, 4480, - 44j10 +18F: 2510, 2515, 2520, 2523, 2525, 2550, 2580, 2585, 25j10, 25k20 \end_layout \begin_layout Standard -18F: 4510, 4515, 4520, 4523, 4525, 4550, 4580, 4585, 45j10, 4610, 4620, - 4680, 4682, 4685 +18F: 2610, 2620, 2680, 2682, 2685 \end_layout \begin_layout Standard -18F: 6520, 6585, 6620, 6680, 66j60, 66j65, 6720, 67j60 +18F: 4220, 4221, 4320, 4321, 4331, 43k20 \end_layout \begin_layout Standard -18F: 8520, 8585, 8620, 8680, 86j60, 86j65, 8720, 87j60 +18F: 4410, 4420, 4423, 4431, 4450, 4455, 4480, 44j10, 44k20 +\end_layout + +\begin_layout Standard +18F: 4510, 4515, 4520, 4523, 4525, 4550, 4580, 4585, 45j10, 45k20 +\end_layout + +\begin_layout Standard +18F: 4610, 4620, 4680, 4682, 4685, 46k20 +\end_layout + +\begin_layout Standard +18F: 6520, 6585, 65j50, 6620, 6680, 66j50, 66j55, 66j60, 66j65, 6720, 67j50, + 67j60 +\end_layout + +\begin_layout Standard +18F: 8520, 8585, 85j50, 8620, 8680, 86j50, 86j55, 86j60, 86j65, 8720, 87j50, + 87j60 \end_layout \begin_layout Standard @@ -27396,7 +27547,19 @@ Output of float values via printf() \begin_layout Standard The library is normally built without support for displaying float values, - only will appear instead of the value. + only +\begin_inset LatexCommand index +name "" + +\end_inset + + +\begin_inset LatexCommand index +name "printf floating point support" + +\end_inset + + will appear instead of the value. To change this, rebuild the library as stated above, but call \family typewriter ./configure.gnu --enable-floats @@ -30175,7 +30338,7 @@ reference "cha:Debugging-with-SDCDB" \end_layout \begin_layout Itemize -or (8051 specific) use a freeware/commercial simulator which interfaces +or (8051 specific) use a free open source/commercial simulator which interfaces to the AOMF \begin_inset LatexCommand index name "AOMF, AOMF51"