Start removing dependency on boilerplate

Author: cirosantilli

.vimrc

@@ -4,24 +4,44 @@
 
 C and C++ information, cheatsheets and mini-projects.
 
-There may be other compiled languages here for which we don't have much material for a separate repository, specially when we interface that language with C. E.g.: Fortran.
-
 Relies on <https://github.com/cirosantilli/cpp-boilerplate> to factor code out. See [its documentation](https://github.com/cirosantilli/cpp-boilerplate/blob/master/README.md) for information on how to use this project.
 
 ## Most useful files
 
-- [c.c](c.c):              C cheatsheet.
-- [cpp.cpp](main_cpp.cpp): C++ cheatsheet.
-- [posix](posix/):         POSIX C API.
+- [c.c](c.c): C cheatsheet
+- [cpp.cpp](main_cpp.cpp): C++ cheatsheet
+- [posix](posix/): POSIX C API
+- [multifile/](multifile/): `include`, `extern` vs `static`, dynamic libraries, cross language calls
+- [gcc/](gcc/): GCC extensions
 - [opengl/](opengl/)
 - [kde/](kde/)
 
-## Quickstart
+Less useful files:
+
+- [cmake](cmake.md)
+- [fortran/](fortran/)
+- [hello_world.c](hello_world.c)
+- [hello_world.c](hello_world.c)
+
+## Dependencies
+
+Most builds require:
+
+- `make` (POSIX)
+- `gcc` >= 4.7
+- `g++` >= 4.7
+
+Even though we use GNU tools by default, great attention is paid to portability of portable subjects like ANSI C, which should compile in any compiler.
+
+In addition, each directory may have their own extra dependencies as stated in their README.
 
-On Ubuntu 12.04:
+You can install dependencies on latest LTS Ubuntus with:
 
     ./configure
-    make run
+
+Other system install are not going to be supported as that would lead to too much maintenance overhead. If you don't have Ubuntu, consider using our [Vagrantfile](Vagrantfile).
+
+## Usage
 
 When there are multiple files compiled, e.g.:
 
@@ -35,15 +55,7 @@ run a given file by specifying the basename without extension:
 
 The `=` sign is *not* optional!
 
-Doing just `make run` in those cases will run the default file.
-
-To print the generated assembly code to the screen use:
-
-    make asm RUN=cpp
-
-To get help on all options use:
-
-    make help
+Doing just `make run` in those cases will run the default file: `main`.
 
 ## Style
 

.vimrc_many

@@ -383,10 +383,10 @@ int setjmp_func(int jmp, jmp_buf env_buf) {
         return 1;
 }
 
-/* # Functions */
+/* Functions */
 
     /*
-    # declaration vs #definition
+    #Declaration vs #definition
     */
 
         /*
@@ -678,6 +678,15 @@ int setjmp_func(int jmp, jmp_buf env_buf) {
             *j += *add;
         }
 
+    /*
+    This declaration is required!
+
+    - http://stackoverflow.com/questions/6312597/is-inline-without-static-or-extern-ever-useful-in-c99
+    - http://stackoverflow.com/questions/12747198/compiling-error-when-std-gnu99-and-inline-function-is-used
+    */
+    int inline_func(int i);
+    inline int inline_func(int i) { return i + 1; }
+
 #if __STDC_VERSION__ >= 199901L
         int static_array_argument(int is[static 3]) {
             return is[3];
@@ -2676,27 +2685,6 @@ int main(int argc, char **argv) {
         }
     }
 
-    /*
-    # inline keyword
-
-        Signals the compiler that it may be worth to copy paste the function instead of calling it.
-
-        The compiler is not obliged
-
-        effects:
-
-        - avoids function call, thus potentially faster
-        - code gets larger
-        - function pointer comparisons may differ for the same function
-        - instruction cache might be come less efficient making thigs slower
-
-        sources:
-
-        - <http://www.greenend.org.uk/rjk/tech/inline.html>
-
-            some warnings about inline and its usage
-    */
-
     /*
     # typedef
 
@@ -5405,7 +5393,7 @@ int main(int argc, char **argv) {
                 */
                 {
                     int is[] = {0, 1, 2};
-                    for (int i = 0, j = 10; i < 20; ++i, ++j) {
+                    for (int i = 0, j = 0; j < 30; ++i, j += 10) {
                         assert(i == is[i]);
 
                         /* ERROR: redeclaration. */
@@ -5868,6 +5856,30 @@ int main(int argc, char **argv) {
             }
 #endif
 
+            /*
+            # inline keyword
+
+                Signals the compiler that it may be worth to copy paste the function instead of calling it.
+
+                The compiler is not obliged
+
+                effects:
+
+                - avoids function call, thus potentially faster
+                - code gets larger
+                - function pointer comparisons may differ for the same function
+                - instruction cache might be come less efficient making thigs slower
+
+                Sources:
+
+                -   <http://www.greenend.org.uk/rjk/tech/inline.html>
+
+                    Some warnings about inline and its usage.
+            */
+            {
+                assert(inline_func(0) == 1);
+            }
+
         }
 
         /*
@@ -7356,10 +7368,15 @@ int main(int argc, char **argv) {
                     Modes:
 
                     -   `r`: read. compatible with a,w
+
                     -   `w`: read and write. destroy if exists, create if not.
+
                     -   `a`: append. write to the end. creates if does not exist.
+
                     -   `+`: can do both input and output. msut use flush or fseek
+
                     -   `x`: don't destroy if exist (c11, not c++!)
+
                     -   `b`: binary.
 
                         Means nothing in POSIX systems.

.vimrc_one

@@ -1,3 +1,5 @@
+# CMake
+
 Make alternative that aims to be:
 
 -   more cross platform: works on Linux and Windows

README.md

@@ -1,34 +1,16 @@
 #!/usr/bin/env bash
-# This cannot be put into makefiles because some systems don't have make installed.
-set -e
-distro_id="$(lsb_release -i | sed -r 's/.*:\t(.*)/\1/')"
-distro_version="$(lsb_release -r | sed -r 's/.*:\t(.*)/\1/')"
-if [ "$distro_id" = "Ubuntu" ]; then
-  sudo apt-get update
-  sudo apt-get install -y aptitude
-  sudo aptitude install -y build-essential
-  # C and C++
-  sudo aptitude install -y python-software-properties
-  sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
-  sudo aptitude update
-  sudo aptitude install -y gcc-4.8
-  sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 50
-  sudo aptitude install -y g++-4.8
-  sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.8 50
-  # Fortran
-  sudo aptitude install -y gfortran-4.8
-elif [ "$distro_id" = "Debian" ]; then
-  sudo apt-get update
-  sudo apt-get install aptitude
-  sudo aptitude install -y build-essential
-  sudo aptitude install -y g++
-else
-  echo 'Automatic dependency installation is not supported on your system.'
-  printf 'Dependencies are:
-gcc >= 4.7
-gfortran >= 4.7
-g++ >= 4.7
-make
-'
-  exit 1
-fi
+# This cannot be put into makefiles because
+# some systems don't have make installed.
+sudo apt-get update
+sudo apt-get install -y aptitude
+sudo aptitude install -y build-essential
+# C and C++
+sudo aptitude install -y python-software-properties
+sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
+sudo aptitude update
+sudo aptitude install -y gcc-4.8
+sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 50
+sudo aptitude install -y g++-4.8
+sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.8 50
+# Fortran
+sudo aptitude install -y gfortran-4.8