Merge branch 'master' into master

.lgtm

@@ -1,2 +0,0 @@
-approvals = 2
-pattern = "(?i):shipit:|:\\+1:|LGTM|:ok_hand:"

CONTRIBUTING.md

@@ -1,15 +1,8 @@
 # Contributing
 
-- Your favourite command isn't covered?
-- You can think of more examples?
-
 Contribution are most welcome! All `tldr` pages are stored in Markdown right here on GitHub. Just open an issue or send a pull request and we'll merge it as soon as possible.
 
-*Note: when submitting a new command, don't forget to check if there's already a pull request in progress.*
-
-## Setup
-
-When setting up a brand new fork, run `make setup` to install the git pre-commit hook that will check errors in your changes with Markdown linter.
+*Note*: when submitting a new command, don't forget to check if there's already a pull request in progress.
 
 ## Guidelines
 
@@ -48,8 +41,99 @@ User-provided values should use the `{{token}}` syntax, to allow clients to high
 
 One of the reasons for this format is that it's well suited for command-line clients that need to extract a single description/example.
 
----------------------------------------
+## Submitting a pull request
 
-**Footnote:** tldr is under MIT license.
+TL;DR: fork, `make setup`, feature branch, commit, push, pull request.
+
+Detailed explanation:
+
+1. [Fork](http://help.github.com/fork-a-repo/) the project, clone your fork,
+   and configure the remotes:
+
+   ```bash
+   # Clone your fork of the repo into the current directory
+   git clone https://github.com/<your-username>/tldr
+   # Navigate to the newly cloned directory
+   cd tldr
+   # Assign the original repo to a remote called "upstream"
+   git remote add upstream https://github.com/tldr-pages/tldr
+   ```
+
+2. Setup Ruby, Rubygems, bundler, Git pre-commit hooks with Markdown linter.
+
+   ```bash
+   # Assuming Ruby is set up
+   # Install bundler Ruby gem
+   gem install bundler
+   make setup
+   ```
+
+3. If you cloned a while ago, get the latest changes from upstream:
+
+   ```bash
+   git checkout master
+   git pull upstream master
+   ```
+
+4. Create a new topic branch (sometimes they are called feature branches) off
+   the main project development branch:
+
+   ```bash
+   git checkout -b <topic-branch-name>
+   ```
+
+5. Run `make lint` to check that your page(s) are correct. Try to run the commands you are describing to ensure the syntax is correct.
+
+6. Please use the following commit message format: 
+   `<command>: type of change`.
+
+   Examples:
+
+   - `ls: add page`
+   - `cat: fix typo`
+   - `git-push: add --force example`
+   - `uname: fix -a example`
+
+7. Push your topic branch up to your fork:
+
+   ```bash
+   git push origin <topic-branch-name>
+   ```
+
+8. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/)
+    with a clear title and description.
+    
+    If page is not about a standard Unix/Linux tool, please include a link to the tool home page.
+    
+    If you are changing something non-trivial, not just adding a page for a new tool, please describe why you are doing this.
+
+9. Use Git's
+   [interactive rebase](https://help.github.com/articles/interactive-rebase)
+   feature to tidy up your commits before making them public.
+   
+   If you are not familiar with `git rebase`, it might be helpful to check out these video tutorials:
+   - [Git Rebase: squash last commits](https://www.youtube.com/watch?v=qh9KtjfjzCU)
+   - [Learning Git Tutorial: Interactive Rebasing](https://www.youtube.com/watch?v=NW46XmvJh5Q)
+   
+   In most cases it is better to squash commits before submitting a pull request.
+
+10. If you do not want to do a rebasing, you can overwrite your last commit in pull request, while you have only a single commit. You can achieve this with `git commit --amend` command.
+
+   ```bash
+   # When you are on topic branch of your pull request
+   # Fix your files
+   
+   git add .              # Register edited files
+   git commit --amend     # Do amended commit
+   git push --force       # Overwrite your branch
+   ```
+
+
+## Licensing
+
+`tldr` is under [MIT license](https://github.com/tldr-pages/tldr/blob/master/LICENSE.md).
+
+**IMPORTANT**: By submitting a patch, you agree to license your work under the
+same license as that used by the project.
 
 You're free to modify or redistribute the content. That being said, but why not contribute over here? :) Say if you wanted to have `tldr` pages in `groff` format, why not have a client that uses [pandoc](http://johnmacfarlane.net/pandoc/) and periodically updates straight from this repo?

Makefile

@@ -1,7 +1,5 @@
 default: lint
 
-all: setup index
-
 index:
 	@echo "WARNING!"
 	@echo "Index rebuilding is deprecated."
@@ -10,7 +8,18 @@ index:
 	@TLDRHOME=`pwd` ./scripts/build_index.rb
 	@echo "Index rebuilt."
 
-setup: hooks deps
+setup: prerequisites hooks deps
+
+prerequisites:
+	@echo
+	@echo "IMPORTANT!"
+	@echo "Before setting up hooks, make sure you have read Contributing Guidelines"
+	@echo "https://github.com/tldr-pages/tldr/blob/master/CONTRIBUTING.md#submitting-a-pull-request"
+	@echo
+	@echo "TL;DR:"
+	@echo "1. Install Ruby suitable for your system"
+	@echo "2. Run 'gem install bundler'"
+	@echo
 
 hooks:
 	@cp ./scripts/pre-commit .git/hooks
@@ -24,4 +33,4 @@ deps:
 lint:
 	@bundle exec mdl --style ./scripts/markdown-style.rb pages
 
-.PHONY: default index setup hooks deps lint
+.PHONY: default index setup prerequisites hooks deps lint

README.md

@@ -41,18 +41,23 @@ for the most common UNIX / Linux / OSX / SunOS commands.
 You can access these pages on your computer using one of the following clients:
 
 - [Node.js client](https://github.com/tldr-pages/tldr-node-client) : `npm install -g tldr`
-- [Python client](https://github.com/tldr-pages/tldr-python-client) : `pip install tldr`
-- [Python client](https://github.com/lord63/tldr.py): `pip install tldr.py`
+- Python clients:
+  - [tldr-python-client](https://github.com/tldr-pages/tldr-python-client) : `pip install tldr`
+  - [tldr.py](https://github.com/lord63/tldr.py): `pip install tldr.py`
 - [Go client](https://github.com/pranavraja/tldr): `go get github.com/pranavraja/tldr`
-  or [platform binaries](https://github.com/pranavraja/tldr/releases)
-- [Elixir client](https://github.com/tldr-pages/tldr_elixir_client): binaries available soon
+  (or [platform binaries](https://github.com/pranavraja/tldr/releases))
+- [Elixir client](https://github.com/tldr-pages/tldr_elixir_client) (binaries not yet available)
 - [C++ client](https://github.com/tldr-pages/tldr-cpp-client): `brew tap tldr-pages/tldr && brew install tldr`
-- [Android client](https://github.com/gianasista/tldr-viewer): available on
-  [Google Play](https://play.google.com/store/apps/details?id=de.gianasista.tldr_viewer)
+- Android clients:
+  - [tldr-viewer](https://github.com/gianasista/tldr-viewer), available on
+    [Google Play](https://play.google.com/store/apps/details?id=de.gianasista.tldr_viewer)
+  - [tldroid](https://github.com/hidroh/tldroid), available on
+    [Google Play](https://play.google.com/store/apps/details?id=io.github.hidroh.tldroid)
 - [Ruby client](https://github.com/YellowApple/tldrb): `gem install tldrb`
+- [Rust client](https://github.com/rilut/rust-tldr): `cargo install tldr`
 - [R client](https://github.com/kirillseva/tldrrr): `devtools::install_github('kirillseva/tldrrr')`
-- [Web client](https://github.com/ostera/tldr.js): try tldr on your browser
-  [here](https://ostera.github.io/tldr.js)!
+- [Dart client](https://github.com/hterkelsen/tldr): `pub global activate tldr`
+- [Web client](https://github.com/ostera/tldr.jsx): https://ostera.github.io/tldr.jsx
 
 Let us know if you are building one and we can add it to this list!
 

pages/common/ar.md

@@ -2,10 +2,22 @@
 
 > Create, modify, and extract from archives (.a .so .o)
 
-- Extract members of the archive
+- Extract all members from an archive
 
-`ar -x libfoo.a`
+`ar -x {{libfoo.a}}`
 
-- List the content (files) of libfoo.a
+- List the members of an archive
 
-`ar -t libfoo.a`
+`ar -t {{libfoo.a}}`
+
+- Replace or add files to an archive
+
+`ar -r {{libfoo.a}} {{foo.o}} {{bar.o}} {{baz.o}}`
+
+- Insert an object file index (equivalent to using `ranlib`)
+
+`ar -s {{libfoo.a}}`
+
+- Create an archive with files and an accompanying object file index
+
+`ar -rs {{libfoo.a}} {{foo.o}} {{bar.o}} {{baz.o}}`

pages/common/bashmarks.md

@@ -0,0 +1,23 @@
+# bashmarks
+
+> Save and jump to commonly used directories using 1 character commands.
+
+- List available bookmarks
+
+`l`
+
+- Save the current folder as "bookmark_name"
+
+`s {{bookmark_name}}`
+
+- Go to a bookmarked folder
+
+`g {{bookmark_name}}`
+
+- Print a bookmarked folder's contents
+
+`p {{bookmark_name}}`
+
+- Delete a bookmark
+
+`d {{bookmark_name}}`

pages/common/cat.md

@@ -2,10 +2,14 @@
 
 > Print and concatenate files.
 
-- Print the contents of *file1* to the standard output
+- Print the contents of a file to the standard output
 
-`cat {{file1}}`
+`cat {{file}}`
 
 - Concatenate several files into the target file.
 
 `cat {{file1}} {{file2}} > {{target-file}}`
+
+- Append serveral files into the target file.
+
+`cat {{file1}} {{file2}} >> {{target-file}}`

pages/common/comm.md

@@ -0,0 +1,23 @@
+# comm
+
+> Select or reject lines common to two files. Both files must be sorted.
+
+- Produce three tab-separated columns: lines only in first file, lines only in second file and common lines.
+
+`comm {{file1}} {{file2}}`
+
+- Print only lines common to both files.
+
+`comm -12 {{file1}} {{file2}}`
+
+- Print only lines common to both files, read one file from stdin.
+
+`cat {{file1}} | comm -12 - {{file2}}`
+
+- Print lines only found in first file.
+
+`comm -23 {{file1}} {{file2}}`
+
+- Print lines only found in second file.
+
+`comm -13 {{file1}} {{file2}}`

pages/common/convert.md

@@ -10,6 +10,10 @@
 
 `convert {{image.png}} -resize 50% {{image2.png}}`
 
+- Scale an image keeping the original aspect ratio to a maximum dimension of 640x480.
+
+`convert {{image.png}} -resize 640x480 {{image2.png}}`
+
 - Horizontally append images
 
 `convert {{image1.png}} {{image2.png}} {{image3.png}} +append {{image123.png}}`

pages/common/cowsay.md

@@ -0,0 +1,15 @@
+# cowsay
+
+> Generate an ASCII character like a cow or sheep saying or thinking something
+
+- Print an ASCII cow saying "Hello world!"
+
+`cowsay "Hello world!"`
+
+- Print an ASCII dragon saying "Hello!"
+
+`echo "Hello!" | cowsay -f dragon`
+
+- Print a stoned thinking ASCII cow
+
+`cowthink -s "I'm just a cow, not a great thinker ..."`

pages/common/cp.md

@@ -8,14 +8,20 @@
 
 - Copy a file to a parent directory
 
-`cp {{/path/to/original}} ../{{/path/to/copy}}`
+`cp {{/path/to/original}} ../{{path/to/copy}}`
 
-- Copy directories recursive using the option -r. Optionally showing files as they are copied.
+- Copy directories recursive using the option -r
 
 `cp -r {{/path/to/original}} {{/path/to/copy}}`
+
+- Show files as they are copied
+
 `cp -vr {{/path/to/original}} {{/path/to/copy}}`
 
-- Make a copy of a file adding and extension or changing an extension
+- Make a copy of a file, adding an extension
 
-`cp {{file.html}}\{,.backup\}`
-`cp file.\{html,backup\}`
+`cp {{file.html}}{,.backup}`
+
+- Make a copy of a file, changing the extension
+
+`cp {{file.}}{html,backup}`

pages/common/emacs.md

@@ -0,0 +1,15 @@
+# emacs
+
+> The extensible, customizable, self-documenting, real-time display editor
+
+- Open emacs in console mode (without X window)
+
+`emacs -nw`
+
+- Open a file in emacs
+
+`emacs {{filename}}`
+
+- Exit emacs
+
+`C-x C-c`

pages/common/find.md

@@ -6,6 +6,10 @@
 
 `find {{root_path}} -name {{'*.py'}}`
 
+- find files matching path pattern
+
+`find {{root_path}} -path {{'**/lib/**/*.py'}}`
+
 - run a command for each file, use {} within the command to access the filename
 
 `find {{root_path}} -name {{'*.py'}} -exec {{wc -l {} }}\;`

pages/common/gem.md

@@ -8,7 +8,7 @@
 
 - Install specific version of a gem
 
-`gem install -v={{0.0.15}}`
+`gem install {{gemname}} -v {{1.0.0}}`
 
 - Update a gem
 

pages/common/git-branch.md

@@ -2,10 +2,14 @@
 
 > Main command for working with branches
 
-- List all existing branches
+- List local branches. The current branch is highlighted by `*`.
 
 `git branch`
 
+- List all local and remote branches
+
+`git branch -a`
+
 - Create new branch based on current branch
 
 `git branch {{BRANCH-NAME}}`

pages/common/git-diff.md

@@ -13,3 +13,7 @@
 - Output a condensed summary of extended header information.
 
 `git diff --summary {{PATHSPEC}}`
+
+- Show staged (added, but not yet committed) changes only.
+
+`git diff --staged`

pages/common/gradle.md

@@ -0,0 +1,15 @@
+# Gradle
+
+> Gradle is the official build system for Android Studio
+
+- Compile a package
+
+`gradle build`
+
+- Clear the build folder
+
+`gradle clean`
+
+- Compile and Release package
+
+`gradle assembleRelease`

pages/common/gzip.md

@@ -6,7 +6,7 @@
 
 `gzip {{file.ext}}`
 
-- decompress a file, replacing it with the original uncomrpessed version
+- decompress a file, replacing it with the original uncompressed version
 
 `gzip -d {{file.ext.gz}}`
 

pages/common/host.md

@@ -0,0 +1,15 @@
+# host
+
+> Lookup Domain Name Server
+
+- Lookup A, AAAA, and MX records of a domain
+
+`host {{domain}}`
+
+- Lookup a field (CNAME, TXT,...) of a domain
+
+`host -t {{field}} {{domain}}`
+
+- Reverse lookup an IP
+
+`host {{ip_address}}`

pages/common/ifconfig.md

@@ -0,0 +1,23 @@
+# ifconfig
+
+> ifconfig - Interface Configurator, used to configure network interfaces.
+
+- View network settings of an ethernet adapter.
+
+`ifconfig eth0`
+
+- Display details of all interfaces, including disabled interfaces.
+
+`ifconfig -a`
+
+- Disable eth0 interface.
+
+`ifconfig eth0 down`
+
+- Enable eth0 interface.
+
+`ifconfig eth0 up`
+
+- Assign IP address to eth0 interface.
+
+`ifconfig eth0 {{ip_address}}`

pages/common/last.md

@@ -0,0 +1,27 @@
+# last
+
+> View the last logged in users
+
+- view last logins, their duration  and other information as read from /var/log/wtmp
+
+`last`
+
+- specify how many of the last logins to show
+
+`last -n {{login_count}}`
+
+- view full login times and dates
+
+`last -F`
+
+- view the last login by a specific user
+
+`last {{user_name}}`
+
+- view the last reboot (last login of the pseudo user reboot)
+
+`last reboot`
+
+- view the last shutdown (last login of the pseudo user shutdown)
+
+`last shutdown`

pages/common/mysql.md

@@ -6,9 +6,9 @@
 
 `mysql {{database_name}}`
 
-- Connect to a database using credentials
+- Connect to a database, user will be prompted for a password
 
-`mysql -u {{user}} -p{{password}} {{database_name}}`
+`mysql -u {{user}} --password {{database_name}}`
 
 - Execute SQL statements in a script file (batch file)
 

pages/common/mysqldump.md

@@ -2,10 +2,10 @@
 
 > Backups mysql databases
 
-- creating a backup
+- Create a backup, user will be prompted for a password
 
-`mysqldump -u {{user}} -p{{password}} {{database_name}} > {{filename.sql}}`
+`mysqldump -u {{user}} --password {{database_name}} > {{filename.sql}}`
 
-- restoring a backup
+- Restoring a backup, user will be prompted for a password
 
-`mysql -u {{user}} -p{{password}} {{database_name}} < {{filename.sql}}`
+`mysql -u {{user}} --password {{database_name}} < {{filename.sql}}`

pages/common/nice.md

@@ -0,0 +1,8 @@
+# nice
+
+> Execute a program with a custom scheduling priority (niceness).
+> Niceness values range from -20 (the highest priority) to 19 (the lowest).
+
+- Launch a program with altered priority.
+
+`nice -n {{niceness_value}} {{command}}`

pages/common/nmap.md

@@ -1,11 +1,28 @@
 # nmap
 
-> Network exploration tool and security / port scanner
+> Network exploration tool and security / port scanner.
+> Some features only activate when Nmap is run with privileges.
 
-- scan open ports of a single host
+- Try to determine whether the specified hosts are up and what are their names.
 
-`nmap {{192.168.0.1}}`
+`nmap -sn {{ip_or_hostname}} {{optional_another_address}}`
 
-- discover hosts in the 192.168.0.X area (no port scan)
+- Like above, but also run a default 1000-port TCP scan if host seems up.
 
-`nmap -sn {{192.168.0.1/24}}`
+`nmap {{ip_or_hostname}} {{optional_another_address}}`
+
+- Also enable service detection, OS fingerprinting and traceroute.
+
+`nmap -A {{address_or_addresses}}`
+
+- Assume good network connection and speed up execution:
+
+`nmap -T4 {{address_or_addresses}}`
+
+- Scan a specific list of ports (use -p- for all ports 1-65535)
+
+`nmap -p {{port1,port2,...,portN}} {{address_or_addresses}}`
+
+- Perform TCP and UDP scanning (use -sU for UDP only, -sZ for SCTP, -sO for IP):
+
+`nmap -sSU {{address_or_addresses}}`

pages/common/npm.md

@@ -10,6 +10,10 @@
 
 `npm install`
 
+- Download and install a module globally
+
+`npm install -g {{module_name}}`
+
 - Download a given dependency, and add it to the package.json
 
 `npm install {{module_name}}@{{version}} --save`
@@ -21,3 +25,7 @@
 - Publish the current project
 
 `npm publish`
+
+- Cleanup packages (removes packages which are installed but are not listed in `package.json`)
+
+`npm prune`

pages/common/parallel.md

@@ -0,0 +1,27 @@
+# GNU Parallel
+
+> Run commands on multiple CPU cores
+
+- gzip several files at once, using all cores
+
+`parallel gzip ::: {{file1}} {{file2}} {{file3}}`
+
+- read arguments from stdin, run 4 jobs at once
+
+`ls *.txt | parallel -j4 gzip`
+
+- Convert JPG images to PNG using replacement strings
+
+`parallel convert {} {.}.png ::: *.jpg`
+
+- parallel xargs, cram as many args as possible onto one command
+
+`{{args}} | parallel -X {{command}}`
+
+- break stdin into ~1M blocks, feed each block to stdin of new command
+
+`cat {{bigfile.txt}} | parallel --pipe --block 1M {{command}}`
+
+- run on multiple machines via SSH
+
+`parallel -S {{machine1}},{{machine2}} {{command}} ::: {{arg1}} {{arg2}}`

pages/common/passwd.md

@@ -2,18 +2,18 @@
 
 > passwd is a tool used to change a user's password.
 
-* Change the password of the current user
+- Change the password of the current user
 
 `passwd {{new password}}`
 
-* Change the password of the specified user
+- Change the password of the specified user
 
 `passwd {{username}} {{new password}}`
 
-* Get the current statuts of the user
+- Get the current statuts of the user
 
 `passwd -S`
 
-* Make the password of the account blank (it will set the named account passwordless)
+- Make the password of the account blank (it will set the named account passwordless)
 
 `passwd -d`

pages/common/paste.md

@@ -0,0 +1,23 @@
+# paste
+
+> Merge lines of files.
+
+- join all the lines into a single line, using TAB as delimiter.
+
+`paste -s {{file}}`
+
+- join all the lines into a single line, using the specified delimiter.
+
+`paste -s -d {{delimiter}} {{file}}`
+
+- merge two files side by side, each in its column, using TAB as delimiter.
+
+`paste {{file1}} {{file2}}`
+
+- merge two files side by side, each in its column, using the specified delimiter.
+
+`paste -d {{delimiter}} {{file1}} {{file2}}`
+
+- merge two files, with lines added alternatively.
+
+`paste -d '\n' {{file1}} {{file2}}`

pages/common/pgrep.md

@@ -4,16 +4,12 @@
 
 - return PIDs of any running processes with a matching command string
 
-`pgrep {{Finder}}`
+`pgrep {{process_name}}`
 
 - search full command line with parameters instead of just the process name
 
-`pgrep -f "{{ssh root}}"`
+`pgrep -f "{{process_name}} {{parameter}}"`
 
 - search for process run by a specific user
 
-`pgrep -u root {{firefox}}`
-
-- kill all processes which match
-
-`pkill -9 {{Finder}}`
+`pgrep -u root {{process_name}}`

pages/common/phpunit.md

@@ -0,0 +1,19 @@
+# phpunit
+
+> PHPUnit command-line test runner
+
+- Run tests in the current direcotry. Note: Expects you to have a 'phpunit.xml'
+
+`phpunit`
+
+- Run tests in a specific file.
+
+`phpunit {{path/to/TestFile.php}}`
+
+- Run tests annotated with the given group.
+
+`phpunit --group {{name}}`
+
+- Run tests and generate a coverage report in HTML.
+
+`phpunit --coverage-html {{directory}}`

pages/common/pkill.md

@@ -0,0 +1,12 @@
+# pkill
+
+> Signal process by name
+> Mostly used for stopping processes
+
+- kill all processes which match
+
+`pkill -9 {{process_name}}`
+
+- send SIGUSR1 signal to processes which match
+
+`pkill -USR1 {{process_name}}`

pages/common/printf.md

@@ -0,0 +1,23 @@
+# printf
+
+> Format and print text
+
+- Print a text message
+
+`printf {{"%s\n"}} {{"Hello world"}}`
+
+- Print an integer in bold blue
+
+`printf {{"\e[1;34m%.3d\e[0m\n"}} {{42}}`
+
+- Print a float number with the unicode Euro sign
+
+`printf {{"\u20AC %.2f\n"}} {{123.4}}`
+
+- Print a text message composed with environment variables
+
+`printf {{"var1: %s\tvar2: %s\n"}} {{"$VAR1"}} {{"$VAR2"}}`
+
+- Store a formatted message in a variable (does not work on zsh)
+
+`printf -v {{myvar}} {{"This is %s = %d\n" "a year" 2016}}`

pages/common/psql.md

@@ -6,10 +6,14 @@
 
 `psql {{database}}`
 
-- Connect to *database* on given server *host* running on given *port* with *username* given
+- Connect to *database* on given server *host* running on given *port* with *username* given, no password prompt
 
 `psql -h {{host}} -p {{port}} -U {{username}} {{database}}`
 
+- Connect to *database*, user will be prompted for password
+
+`psql -h {{host}} -p {{port}} -U {{username}} -W {{database}}`
+
 - Run single *query* against the given *database*. Note: useful in shell scripts
 
 `psql -c '{{query}}' {{database}}`

pages/common/rsync.md

@@ -20,6 +20,10 @@
 
 `rsync -r mike@devbox:~/projects/cakeStore /Users/mike/devProjects/`
 
+- transfer only updated files from remote host
+
+`rsync -ru mike@devbox:~/projects/ ./projects/`
+
 - transfer file over SSH and show progress
 
 `rsync -e ssh --progress {{remote_host_name}}:{{remote_file}} {{local_file}}`

pages/common/salt.md

@@ -8,12 +8,12 @@
 
 - Execute a highstate on all connected minions:
 
-`salt '*' state.highstate
+`salt '*' state.highstate`
 
 - Upgrade packages using the OS package manager (apt, yum, brew) on a subset of minions
 
-`salt '*.domain.com' pkg.upgrade
+`salt '*.domain.com' pkg.upgrade`
 
 - Execute an arbitrary command on a particular minion:
 
-`salt '{{minion_id}}' cmd.run "ls "
+`salt '{{minion_id}}' cmd.run "ls "`

pages/common/screen.md

@@ -21,3 +21,7 @@
 - Detach from inside a screen
 
 `ctrl+A D`
+
+- Kill a detached screen
+
+`screen -X -S {{screen id}} quit`

pages/common/sed.md

@@ -6,8 +6,7 @@
 
 `sed 's/{{find}}/{{replace}}/g' {{filename}}`
 
-- replace all occurrences of a string in a file, and overwrite the file
-  contents
+- replace all occurrences of a string in a file, and overwrite the file contents
 
 `sed -i 's/{{find}}/{{replace}}/g' {{filename}}`
 

pages/common/sl.md

@@ -0,0 +1,15 @@
+# sl
+
+> Steam locomotive running through your terminal.
+
+- Let a steam locomotive run through your terminal.
+
+`sl`
+
+- The train burns, people scream.
+
+`sl -a`
+
+- Let the train fly.
+
+`sl -F`

pages/common/strings.md

@@ -0,0 +1,19 @@
+# strings
+
+> Find printable strings in an object file or binary
+
+- Print all strings in a binary
+
+`strings {{file}}`
+
+- Limit results to strings at least *length* characters long
+
+`strings -n {{length}} {{file}}`
+
+- Prefix each result with its offset within the file
+
+`strings -t d {{file}}`
+
+- Prefix each result with its offset within the file in hexadecimal
+
+`strings -t x {{file}}`

pages/common/tac.md

@@ -0,0 +1,11 @@
+# tac
+
+> Print and concatenate files in reverse.
+
+- Print the contents of *file1* reversed to the standard output
+
+`tac {{file1}}`
+
+- Concatenate several files reversed into the target file.
+
+`tac {{file1}} {{file2}} > {{target-file}}`

pages/common/tar.md

@@ -29,4 +29,4 @@
 
 - list the contents of a tar file
 
-`tar -tvf {{source.tar}}`
+`tar tvf {{source.tar}}`

pages/common/touch.md

@@ -2,14 +2,14 @@
 
 > Change a file access and modification times (atime, mtime)
 
-- Create a new empty file(s) or change the times for existing file(s) to current time.`
+- Create a new empty file(s) or change the times for existing file(s) to current time
 
 `touch {{filename}}`
 
 - Set the times on a file to those specified
 
-`touch -t 201412250801.59 {{filename}}
-`touch -t {{YYYYMMDDHHMM.SS}} {{filename}}
+`touch -t 201412250801.59 {{filename}}`
+`touch -t {{YYYYMMDDHHMM.SS}} {{filename}}`
 
 - Set the times on a file to match those on second file
 

pages/common/tree.md

@@ -17,3 +17,11 @@
 - Print human readable size of files
 
 `tree -h`
+
+- Print the full path for each file
+
+`tree -f`
+
+- Print the tree without lines and indentation. Useful when used with -f
+
+`tree -i`

pages/common/uname.md

@@ -14,3 +14,7 @@
 - Print the nodename (hostname) of the system
 
 `uname -n`
+
+- Print all available system information (hardware, software, nodename)
+
+`uname -a`

pages/common/vagrant.md

@@ -0,0 +1,23 @@
+# vagrant
+
+> Manage lightweight, reproducible, and portable development environments
+
+- Create Vagrantfile in current folder with the base Vagrant box
+
+`vagrant init`
+
+- Create Vagrantfile with the Ubuntu 14.04 (Trusty Tahr) box from HashiCorp Atlas
+
+`vagrant init ubuntu/trusty32`
+
+- Start and provision the vagrant environment
+
+`vagrant up`
+
+- Suspend the machine
+
+`vagrant suspend`
+
+- Connect to machine via SSH
+
+`vagrant ssh`

pages/common/virtualenv.md

@@ -0,0 +1,16 @@
+# virtualenv
+
+> Create virtual isolated Python environments
+
+- Create a new environment
+
+`virtualenv {{path/to/venv}}`
+
+- Start (select) the environment
+
+`source {{path/to/venv}}/bin/activate`
+
+- Stop the environment
+
+`deactivate`
+

pages/common/whoami.md

@@ -0,0 +1,7 @@
+# whoami
+
+> Show the username of the current user
+
+- Display currently logged user name
+
+`whoami`

pages/linux/apt-cache.md

@@ -0,0 +1,15 @@
+# apt-cache
+
+> Debian and Ubuntu package query tool
+
+- Search for a package in your current sources
+
+`apt-cache search {{query}}`
+
+- Show information about a package
+
+`apt-cache show {{package}}`
+
+- Show whether a package is installed and up to date
+
+`apt-cache policy {{package}}`

pages/linux/dd.md

@@ -0,0 +1,19 @@
+# dd
+
+> convert and copy a file
+
+- Make a bootable usb drive from an isohybrid file (such like archlinux-xxx.iso)
+
+`dd if={{file.iso}} of=/dev/{{usb_drive}}`
+
+- Clone a drive to another drive with 4MB block and ignore error
+
+`dd if=/dev/{{source_drive}} of=/dev/{{dest_drive}} bs=4M conv=noerror`
+
+- Generating a file of 100 random bytes by using kernel random driver
+
+`dd if=/dev/urandom of={{random_file}} bs=100 count=1`
+
+- Benchmark the write performance of a disk
+
+`dd if=/dev/zero of={{file_1GB}} bs=1024 count=1000000`

pages/linux/dnf.md

@@ -0,0 +1,24 @@
+# dnf
+
+>Package management utility for RHEL, Feodra, and CentOS (replaces yum)
+
+- Synchronize list of packages and versions available. This should be run first, before running subsequent dnf commands.
+
+`dnf update`
+
+- Install a new package
+
+`dnf install {{package}}`
+
+- Install a new package and assume yes to all questions
+
+`dnf -y install {{package}}`
+
+- Remove a package
+
+`dnf remove {{package}}`
+
+- Upgrade installed packages to newest available versions
+
+`dnf upgrade`
+

pages/linux/hostname.md

@@ -1,6 +1,6 @@
 # hostname
 
-Show or set the system's host name
+> Show or set the system's host name
 
 - Show current host name
 

pages/linux/pacman.md

@@ -21,3 +21,7 @@
 - list installed packages and versions
 
 `pacman -Q`
+
+- list only the explicitly installed packages and versions
+
+`pacman -Qe`

pages/linux/shutdown.md

@@ -14,6 +14,10 @@
 
 `shutdown -r +{{5}} &`
 
+- Shutdown at 1:00 pm (Uses 24h clock)
+
+`shutdown -h 13:00`
+
 - Cancel a pending shutdown/reboot operation
 
 `shutdown -c`

pages/linux/ssh-copy-id.md

@@ -0,0 +1,11 @@
+# ssh-copy-id
+
+> Install your public key in a remote machine's authorized_keys.
+
+- Copy the given public key to the remote
+
+`ssh-copy-id -i {{path/to/certificate}} {{username}}@{{remote_host}}`
+
+- Copy the given public key to the remote with specific port
+
+`ssh-copy-id -i {{path/to/certificate}} -p {{port}} {{username}}@{{remote_host}}`

pages/linux/timedatectl.md

@@ -0,0 +1,19 @@
+# timedatectl
+
+> Control the system time and date
+
+- To check the current system clock time
+
+`timedatectl`
+
+- To set the local time of the system clock directly
+
+`timedatectl set-time {{"yyyy-MM-dd hh:mm:ss"}}`
+
+- To list available timezones
+
+`timedatectl list-timezones`
+
+- To change timezones
+
+`timedatectl set-timezone {{timezone}}`

pages/linux/ulimit.md

@@ -0,0 +1,19 @@
+# ulimit
+
+> Get and set user limits
+
+- get the properties of all the user limits
+
+`ulimit -a`
+
+- get hard limit for the number of simultaneously opened files
+
+`ulimit -H -n`
+
+- get soft limit for the number of simultaneously opened files
+
+`ulimit -S -n`
+
+- set max per-user process limit
+
+`ulimit -u 30`

pages/linux/xrandr.md

@@ -0,0 +1,23 @@
+# xrandr
+
+> Set the size, orientation and/or reflection of the outputs for a screen
+
+- Display the current state of the system (known screens, resolutions, ...)
+
+`xrandr --query`
+
+- Disable disconnected outputs and enable connected ones with default settings
+
+`xrandr --auto`
+
+- Change the resolution and update frequency of DisplayPort 1 to 1920x1080, 60Hz
+
+`xrandr --output {{DP1}} --mode {{1920x1080}} --rate {{60}}`
+
+- Set the resolution of HDMI2 to 1280x1024 and put it on the right of DP1
+
+`xrandr --output {{HDMI2}} --mode {{1280x1024}} --right-of {{DP1}}`
+
+- Disable the VGA1 output
+
+`xrandr --output {{VGA1}} --off`

pages/linux/yum.md

@@ -0,0 +1,24 @@
+# yum
+
+>Package management utility for RHEL, Feodra, and CentOS (for older versions)
+
+- Synchronize list of packages and versions available. This should be run first, before running subsequent yum commands.
+
+`yum update`
+
+- Install a new package
+
+`yum install {{package}}`
+
+- Install a new package and assume yes to all questions (also works with update, great for automated updates)
+
+`yum -y install {{package}}`
+
+- Remove a package
+
+`yum remove {{package}}`
+
+- Upgrade installed packages to newest available versions
+
+`yum upgrade`
+

pages/osx/dd.md

@@ -0,0 +1,19 @@
+# dd
+
+> convert and copy a file
+
+- Make a bootable usb drive from an isohybrid file (such like archlinux-xxx.iso)
+
+`dd if={{file.iso}} of=/dev/{{usb_drive}}`
+
+- Clone a drive to another drive with 4MB block and ignore error
+
+`dd if=/dev/{{source_drive}} of=/dev/{{dest_drive}} bs=4m conv=noerror`
+
+- Generating a file of 100 random bytes by using kernel random driver
+
+`dd if=/dev/urandom of={{random_file}} bs=100 count=1`
+
+- Benchmark the write performance of a disk
+
+`dd if=/dev/zero of={{file_1GB}} bs=1024 count=1000000`

pages/osx/diskutil.md

@@ -6,10 +6,6 @@
 
 `diskutil list`
 
-- Repair permissions on a volume
-
-`diskutil repairPermissions {{/Volumes/Name}}`
-
 - Repair the file system data structures of a volume
 
 `diskutil repairVolume {{/dev/diskX}}`

pages/osx/ditto.md

@@ -0,0 +1,15 @@
+# ditto
+
+> Copy files and folders
+
+- Overwrites contents of destination folder with contents of source folder
+
+`ditto {{path/to/source}} {{path/to/destination}}`
+
+- print a line to the Terminal window for every file that’s being copied
+
+`ditto -V {{path/to/source}} {{path/to/destination}}`
+
+- copy a given file or folder, while retaining the original file permissions.
+
+`ditto -rsrc {{path/to/source}} {{path/to/destination}}`

pages/osx/hostname.md

@@ -1,6 +1,6 @@
 # hostname
 
-Show or set the system's host name
+> Show or set the system's host name
 
 - Show current host name
 

pages/osx/mdfind.md

@@ -2,11 +2,11 @@
 
 > List files matching a given query
 
-- Find a file by it's name
+- Find a file by its name
 
 `mdfind -name {{file}}`
 
-- Find a file by it's content
+- Find a file by its content
 
 `mdfind {{query}}`
 

pages/osx/netstat.md

@@ -18,6 +18,6 @@
 
 `netstat -p {PROTOCOL}`
 
-- List information continiously
+- List information continuously
 
 `netstat -c`

pages/osx/open.md

@@ -4,11 +4,11 @@
 
 - Open a file with the associated application
 
-`open filename.ext`
+`open {{file.ext}}`
 
 - Run a graphical MacOSX application
 
-`open /Applications/iTunes.app`
+`open /Applications/{{Application.app}}`
 
 - Open the current directory in Finder
 
@@ -16,8 +16,8 @@
 
 - Reveal a file in finder
 
-`open -R /path/dir/file`
+`open -R /path/dir/{{file}}`
 
-- Open all the word docs in the current directory with Microsoft Word
+- Open all the files of a given extension in the current directory with the associated application
 
-`open *.doc`
+`open {{*.ext}}`