autotools: fix missing tags and out of border errors

Signed-off-by: Manuel Traut <manut@linutronix.de>

1 files changed, 90 insertions, 85 deletions

diff --git a/distribution/autotools/autotools.tex b/distribution/autotools/autotools.tex
index 30791d4..eb8d6f9 100644
--- a/distribution/autotools/autotools.tex
+++ b/distribution/autotools/autotools.tex
@@ -23,8 +23,8 @@
 
 int main(int argc, char **argv)
 {
-	printf("Hello World\n");
-	return 0;
+    printf("Hello World\n");
+    return 0;
 }
 \end{verbatim}
 \end{frame}
@@ -44,8 +44,8 @@ int main(int argc, char **argv)
 hello:
 
 install:
-	install -d /usr/bin
-	install hello /usr/bin/hello
+    install -d /usr/bin
+    install hello /usr/bin/hello
 \end{verbatim}
 
 \begin{verbatim}
@@ -64,8 +64,8 @@ use a template 'Makefile.in'
 hello:
 
 install:
-	install -d @exec_prefix@
-	install hello @exec_prefix@/hello
+    install -d @exec_prefix@
+    install hello @exec_prefix@/hello
 \end{verbatim}
 and run './configure --exec-prefix=/opt/bin'
 \end{frame}
@@ -116,8 +116,8 @@ the generated Makefile:
 hello:
 
 install:
-	install -d /opt/bin/hello
-	install hello /opt/bin/hello
+    install -d /opt/bin/hello
+    install hello /opt/bin/hello
 \end{verbatim}
 \end{frame}
 
@@ -153,9 +153,9 @@ include 'config.h' in main.c and use the PACKAGE\_STRING define:
 
 int main(int argc, char **argv)
 {
-	printf(PACKAGE_STRING "\n\n")
-	printf("Hello World\n");
-	return 0;
+    printf(PACKAGE_STRING "\n\n")
+    printf("Hello World\n");
+    return 0;
 }
 \end{verbatim}
 \begin{verbatim}
@@ -208,18 +208,14 @@ Makefile.am: error: required file './NEWS' not found
 Makefile.am: error: required file './README' not found
 Makefile.am: error: required file './AUTHORS' not found
 Makefile.am: error: required file './ChangeLog' not found
-Makefile.am: installing './COPYING' using GNU General Public License v3 file
-Makefile.am:     Consider adding the COPYING file to the version control system
-Makefile.am:     for your code, to avoid questions about which license your project uses
+Makefile.am: installing './COPYING' using GNU General Public License v3
+Makefile.am:     Consider adding the COPYING file to the version contro
+Makefile.am:     for your code, to avoid questions about which license 
 Makefile.am: installing './depcomp'
-/usr/share/automake-1.15/am/depend2.am: error: am__fastdepCC does not appear in AM_CONDITIONAL
-/usr/share/automake-1.15/am/depend2.am:   The usual way to define 'am__fastdepCC' is to add 'AC_PROG_CC'
-/usr/share/automake-1.15/am/depend2.am:   to 'configure.ac' and run 'aclocal' and 'autoconf' again
-/usr/share/automake-1.15/am/depend2.am: error: AMDEP does not appear in AM_CONDITIONAL
-/usr/share/automake-1.15/am/depend2.am:   The usual way to define 'AMDEP' is to add one of the compiler tests
-/usr/share/automake-1.15/am/depend2.am:     AC_PROG_CC, AC_PROG_CXX, AC_PROG_OBJC, AC_PROG_OBJCXX,
-/usr/share/automake-1.15/am/depend2.am:     AM_PROG_AS, AM_PROG_GCJ, AM_PROG_UPC
-/usr/share/automake-1.15/am/depend2.am:   to 'configure.ac' and run 'aclocal' and 'autoconf' again
+/usr/share/automake-1.15/am/depend2.am: error: am__fastdepCC does not a
+...
+/usr/share/automake-1.15/am/depend2.am:     AM_PROG_AS, AM_PROG_GCJ, AM
+/usr/share/automake-1.15/am/depend2.am:   to 'configure.ac' and run 'ac
 Makefile.am: error: C source seen but 'CC' is undefined
 Makefile.am:   The usual way to define 'CC' is to add 'AC_PROG_CC'
 Makefile.am:   to 'configure.ac' and run 'autoconf' again.
