* doc/sdccman.lyx: documented ar format libraries

git-svn-id: https://sdcc.svn.sourceforge.net/svnroot/sdcc/trunk/sdcc@5374 4a8a32a2-be11-0410-ad9d-d568d2c75423

diff --git a/ChangeLog b/ChangeLog
index ee45364baf80c8bd37416a5d341560c3bcf60bdb..2d031aa94cda2d73ad204f76a04d3e2845fb06cc 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2008-02-11 Borut Razem <borut.razem AT siol.net>
+
+       * doc/sdccman.lyx: documented ar format libraries
+

 2008-02-10 Frieder Ferlemann <Frieder.Ferlemann AT web.de>
 
        * support/regression/tests/float_single.c: added regression 
 2008-02-10 Frieder Ferlemann <Frieder.Ferlemann AT web.de>
 
        * support/regression/tests/float_single.c: added regression 

diff --git a/doc/sdccman.lyx b/doc/sdccman.lyx
index a949aecabd82e4ea46571492c5287d99bde66efc..9b11f7b8178f8ccde047104b4a31b47e7f0552fd 100644 (file)
--- a/doc/sdccman.lyx
+++ b/doc/sdccman.lyx
@@ -1,4 +1,4 @@
-#LyX 1.5.6 created this file. For more info see http://www.lyx.org/
+#LyX 1.5.7 created this file. For more info see http://www.lyx.org/

 \lyxformat 276
 \begin_document
 \begin_header
 \lyxformat 276
 \begin_document
 \begin_header


@@ -7082,6 +7082,84 @@ name "-\\/-debug"
  is embedded in the library file itself.
  Library files created using sdcclib are used as described in the preceding
  sections.
  is embedded in the library file itself.
  Library files created using sdcclib are used as described in the preceding
  sections.

+\end_layout
+
+\begin_layout Subsection
+Using sdcclib to Create and Manage Libraries
+\begin_inset LatexCommand index
+name "ar"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Support for ar format libraries was introduced in sdcc 2.9.0.
+ Ar is a standard archive managing utility on unices (Linux, Mac OS X, several
+ unix flavors) so it is not included in the sdcc package.
+\series bold
+
+\newline
+
+\newline
+
+\series default
+For Windows platform you can find ar utility in GNU binutils package included
+ in several projects: Cygwin at 
+\begin_inset LatexCommand url
+target "http://www.cygwin.com/"
+
+\end_inset
+
+, MinGW at 
+\begin_inset LatexCommand url
+target "http://www.mingw.org/"
+
+\end_inset
+
+.
+\series bold
+
+\newline
+
+\newline
+
+\series default
+Both the GNU and BSD ar format variants are suppurated by asxxxx linkers.
+ Ar doesn't understand the asxxxx object file format, so there is a special
+ version of ranlib distributed with sdcc, called asranlib, which produces
+ the ar symbol lookup table.
+\series bold
+
+\newline
+
+\newline
+
+\series default
+To create a library containing asxxxx object files, you should use the following
+ sequence:
+\series bold
+
+\newline
+
+\end_layout
+
+\begin_layout Standard
+
+\family sans
+\series bold
+ar -Sq <library name>.lib <list of .rel files>
+\end_layout
+
+\begin_layout Standard
+
+\family sans
+\series bold
+asranlib <library name>.lib
+\end_layout
+
+\begin_layout Standard

 \begin_inset VSpace bigskip
 \end_inset
 
 \begin_inset VSpace bigskip
 \end_inset