author: kx <kx@radix-linux.su> 2024-12-20 16:11:07 +0300
committer: kx <kx@radix-linux.su> 2024-12-20 16:11:07 +0300
commit: 868b2b66b564b5c00e3a74d10be45db7151627ac
parent: cce2ae8d3312493b7653358bb4af201d3271377b
Commit Summary:
Diffstat:
6 files changed, 128 insertions, 0 deletions
diff --git a/doc/README.libtool b/doc/README.libtool
new file mode 100644
index 0000000..5af970f
--- /dev/null
+++ b/doc/README.libtool
@@ -0,0 +1,93 @@
+
+/*******************************************************************
+
+ MPU Library Versioning:
+ ======================
+
+ VERSION (major.minor.micro):
+ ---------------------------
+ - major - version changes when the library’s API was modified,
+ - minor - version changes when the library’s functionality was
+ modified in a backwards-compatible manner,
+ - micro - version changes when backwards-compatible bug fixes
+ or code changes were made.
+ NOTE:
+ ----
+ The VERSION value in this file should be equal to version
+ which declared in the configure.ac file on the following
+ function call:
+
+ AC_INIT([MPU Library], [1.0.0], ...
+
+
+ LT_RELEASE (-release major.minor):
+ ---------------------------------
+ - major - version changes when the library’s API was changed,
+ - minor - version changes when backwards-compatible bug fixes
+ or code changes were made.
+
+ LT_VERSION_INFO (-version-info current:revision:age):
+ ----------------------------------------------------
+ - current - version changes when the library’s interface was
+ modified (in this case the revision value is
+ reset to zero),
+ - revision - version changes when the library’s source was
+ changed,
+ - age - version increases when one new function was added
+ and decreases one old function was removed.
+
+
+ EXAMPLE 1:
+ ---------
+ 1. Begin with the previous version information: 0:0:0
+ 2. 0:0:0 becomes 0:1:0 (the library’s source was changed)
+ 3. 0:1:0 becomes 1:0:0 (the library’s interface was modified)
+ 4. 1:0:0 becomes 1:0:1 (one new function was added)
+ 5. 1:0:1 becomes 1:0:0 (one old function was removed)
+
+ EXAMPLE 2:
+ ---------
+ Let’s modify our example just a little to say that we’ve added
+ a new library interface function but haven’t removed anything.
+ Start again with the original version information of 0:0:0 and
+ follow the algorithm:
+
+ 1. Begin with the previous version information: 0:0:0
+ 2. 0:0:0 becomes 0:1:0 (the library’s source was changed)
+ 3. 0:1:0 becomes 1:0:0 (the library’s interface was modified)
+ 4. 1:0:0 becomes 1:0:1 (one new function was added)
+ 5. Not applicable (nothing was removed)
+
+ This time, we end up with a Libtool version string of 1:0:1,
+ but the resulting Linux or Solaris shared-library filename is
+ libname.so.0.1.0. Consider for a moment what it means, in the
+ face of major, minor, and patch-level values, to have a nonzero
+ age value in the Libtool version string. An age value of one
+ (as in this case) means that we are effectively still supporting
+ a Linux major value of zero, because this new version of the
+ library is 100-percent backward compatible with the previous
+ version. The minor value in the shared-library filename has been
+ incremented from zero to one to indicate that this is, in fact,
+ an updated version of the soname, libname.so.0. The patch-level
+ value remains at zero because this value indicates a bug fix to
+ a particular minor revision of an soname.
+
+
+ Libtool creates .so suffix for Linux by following manner:
+
+ major=.`expr $current - $age`
+ versuffix="$major.$age.$revision"
+
+ for Cygwin:
+
+ major=`expr $current - $age`
+ versuffix="-$major"
+
+ The declaration in the Makefile.am has to be like this:
+
+ lib_LTLIBRARIES = libtest-1.0.la
+ libtest_1_0_la_LDFLAGS = -version-info 0:0:0
+
+ where 1.0 is a release number of the test library.
+
+ *******************************************************************/
diff --git a/doc/autogen-examples/auto-clean.sh b/doc/autogen-examples/auto-clean.sh
new file mode 100755
index 0000000..eda502f
--- /dev/null
+++ b/doc/autogen-examples/auto-clean.sh
@@ -0,0 +1,40 @@
+#!/bin/sh
+
+cd ../..
+
+if [ -f "Makefile" ] ; then
+ make distclean
+fi
+
+rm -rf autom4te.cache
+
+rm -f Makefile
+rm -f Makefile.in
+rm -f config.h
+rm -f config.h.in
+rm -f config.log
+rm -f config.status
+rm -f compile config.guess config.sub
+rm -f configure
+rm -f install-sh
+rm -f ltmain.sh
+rm -f missing
+rm -f stamp-h1
+rm -f aclocal.m4
+rm -f depcomp
+
+rm -rf mpu/.deps
+rm -f mpu/Makefile
+rm -f mpu/Makefile.in
+
+rm -f po/Makefile
+rm -f po/Makefile.in
+rm -f po/POTFILES
+rm -f po/remove-potcdate.sed
+rm -f po/stamp-po
+rm -f po/*.gmo
+rm -f po/*~
+
+rm -f m4/*~
+
+rm -f *~
diff --git a/doc/autogen-examples/bootstrap-cross.sh b/doc/autogen-examples/bootstrap-cross.sh
new file mode 100644
index 0000000..aa5e3f6
--- /dev/null
+++ b/doc/autogen-examples/bootstrap-cross.sh
@@ -0,0 +1,6 @@
+#!/bin/sh
+
+TARGET_DEST_DIR=/home/kx/prog/scm/svn/platform/trunk-672/dist/.s9xx-glibc/enybox-x2
+
+cd ../..
+./bootstrap --target-dest-dir=${TARGET_DEST_DIR}
diff --git a/doc/autogen-examples/bootstrap.sh b/doc/autogen-examples/bootstrap.sh
new file mode 100755
index 0000000..59b68f5
--- /dev/null
+++ b/doc/autogen-examples/bootstrap.sh
@@ -0,0 +1,4 @@
+#!/bin/sh
+
+cd ../..
+./bootstrap
diff --git a/doc/autogen-examples/configure-cross.sh b/doc/autogen-examples/configure-cross.sh
new file mode 100644
index 0000000..12e276e
--- /dev/null
+++ b/doc/autogen-examples/configure-cross.sh
@@ -0,0 +1,19 @@
+#!/bin/sh
+
+cd ../..
+
+TARGET_DEST_DIR=/home/kx/prog/scm/svn/platform/trunk-672/dist/.s9xx-glibc/enybox-x2
+TOOLCHAIN_PATH=/opt/toolchain/aarch64-S9XX-linux-glibc/1.1.4/bin
+TARGET=aarch64-s9xx-linux-gnu
+
+TARGET_INCPATH="-L${TARGET_DEST_DIR}/usr/include"
+CFLAGS="${TARGET_INCPATH}"
+CPPFLAGS="${TARGET_INCPATH}"
+LDFLAGS="-L${TARGET_DEST_DIR}/lib -L${TARGET_DEST_DIR}/usr/lib"
+
+
+DIALOG_CONFIG=${TARGET_DEST_DIR}/usr/bin/dialog-config \
+STRIP="${TOOLCHAIN_PATH}/${TARGET}-strip" \
+CC="${TOOLCHAIN_PATH}/${TARGET}-gcc --sysroot=${TARGET_DEST_DIR}" \
+./configure --prefix=/usr \
+ --build=x86_64-pc-linux-gnu --host=${TARGET}
diff --git a/doc/autogen-examples/configure.sh b/doc/autogen-examples/configure.sh
new file mode 100755
index 0000000..fa79368
--- /dev/null
+++ b/doc/autogen-examples/configure.sh
@@ -0,0 +1,5 @@
+#!/bin/sh
+
+cd ../..
+
+./configure --prefix=/usr