@@ -246,14 +242,14 @@ Some other files are mandatory, create them:
 \frametitle{remember 2nd part of the errors}
 \begin{verbatim}
 % autoreconf -sif
-/usr/share/automake-1.15/am/depend2.am: error: am__fastdepCC does not appear in AM_CONDITIONAL
-/usr/share/automake-1.15/am/depend2.am:   The usual way to define 'am__fastdepCC' is to add 'AC_PROG_CC'
-/usr/share/automake-1.15/am/depend2.am:   to 'configure.ac' and run 'aclocal' and 'autoconf' again
-/usr/share/automake-1.15/am/depend2.am: error: AMDEP does not appear in AM_CONDITIONAL
-/usr/share/automake-1.15/am/depend2.am:   The usual way to define 'AMDEP' is to add one of the compiler tests
-/usr/share/automake-1.15/am/depend2.am:     AC_PROG_CC, AC_PROG_CXX, AC_PROG_OBJC, AC_PROG_OBJCXX,
-/usr/share/automake-1.15/am/depend2.am:     AM_PROG_AS, AM_PROG_GCJ, AM_PROG_UPC
-/usr/share/automake-1.15/am/depend2.am:   to 'configure.ac' and run 'aclocal' and 'autoconf' again
+/usr/share/automake-1.15/am/depend2.am: error: am__fastdepCC does n
+/usr/share/automake-1.15/am/depend2.am:   The usual way to define '
+/usr/share/automake-1.15/am/depend2.am:   to 'configure.ac' and run
+/usr/share/automake-1.15/am/depend2.am: error: AMDEP does not appea
+/usr/share/automake-1.15/am/depend2.am:   The usual way to define '
+/usr/share/automake-1.15/am/depend2.am:     AC_PROG_CC, AC_PROG_CXX
+/usr/share/automake-1.15/am/depend2.am:     AM_PROG_AS, AM_PROG_GCJ
+/usr/share/automake-1.15/am/depend2.am:   to 'configure.ac' and run
 Makefile.am: error: C source seen but 'CC' is undefined
 Makefile.am:   The usual way to define 'CC' is to add 'AC_PROG_CC'
 Makefile.am:   to 'configure.ac' and run 'autoconf' again.
@@ -277,7 +273,7 @@ rerun autoconf
 % autoreconf -sif
 configure.ac:11: installing './compile'
 \end{verbatim}
-
+\end{frame}
 
 \begin{frame}[fragile]
 \frametitle{generate a Makefile}
@@ -288,7 +284,7 @@ was generated!
 % make
 make  all-am
 make[1]: Entering directory '/home/local/hello'
-gcc -DHAVE_CONFIG_H -I.     -g -O2 -MT hello.o -MD -MP -MF .deps/hello.Tpo -c -o hello.o hello.c
+gcc -DHAVE_CONFIG_H -I.     -g -O2 -MT hello.o -MD -MP -MF
 mv -f .deps/hello.Tpo .deps/hello.Po
 gcc  -g -O2   -o hello hello.o
 make[1]: Leaving directory '/home/local/hello'
@@ -346,12 +342,16 @@ All needed steps are executed automatically!
 \end{description}
 \end{block}
 \begin{block}{install}
+\begin{description}
 \item[install] takes care on DESTDIR environment variable
+\end{description}
 \end{block}
 \begin{block}{dist}
+\begin{description}
 \item[dist] generates a hello-1.0.tar.gz
 \item[distcheck] same as dist, but checks if the sw can be build with files
-	included in the tarball.
+    included in the tarball.
+\end{description}
 \end{block}
 \end{frame}
 
