Update Changelog and Readme to v2.1.0, fix Changelog format

CHANGELOG.md

@@ -1,10 +1,102 @@
-v2.0.0
-===============================================================================
+Change Log
+================================================================================
+
+All notable changes to the project _Matjaž's dotfiles_ will be documented in
+this file. This project adheres to [Semantic Versioning](http://semver.org/).
+
+
+v2.1.0
+----------------------------------------
 
 
-Added
+### Added
+
+- Aliases:
+    - `gpg` instead of `gpg2`.
+    - `weather` forecast.
+    - `py` instead of `python3`.
+    - `dot` for the dotfiles directory.
+    - `pipupgrade` to upgrade all globally installed Python3 packages.
+    - `traffic` for the LTE quota.
+    - `filetypes` in a directory recursively.
+    - [Mac] `httpserve` serve a directory with an HTTP server in python.
+    - [Mac] `cmdc` and `cmdv` aliases to interact with the clipboard.
+    - [Mac] `information` about a file, all of it.
+    - [Mac] `thumbnailize` to create 600px wide thumbnails for my blog.
+    - [Mac] `htop` instead of `sudo htop`
+- New dotfiles:
+    - For SQLite's command line interface `sqlite`.
+    - For PostgreSQL command line interface `psql`.
+    - `ssh` configuration file.
+- New function: 
+    - Python virtual enviroment ZSH prompt and function to `activate` it.
+    - `isodate` and `unixtime` function to quickly get the two most standard
+      formats, but also to convert them.
+- More files for Git to ignore:
+    - Netbeans.
+    - C objects.
+    - LaTeX generated files (except for `pdf`).
+- Emacs new settings:
+    - Spell checking with aspell.
+    - Better tabbing, untabbing and newline behaviour.
+    - Backup and auto-save file are created to the `~/.emacs.d/` directory.
+    - Session restore on Emacs start.
+    - Open new files in buffers, not frames.
+    - Deactivate bell sound.
+- Ubuntu Server configuration:
+    - Swapfile creation.
+    - Hostname setup.
+    - User setup (adding a user, user's shell).
+    - Installing an updated Git.
+    - System locale.
+- Oh My Zsh Autojump with the `j` command.
+- Update Node.js packages in the `full_system_updater.sh`.
+- `mosh` gets installed on all systems.
+- [Ubuntu] The installed behaves differently if the user has no root 
+  permissions.
+- [Ubuntu] The script catches a SIGINT (CTRL+C)
+- [Mac] MacTeX executables added to `$PATH`.
+- [Mac] Homebrew formulas are installed with the options they need.
+- [Mac] More, more, more Homebrew formulas and fasks.
+
+
+## Changed
+
+- Prompts are improved: each script has its own so you know what is running.
+- Improved `gitignore` function to accept multiple files and show the content 
+  of `.gitignore` if no file is given.
+- Default `git push` is set to `simple`.
+- ZSH theme has a very cool `r☢☢t` warning when superuser.
+- Theme file reorganization.
+- Midnight commander's configuration was revisited.
+- [Ubuntu] Git gets installed by `apt-get` if does not pre-exists on the 
+  Ubuntu/Debian system.
+- [Mac] Updated `psql` alias to PostgreSQL 9.5.
+- [Mac] `htop` was updated from v0.8.x to v2.x.x.
+
+
+## Removed
+
+- [Ubuntu] `apt-get dist-upgrade` was removed, substituted with `upgrade` for 
+  compatibily of the upgraded programs.
+
+
+## Fixed
+
+- The title sizes in this changelog and the header to make it compatible
+  with the [Keep a Changelog](http://keepachangelog.com) format.
+- Syntax errors in the code.
+- [Ubuntu] Wrong `gpg` package name.
+- [Ubuntu] `wget` instead of `curl`.
+
+
+
+v2.0.0
 ----------------------------------------
 
+
+### Added
+
 - One `git` branch per operative system:
     - currently `debian-ubuntu` and `mac-osx`
     - removes portability issues of any configuration file or script
@@ -14,28 +106,31 @@ Added
 - Explicit license header in every file, except Markdown files
 
 
-Changed
-----------------------------------------
+### Changed
 
 - Typo in `LICENSE.md` (missing "the copyright holder")
 - Adapted `README.md` to the new branches
 
 
-Removed
-----------------------------------------
+### Removed
 
 - Portability of operative-system specific scripts
 - Anything except `README.md`, `LICENSE.md` and `CHANGELOG.md` from `master` 
   branch
+
 
+### Fixed
+
+Nothing.
 
-v1.2.0
-===============================================================================
 
 
-Added
+v1.2.0
 ----------------------------------------
 
+
+### Added
+
 - `wget-infinite` and `wget-infinite-status` aliases to start a background
   `wget` download that retries from where it stopped until completion
 - `gpg` configuration dotfile
@@ -46,24 +141,47 @@ Added
   back to `.pdf`. Usually is the best compression without visible quality loss.
 
 
-Changed
-----------------------------------------
+### Changed
 
 - OS dependant `mc` alias to start it inside its wrapper, which allows exiting
   `mc` in the directory that `mc` was showing
 - Update `numerus` alias from Java version of _Numerus_ (_Numerus_) to C version
 - Activate tree view in `htop`
-- prettier changelog
+- Prettier changelog
 
 
+### Removed
 
-v1.1.1
-===============================================================================
+Nothing.
+
+
+### Fixed
 
+Nothing.
 
-Fixed
+
+
+v1.1.1
 ----------------------------------------
 
+
+### Added
+
+Nothing.
+
+
+### Changed
+
+Nothing.
+
+
+### Removed
+
+Nothing.
+
+
+### Fixed
+
 - _Emacs_ installs packages without errors when they are already installed
 - Ensured execution of correct _Emacs_ init file
 - Portable upgrade of `pip3`, removed errors with permissions
@@ -75,11 +193,10 @@ Fixed
 
 
 v1.1.0
-===============================================================================
+----------------------------------------
 
 
-Added
-----------------------------------------
+### Added
 
 - Installer interactivity (REPL): offer 8 possible task to choose at run-time to
   allow user to perform just some (like only symlinking or git-cloning the
@@ -88,15 +205,43 @@ Added
   the packages it needs for the setup (as specified in `emacs_init.el`)
 - Improved quality of console output strings
 
+### Changed
 
+Nothing.
 
-v1.0.1
-===============================================================================
 
+### Removed
+
+Nothing.
+
+
+### Fixed
+
+Nothing.
 
-Fixed
+
+
+v1.0.1
 ----------------------------------------
 
+
+### Added
+
+Nothing.
+
+
+### Changed
+
+Nothing.
+
+
+### Removed
+
+Nothing.
+
+
+### Fixed
+
 - Portability fixes:
     -`zsh_path` is now portable also on non-OS X systems
     - Fix non portable home directory in `zshrc`
@@ -107,11 +252,10 @@ Fixed
 
 
 v1.0.0
-===============================================================================
+----------------------------------------
 
 
-Added
-----------------------------------------
+### Added
 
 - Dotfiles for:
     - Emacs
@@ -130,3 +274,17 @@ Added
     - list of mostly useful packages
     - license, readme and this changelog
 
+
+### Changed
+
+Nothing.
+
+
+### Removed
+
+Nothing.
+
+
+### Fixed
+
+Nothing.

README.md

@@ -22,13 +22,13 @@ by `ssh`.
 Installation of _Matjaž's dotfiles_
 ----------------------------------------
 
-This repository has no dotfiles on the master branch but there is **one _Git_ 
-branch for each operative system**. This helps using the OS-specific packager 
-managers (`apt-get`, `brew`, ...) and make OS-specific changes (for instance 
-`mc` and `htop` have different configuration files on Linux and OS X).
+This repository has no installers and other scripts on the `common` branch but
+there is **one _Git_ branch for each operative system**. This helps using the
+OS-specific packager managers (`apt-get`, `brew`, ...) and make OS-specific
+changes (for instance `htop` has different configurations on Linux and OS X).
 
 **To install _Matjaž's dotfiles_, run one of the following commands**. It 
-downloads and run the installer for your specific OS found in that OS's branch.
+downloads and runs the installer for your specific OS found in that OS's branch.
 
 The installer should handle all the rest with an **interactive command line 
 interface**. It installs the dotfiles repository (by default in 
@@ -43,22 +43,31 @@ _Git_ is required by the installer to clone the branch of your OS.
 Basically Linuxes with `apt-get`.
 
 ```bash
+# Using wget
+bash -c "$(wget https://raw.github.com/TheMatjaz/dotfiles/debian-ubuntu/matjaz_dotfiles_installer.sh -O -)"
+
 # Using curl
 bash -c "$(curl -fsSL https://raw.github.com/TheMatjaz/dotfiles/debian-ubuntu/matjaz_dotfiles_installer.sh)"
-
-# Or using wget
-bash -c "$(wget https://raw.github.com/TheMatjaz/dotfiles/debian-ubuntu/matjaz_dotfiles_installer.sh -O -)"
 ```
 
 
 ### Apple OS X (Mac)
 
+> **CAUTION!**  
+> This installer has NEVER BEEN TESTED because I have not yet installed another
+> OS X system. Use it at your own risk.
+
 ```bash
 # Using curl
 bash -c "$(curl -fsSL https://raw.github.com/TheMatjaz/dotfiles/mac-osx/matjaz_dotfiles_installer.sh)"
 ```
 
 
+### Other OSs
+
+No other OSs yet, but any contribution is welcome!
+
+
 What is each dotfile for?
 ----------------------------------------
 
@@ -71,17 +80,13 @@ What is each dotfile for?
 - [`zsh_aliases`](zsh_aliases): custom aliases and functions for the zsh
 - [`zsh_fino_custom.zsh-theme`](zsh_fino_custom.zsh-theme): a customized `fino`
   theme for _Oh My ZSH!_
-- [`gitconfig`](gitconfig): general _Git_ settings
 - [`gitignore_global`](gitignore_global): a list of files _Git_ should ignore in
   any repository. Those are used also by Mercurial
-- [`hgrc`](hgrc): general _Mercurial_ settings
 - [`emacs_init.el`](emacs_init.el): _Emacs_ configuration that also installs 
   some ELPA packages, if not already installed, to completely clone an existing
   configuration
-- [`htoprc`](htoprc): looks and columns for `htop` process viewer
-- [`screenrc`](screenrc): basic settings of `screen` terminal multiplexer
-- [`wgetrc`](wgetrc): global configurations of the `wget` command line
-  downloader
+
+The others are pretty obvious from the filenames alone.
 
 
 #### Installers/automation scripts
@@ -94,7 +99,7 @@ What is each dotfile for?
       _Oh My ZSH!_
     - placing the proper symlinks to activate the dotfiles
     - performing system updates
-    - and a few more small things
+    - and a few more small things such as locale setting, hostname, swapfile
 - [`new_system_packages_installer.sh`](new_system_packages_installer.sh)
   installs some packages which the Matjaž's dotfiles are for. It calls the
   system's package manager. **Can be run stand-alone**. The 
@@ -105,7 +110,7 @@ What is each dotfile for?
   The `matjaz_dotfiles_installer.sh` calls it optionally during the install.
 - [`useful_packages.md`](useful_packages.md) is a simple list containing
   packages generally worth installing on any system (it's not an executable,
-  just a memo).
+  just a memo). It is not available on the `common` branch.
 
 
 License