@@ -386,6 +386,8 @@ the typical workflow is
 #!/bin/sh
 autoreconf -sif
 \end{verbatim}
+
+
 \begin{verbatim}
 % chmod +x autogen.sh
 % git add autogen.sh
@@ -401,15 +403,14 @@ autoreconf -sif
 AUTHORS autogen.sh ChangeLog   configure.ac COPYING
 hello.c INSTALL    Makefile.am NEWS         README
 \end{verbatim}
-'AUTHORS, ChangeLog, COPYING, INSTALL, NEWS' and 'README' are
-mandatory text files, that describe the project.
-
-'autogen.sh' is an (optional) one-liner script
-
-'Makefile.am' are two lines and even simpler than the inital Makefile
-
-'configure.ac' a template can be generated with 'autoscan' at least
-'AM\_INIT\_AUTOMAKE' needs to be added manually.
+\begin{description}
+\item[AUTHORS, ChangeLog, COPYING, INSTALL, NEWS, README] are
+mandatory text files, that describe the project
+\item[autogen.sh] is an (optional) one-liner script
+\item[Makefile.am] are two lines and even simpler than the inital Makefile
+\item[configure.ac] a template can be generated with 'autoscan' at least
+AM\_INIT\_AUTOMAKE needs to be added manually.
+\end{description}
 \end{frame}
 
 \begin{frame}[fragile]
@@ -444,17 +445,17 @@ int gui_display (char *msg);
 static WINDOW *mainwin;
 
 int gui_init (void) {
-	mainwin = initscr ();
-	if (!mainwin) return -ENOMEM;
-	return 0;
+    mainwin = initscr ();
+    if (!mainwin) return -ENOMEM;
+    return 0;
 }
 
 void gui_free (void) {
-	delwin (mainwin); endwin (); refresh ();
+    delwin (mainwin); endwin (); refresh ();
 }
 
 int gui_display (char *msg) {
-	mvaddstr (strlen (msg), 33, msg); refresh ();
+    mvaddstr (strlen (msg), 33, msg); refresh ();
 }
 \end{verbatim}
 \end{frame}
@@ -471,15 +472,15 @@ int gui_display (char *msg) {
 
 int main (int argc, char **argv)
 {
-	printf (PACKAGE_STRING "\n\n");
-	if (gui_init ()) {
-		perror("init gui failed:");
-		return -1;
-	}
-	gui_display ("Hello GUI!");
-	sleep (10);
-	gui_free ();
-	return ret;
+    printf (PACKAGE_STRING "\n\n");
+    if (gui_init ()) {
+        perror("init gui failed:");
+        return -1;
+    }
+    gui_display ("Hello GUI!");
+    sleep (10);
+    gui_free ();
+    return ret;
 }
 \end{verbatim}
 \end{frame}
@@ -523,6 +524,7 @@ we use 'ncurses' so let's retrieve the compiler and linker options:
 % pkg-config --libs ncurses
 -lncurses -ltinfo
 \end{verbatim}
+\end{frame}
 
 \begin{frame}[fragile]
 \frametitle{simply add the output to Makefile.am?}
@@ -606,9 +608,9 @@ compile and test application:
 \begin{verbatim}
 % git status
 ...
-	gui.o
-	hello-gui.o
-	hello-hello.o
+    gui.o
+    hello-gui.o
+    hello-hello.o
 ...
 % echo '*.o' >> .gitignore
 % git add gui.c gui.h Makefile.am configure.ac hello.c .gitignore
@@ -628,7 +630,7 @@ and the gui components are build.
 \frametitle{implement configure switch}
 add this in 'configure.ac':
 \begin{verbatim}
-AC_ARG_WITH([gui], AS_HELP_STRING([--with-ncurses-gui], [Build with GUI]))
+AC_ARG_WITH([gui], AS_HELP_STRING([--with-ncurses-gui], [build GUI]))
 if test "x$with_gui" = "xyes"; then
   PKG_CHECK_MODULES([NCURSES], [ncurses],
                     [AC_DEFINE([HAVE_GUI],[1],["ncurses available"])])
@@ -642,7 +644,7 @@ AM_CONDITIONAL([HAVE_GUI], [test x$with_gui = xyes])
 \end{description}
 \end{frame}
 
-\begin{frame}
+\begin{frame}[fragile]
 \frametitle{only build GUI if specified}
 'Makefile.am':
 \begin{verbatim}
@@ -656,7 +658,7 @@ endif
 \end{verbatim}
 \end{frame}
 
-\begin{frame}
+\begin{frame}[fragile]
 \frametitle{only call gui if compiled in}
 'hello.c':
 \begin{verbatim}
@@ -666,22 +668,22 @@ endif
 #endif
 ...
 #ifdef HAVE_GUI
-	ret = gui_init ();
-	if (ret) {
-		perror("init gui failed:");
-		return ret;
-	}
+    ret = gui_init ();
+    if (ret) {
+        perror("init gui failed:");
+        return ret;
+    }
 
-	gui_display ("Hello GUI!");
-	sleep (10);
+    gui_display ("Hello GUI!");
+    sleep (10);
 
-	gui_free ();
+    gui_free ();
 #endif
 ...
 \end{verbatim}
 \end{frame}
 
-\begin{frame}
+\begin{frame}[fragile]
 \frametitle{build with and without gui}
 \begin{verbatim}
 % ./configure --with-gui
@@ -759,15 +761,17 @@ unsigned int fibonacci (unsigned int fib) {
 'fib/Makefile.am':
 \begin{verbatim}
 lib_LTLIBRARIES = libfib.la
-# 1) If the library source code has changed at all since the last update, then
-#    increment revision ("c:r:a" becomes "c:r+1:a").
-# 2) If any interfaces have been added, removed, or changed since the last
-#    update, increment current, and set revision to 0.
+# 1) If the library source code has changed at all since the last update,
+*    then increment revision ("c:r:a" becomes "c:r+1:a").
+# 2) If any interfaces have been added, removed, or changed since the
+#    last update, increment current, and set revision to 0.
 # 3) If any interfaces have been added since the last public release,
 #    then increment age.
-# 4) If any interfaces have been removed or changed since the last public
-#    release, then set age to 0.
+# 4) If any interfaces have been removed or changed since the last
+#    public release, then set age to 0.
+
 libfib_la_LDFLAGS = -release @PACKAGE_VERSION@ -version-info 0:0:0
+
 libfib_la_SOURCES = fib.c
 include_HEADERS = fib.h
 \end{verbatim}
@@ -819,12 +823,12 @@ Makefile.am: installing './depcomp'
 
 \begin{frame}[fragile]
 \frametitle{what about the m4 macros warnings?}
-libtool wants to install its m4 scripts into the project.
-
-This is useful if you pass the project to other people that might have other
+\begin{itemize}
+\item libtool wants to install its m4 scripts into the project.
+\item This is useful if you pass the project to other people that might have other
 versions of libtool installed on their machine.
-
-prepare a directory for these scripts in 'autogen.sh':
+\item prepare a directory for these scripts in 'autogen.sh':
+\end{itemize}
 \begin{verbatim}
 #!/bin/sh
 mkdir -p m4
@@ -876,11 +880,12 @@ looks sane, but the pkg-config .pc file is missing
 
 \begin{frame}[fragile]
 \frametitle{add a libfib pkg-config .pc file}
-Remember, the .pc file contains the paths where the library and headers are
+\begin{itemize}
+\item Remember, the .pc file contains the paths where the library and headers are
 installed.
-
-These paths are defined by './configure' parameters. So we have to generate
+\item These paths are defined by './configure' parameters. So we have to generate
 a template 'fib/fib.pc.in':
+\end{itemize}
 \begin{verbatim}
 prefix=@prefix@
 exec_prefix=@exec_prefix@