From 674658c984fd9f538afad1fefac489fd025c47a1 Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:39:25 +0800 Subject: [PATCH 01/60] go-version: add page (#4003) Signed-off-by: gonejack --- pages/common/go-version.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/common/go-version.md diff --git a/pages/common/go-version.md b/pages/common/go-version.md new file mode 100644 index 000000000..fa2312731 --- /dev/null +++ b/pages/common/go-version.md @@ -0,0 +1,12 @@ +# go version + +> Print Go version. +> More information: . + +- Print version: + +`go version` + +- Report the Go version used to build the named executable file: + +`go version {{executable}}` From f01abe8473776d474a243c71c8cb2ca5253d6cea Mon Sep 17 00:00:00 2001 From: Pierre Rudloff Date: Fri, 8 May 2020 00:38:43 +0200 Subject: [PATCH 02/60] apport-bug: add page (#4027) --- pages/linux/apport-bug.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 pages/linux/apport-bug.md diff --git a/pages/linux/apport-bug.md b/pages/linux/apport-bug.md new file mode 100644 index 000000000..4522c4fee --- /dev/null +++ b/pages/linux/apport-bug.md @@ -0,0 +1,20 @@ +# apport-bug + +> File a bug report on Ubuntu. +> More information: . + +- Report a bug about the whole system: + +`apport-bug` + +- Report a bug about a specific package: + +`apport-bug {{package}}` + +- Report a bug about a specific executable: + +`apport-bug {{path/to/executable}}` + +- Report a bug about a specific process: + +`apport-bug {{PID}}` From ec7de6364afdc69b708975c077298c775cf72a23 Mon Sep 17 00:00:00 2001 From: Owen Voke Date: Fri, 8 May 2020 13:02:16 +0100 Subject: [PATCH 03/60] tea: add page (#4023) --- pages/common/tea.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 pages/common/tea.md diff --git a/pages/common/tea.md b/pages/common/tea.md new file mode 100644 index 000000000..010fb01c1 --- /dev/null +++ b/pages/common/tea.md @@ -0,0 +1,32 @@ +# tea + +> A command line tool to interact with Gitea servers. +> More information: . + +- Log into a Gitea server: + +`tea login add --name "{{name}}" --url "{{url}}" --token "{{token}}"` + +- Display all repositories: + +`tea repos ls` + +- Display a list of issues: + +`tea issues ls` + +- Display a list of issues for a specific repository: + +`tea issues ls --repo "{{repository}}"` + +- Create a new issue: + +`tea issues create --title "{{title}}" --body "{{body}}"` + +- Display a list of open pull requests: + +`tea pulls ls` + +- Open the current repository in a browser: + +`tea open` From 4df20aea5554af3e33103654214feffcb96a61dd Mon Sep 17 00:00:00 2001 From: Pierre Rudloff Date: Fri, 8 May 2020 18:40:07 +0200 Subject: [PATCH 04/60] reportbug: add page (#4028) Co-authored-by: Andrik Albuquerque --- pages/linux/reportbug.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 pages/linux/reportbug.md diff --git a/pages/linux/reportbug.md b/pages/linux/reportbug.md new file mode 100644 index 000000000..a7777eefb --- /dev/null +++ b/pages/linux/reportbug.md @@ -0,0 +1,16 @@ +# reportbug + +> Bug report tool of Debian distribution. +> More information: . + +- Generate a bug report about a specific package, then send it by e-mail: + +`reportbug {{package}}` + +- Report a bug that is not about a specific package (general problem, infrastructure, etc.): + +`reportbug other` + +- Write the bug report to a file instead of sending it by e-mail: + +`reportbug -o {{filename}} {{package}}` From 7896c3514a645cf9995846c1974621b6fda0f078 Mon Sep 17 00:00:00 2001 From: Pierre Rudloff Date: Sat, 9 May 2020 04:24:20 +0200 Subject: [PATCH 05/60] spfquery: add page (#4030) --- pages/common/spfquery.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/common/spfquery.md diff --git a/pages/common/spfquery.md b/pages/common/spfquery.md new file mode 100644 index 000000000..7ab7d0419 --- /dev/null +++ b/pages/common/spfquery.md @@ -0,0 +1,12 @@ +# spfquery + +> Query Sender Policy Framework records to validate e-mail senders. +> More information: . + +- Check if an IP address is allowed to send an e-mail from the specified e-mail address: + +`spfquery -ip {{8.8.8.8}} -sender {{sender@example.com}}` + +- Turn on debugging output: + +`spfquery -ip {{8.8.8.8}} -sender {{sender@example.com}} --debug` From 8340b36fba3e7cbebf2fc4117c3d473b632c4241 Mon Sep 17 00:00:00 2001 From: Starbeamrainbowlabs Date: Sat, 9 May 2020 06:47:08 +0100 Subject: [PATCH 06/60] git-help: add page (#4019) --- common/pages/git-help.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 common/pages/git-help.md diff --git a/common/pages/git-help.md b/common/pages/git-help.md new file mode 100644 index 000000000..1067b64fc --- /dev/null +++ b/common/pages/git-help.md @@ -0,0 +1,24 @@ +# git help + +> Display help information about git. +> More information: . + +- Display help about a specific git subcommand: + +`git help {{subcommand}}` + +- Display help about a specific git subcommand in a web browser: + +`git help --web {{subcommand}}` + +- Display a list of all available git subcommands: + +`git help --all` + +- List the available guides: + +`git help --guide` + +- List all possible configuration variables: + +`git help --config` From b305693b00a1a12294e669120a00b1659e59a9a7 Mon Sep 17 00:00:00 2001 From: Starbeamrainbowlabs Date: Sat, 9 May 2020 07:31:47 +0100 Subject: [PATCH 07/60] git-repack: add page (#4018) --- pages/common/git-repack.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/common/git-repack.md diff --git a/pages/common/git-repack.md b/pages/common/git-repack.md new file mode 100644 index 000000000..e7b299fd5 --- /dev/null +++ b/pages/common/git-repack.md @@ -0,0 +1,12 @@ +# git repack + +> Pack unpacked objects in a git repository. +> More information: . + +- Pack unpacked objects in the current directory: + +`git repack` + +- Also remove redundant objects after packing: + +`git repack -d` From 8d544584f05868767bc36718870af146307f493c Mon Sep 17 00:00:00 2001 From: fejx Date: Sun, 10 May 2020 01:10:23 +0200 Subject: [PATCH 08/60] Add subcommand section to contributing guidelines (#4025) --- CONTRIBUTING.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 76e3e5c09..aa13f5f39 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -71,6 +71,20 @@ As a quick reference, the format of each page should match the following templat For more detailed page formatting guidelines, refer to the [style guide](contributing-guides/style-guide.md). +## Subcommands + +Many programs use subcommands for separating functionality, which may require their own separate pages. +For instance, `git commit` has its own page, as well as `git push` and many others. +To create a page for a subcommand, the program and subcommand need to be separated with a dash (`-`), so `git-commit.md` is shown when calling `tldr git commit`. + +You should always add a base page (e.g. `git`) that describes the program and basic switches like `--version` or `help`. +See these examples for reference: + +* [git](pages/common/git.md) +* [git-commit](pages/common/git-commit.md) +* [aws](pages/common/aws.md) +* [aws-s3](pages/common/aws-s3.md) + ## Translations Translation of pages can be done by simply creating the corresponding page within the appropriate language-specific directory, creating that as well if it does not already exist. From 0a0071340c0d816c5eb48275cedf521fd7e15f61 Mon Sep 17 00:00:00 2001 From: Pierre Rudloff Date: Sun, 10 May 2020 14:38:55 +0200 Subject: [PATCH 09/60] vlc: add page (#4029) Co-authored-by: Andrik Albuquerque Co-authored-by: fejx --- pages/common/vlc.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 pages/common/vlc.md diff --git a/pages/common/vlc.md b/pages/common/vlc.md new file mode 100644 index 000000000..417cbf40e --- /dev/null +++ b/pages/common/vlc.md @@ -0,0 +1,16 @@ +# vlc + +> Cross-platform multimedia player. +> More information: . + +- Play a file: + +`vlc {{path/to/file}}` + +- Play in fullscreen: + +`vlc --fullscreen {{path/to/file}}` + +- Play muted: + +`vlc --no-audio {{path/to/file}}` From 6683b2c486e8b0b072dc80f849630716d4fb27cf Mon Sep 17 00:00:00 2001 From: Starbeamrainbowlabs Date: Sun, 10 May 2020 13:41:53 +0100 Subject: [PATCH 10/60] git-instaweb: add page (#4017) --- pages/common/git-instaweb.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 pages/common/git-instaweb.md diff --git a/pages/common/git-instaweb.md b/pages/common/git-instaweb.md new file mode 100644 index 000000000..cd447a282 --- /dev/null +++ b/pages/common/git-instaweb.md @@ -0,0 +1,32 @@ +# git instaweb + +> Helper to launch a gitweb server. +> More information: . + +- Launch a gitweb server for the current git repository: + +`git instaweb --start` + +- Listen only on localhost: + +`git instaweb --start --local` + +- Listen on a specific port: + +`git instaweb --start --port {{1234}}` + +- Use a specified http daemon: + +`git instaweb --start --httpd {{lighttpd|apache2|mongoose|plackup|webrick}}` + +- Also auto-launch a web browser: + +`git instaweb --start --browser` + +- Stop the currently running gitweb server: + +`git instaweb --stop` + +- Restart the currently running gitweb server: + +`git instaweb --restart` From b7f68fac4d6b26f0e8d725aada1dddc1226fdf6e Mon Sep 17 00:00:00 2001 From: Starbeamrainbowlabs Date: Sun, 10 May 2020 13:45:11 +0100 Subject: [PATCH 11/60] john: apply suggestions (#3990) --- pages/common/john.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/common/john.md b/pages/common/john.md index 121d43a3c..433a43bf8 100644 --- a/pages/common/john.md +++ b/pages/common/john.md @@ -25,7 +25,7 @@ - Crack password hashes, using a specific hash format: -`john --format={{md5crypt|...}} {{path/to/hashes.txt}}` +`john --format={{md5crypt}} {{path/to/hashes.txt}}` - Crack password hashes, enabling word mangling rules: @@ -33,4 +33,4 @@ - Restore an interrupted cracking session from a state file, e.g. `mycrack.rec`: -`john --restore={{mycrack}}` +`john --restore={{path/to/mycrack.rec}}` From 65eb63ddc1d6ee891a25c2602b3f2254b970bf62 Mon Sep 17 00:00:00 2001 From: FloLangenfeld Date: Sun, 10 May 2020 14:45:44 +0200 Subject: [PATCH 12/60] rsync: add French translation (#4015) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Zlatan Vasović Co-authored-by: Antoine Amara --- pages.fr/common/rsync.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 pages.fr/common/rsync.md diff --git a/pages.fr/common/rsync.md b/pages.fr/common/rsync.md new file mode 100644 index 000000000..e4a179992 --- /dev/null +++ b/pages.fr/common/rsync.md @@ -0,0 +1,36 @@ +# rsync + +> Transférer des fichiers vers ou depuis un hôte distant (pas entre deux hôtes distants). +> Peut transférer un ou plusieurs fichiers correspondant à un motif. + +- Transférer un fichier local vers un serveur distant: + +`rsync {{chemin/vers/fichier_local}} {{hote_distant}}:{{chemin/vers/dossier_distant}}` + +- Transférer un fichier d'un serveur distant vers l'hôte local: + +`rsync {{hote_distant}}:{{chemin/vers/fichier_distant}} {{chemin/vers/dossier_local}}` + +- Transférer un fichier sous forme d'[a]rchive (pour conserver les attributs) et compressé ([z]ippé), en mode [v]erbeux, lisible par l'[h]umain et afficher la [p]rogression du transfert: + +`rsync -azvhP {{chemin/vers/fichier_local}} {{hote_distant}}:{{chemin/vers/dossier_distant}}` + +-Transférer un dossier et tous ses sous-dossiers d'un hôte distant vers l'hôte local: + +`rsync -r {{hote_distant}}:{{chemin/vers/dossier_distant}} {{chemin/vers/dossier_local}}` + +- Transférer le contenu d'un dossier (mais pas le dossier lui-même) d'un hôte distant vers un hôte local: + +`rsync -r {{hote_distant}}:{{chemin/vers/dossier_distant}}/ {{chemin/vers/dossier_local}}` + +- Transférer un dossier [r]écursivement, dans une [a]rchive pour conserver les attributs, en résolvant les [l]iens symboliques, et ignorant les fichiers déjà transférés sa[u]f si plus récents: + +`rsync -rauL {{hote_distant}}:{{chemin/vers/fichier_distant}} {{chemin/vers/dossier_local}}` + +- Transférer un fichier par SSH et effacer les fichiers de l'hôte local qui n'existent pas sur l'hôte distant: + +`rsync -e ssh --delete {{hote_distant}}:{{chemin/vers/fichier_distant}} {{chemin/vers/fichier_local}}` + +- Transférer un fichier par SSH et afficher l'avancement global du transfert: + +`rsync -e ssh --info=progress2 {{hote_distant}}:{{chemin/vers/fichier_distant}} {{chemin/vers/fichier_local}}` From 85820d1df1daaa44b12a7c35ccf8f16672127eb4 Mon Sep 17 00:00:00 2001 From: Starbeamrainbowlabs Date: Sun, 10 May 2020 14:51:01 +0100 Subject: [PATCH 13/60] git-show-branch: add page (#4016) --- pages/common/git-show-branch.md | 36 +++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 pages/common/git-show-branch.md diff --git a/pages/common/git-show-branch.md b/pages/common/git-show-branch.md new file mode 100644 index 000000000..706c81ca3 --- /dev/null +++ b/pages/common/git-show-branch.md @@ -0,0 +1,36 @@ +# git show-branch + +> Show branches and their commits. +> More information: . + +- Show a summary of the latest commit on a branch: + +`git show-branch {{branch_name|ref|commit}}` + +- Compare commits in the history of multiple commits or branches: + +`git show-branch {{branch_name|ref|commit}}` + +- Compare all remote tracking branches: + +`git show-branch --remotes` + +- Compare both local and remote tracking branches: + +`git show-branch --all` + +- List the latest commits in all branches: + +`git show-branch --all --list` + +- Compare a given branch with the current branch: + +`git show-branch --current {{commit|branch_name|ref}}` + +- Display the commit name instead of the relative name: + +`git show-branch --sha1-name --current {{current|branch_name|ref}}` + +- Keep going a given number of commits past the common ancester: + +`git show-branch --more {{5}} {{commit|branch_name|ref}} {{commit|branch_name|ref}} {{...}}` From 3741c79599723cbb689bfa4a6090cbeb66a52122 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Caio=20Amaral=20Corr=C3=AAa?= Date: Sun, 10 May 2020 15:18:33 -0300 Subject: [PATCH 14/60] icalbuddy: add page (#4033) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Zlatan Vasović --- pages/osx/icalbuddy.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 pages/osx/icalbuddy.md diff --git a/pages/osx/icalbuddy.md b/pages/osx/icalbuddy.md new file mode 100644 index 000000000..d8939b965 --- /dev/null +++ b/pages/osx/icalbuddy.md @@ -0,0 +1,24 @@ +# icalBuddy + +> Command-line utility for prinitng events and tasks from the macOS calendar database. +> More information: . + +- Show events later today: + +`icalBuddy -n -f eventsToday` + +- Show uncompleted tasks: + +`icalBuddy -f uncompletedTasks` + +- Show tasks for the next 3 days: + +`icalBuddy -n -f tasksDueBefore:today+3` + +- Show events in a time range: + +`icalBuddy -f eventsFrom:'{{start date}}' to:'{{end date}}'` + +- Show custom event list: + +`icalBuddy -f -npn -nc -iep "title,datetime" -ps "| : |" -po "datetime,title" -tf "" -df "%RD" -eed eventsToday+10` From 038ea380fc140b69bd60b3976a12218fa4dc9777 Mon Sep 17 00:00:00 2001 From: Cameron Tod Date: Mon, 11 May 2020 20:57:08 +1200 Subject: [PATCH 15/60] ack: add regex, single file search examples (#4007) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Zlatan Vasović Co-authored-by: Starbeamrainbowlabs --- pages/common/ack.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/pages/common/ack.md b/pages/common/ack.md index 4eccc795f..b605ac1c4 100644 --- a/pages/common/ack.md +++ b/pages/common/ack.md @@ -19,6 +19,14 @@ `ack -cl {{foo}}` +- Search a file for a specified string: + +`ack bar "{{foo bar}}" {{path/to/file}}` + +- Search a file for the specified regex pattern: + +`ack bar "{{[bB]ar \d+}}" {{path/to/file}}` + - List all valid types: `ack --help=types` From c4898ab0ca11f3cbf7d2db205cd166b9dd094f22 Mon Sep 17 00:00:00 2001 From: Pierre Rudloff Date: Mon, 11 May 2020 20:15:13 +0200 Subject: [PATCH 16/60] thunderbird: fix -P example (#4037) --- pages/common/thunderbird.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/pages/common/thunderbird.md b/pages/common/thunderbird.md index e5f96e7bb..d01c2b6d2 100644 --- a/pages/common/thunderbird.md +++ b/pages/common/thunderbird.md @@ -6,6 +6,10 @@ `thunderbird` +- Use a specific user profile: + +`thunderbird -P {{profile_name}}` + - Use a specific user profile directory: -`thunderbird -P {{path/to/profile/directory}}` +`thunderbird --profile {{path/to/profile/directory}}` From 9d46c436a42b245a18e6ddf5c78a4fbba3635d33 Mon Sep 17 00:00:00 2001 From: Spirit <31540351+sp1ritCS@users.noreply.github.com> Date: Tue, 12 May 2020 04:55:30 +0000 Subject: [PATCH 17/60] efibootmgr: add page (#3788) --- pages/linux/efibootbgr.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 pages/linux/efibootbgr.md diff --git a/pages/linux/efibootbgr.md b/pages/linux/efibootbgr.md new file mode 100644 index 000000000..8c03fd920 --- /dev/null +++ b/pages/linux/efibootbgr.md @@ -0,0 +1,24 @@ +# efibootmgr + +> Manipulate the UEFI Boot Manager (the Bootoptions). +> More information: https://linux.die.net/man/8/efibootmgr. + +- List the current settings / bootnums: + +`efibootmgr` + +- List the filepaths: + +`efibootmgr -v` + +- Add UEFI Shell v2 as a boot option: + +`sudo efibootmgr -c -d {{/dev/sda1}} -l {{\EFI\tools\Shell.efi}} -L "{{UEFI Shell}}"` + +- Change the current boot order: + +`sudo efibootmgr -o {{0002,0008,0001,0005}}` + +- Delete a boot option: + +`sudo efibootmgr -b {{0008}} --delete-bootnum` From d9498825c76253581b7a8504500ba01032f5364b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Iv=C3=A1n=20Hern=C3=A1ndez=20Cazorla?= Date: Tue, 12 May 2020 13:22:04 +0100 Subject: [PATCH 18/60] readme: add ExTldr client (#4039) --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 9364b0e10..66ee4b8cf 100644 --- a/README.md +++ b/README.md @@ -73,7 +73,9 @@ You can access these pages on your computer using one of the following clients: Open `Preferences` > `Downloads` > `User Contributed` and find `tldr pages` in the list - Docker images: - [tldr-docker](https://github.com/nutellinoit/tldr-docker)- Run the `tldr` command via a docker container: `alias tldr='docker run --rm -it -v ~/.tldr/:/root/.tldr/ nutellinoit/tldr'` -- [Elixir client](https://github.com/edgurgel/tldr_elixir_client) +- Elixir clients: + - [ExTldr](https://github.com/ivanhercaz/extldr). + - [TLDR Elixir Client](https://github.com/edgurgel/tldr_elixir_client) (binaries not yet available) - [Emacs client](https://github.com/kuanyui/tldr.el), available on [MELPA](https://github.com/melpa/melpa) From 1066bbf71919e5f1fee2cbb06dade941e8c74630 Mon Sep 17 00:00:00 2001 From: slashleo <37038834+slashleo@users.noreply.github.com> Date: Tue, 12 May 2020 18:40:11 +0200 Subject: [PATCH 19/60] wmctrl: add page (#4038) --- pages/linux/wmctrl.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 pages/linux/wmctrl.md diff --git a/pages/linux/wmctrl.md b/pages/linux/wmctrl.md new file mode 100644 index 000000000..d320a0894 --- /dev/null +++ b/pages/linux/wmctrl.md @@ -0,0 +1,27 @@ +# wmctrl + +> CLI for X Window Manager. + +- List all windows, managed by the window manager: + +`wmctrl -l` + +- Switch to the first window whose (partial) title matches: + +`wmctrl -a {{window_title}}` + +- Move a window to the current workspace, raise it and give it focus: + +`wmctrl -R {{window_title}}` + +- Switch to a workspace: + +`wmctrl -s {{workspace_number}}` + +- Select a window and toggle fullscreen: + +`wmctrl -r {{window_title}} -b toggle,fullscreen` + +- Select a window a move it to a workspace: + +`wmctrl -r {{window_title}} -t {{workspace_number}}` From 0265e42443d45caabe9d09be8f1445e00ef39542 Mon Sep 17 00:00:00 2001 From: michaeldel Date: Tue, 12 May 2020 23:47:54 +0200 Subject: [PATCH 20/60] plantuml: add page (#4040) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Zlatan Vasović --- pages/common/plantuml.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 pages/common/plantuml.md diff --git a/pages/common/plantuml.md b/pages/common/plantuml.md new file mode 100644 index 000000000..659121a27 --- /dev/null +++ b/pages/common/plantuml.md @@ -0,0 +1,28 @@ +# plantuml + +> Create UML diagrams from a plain text language and render them in different formats. +> More information: . + +- Render diagrams to default format (PNG): + +`plantuml {{diagram1.puml}} {{diagram2.puml}}` + +- Render a diagram in given format (e.g. `png`, `pdf`, `svg`, `txt`): + +`plantuml -t{{format}} {{diagram.puml}}` + +- Render all diagrams of a directory: + +`plantuml {{path/to/diagrams}}` + +- Render a diagram to the output directory: + +`plantuml -o {{path/to/output}} {{diagram.puml}}` + +- Render a diagram with the configuration file: + +`plantuml -config {{config.cfg}} {{diagram.puml}}` + +- Display help: + +`plantuml -help` From 27e7d24edbf9c19d6a2f196c0ef5bf8f10c9e0c8 Mon Sep 17 00:00:00 2001 From: fejx Date: Tue, 12 May 2020 23:53:32 +0200 Subject: [PATCH 21/60] git-help: fix location (#4034) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Zlatan Vasović --- {common/pages => pages/common}/git-help.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename {common/pages => pages/common}/git-help.md (99%) diff --git a/common/pages/git-help.md b/pages/common/git-help.md similarity index 99% rename from common/pages/git-help.md rename to pages/common/git-help.md index 1067b64fc..47b6a94d8 100644 --- a/common/pages/git-help.md +++ b/pages/common/git-help.md @@ -7,7 +7,7 @@ `git help {{subcommand}}` -- Display help about a specific git subcommand in a web browser: +- Display help about a specific git subcommand in a web browser: `git help --web {{subcommand}}` From bd29cfbb23566260e75160aeaaa1949d3e756ca3 Mon Sep 17 00:00:00 2001 From: fejx Date: Wed, 6 May 2020 21:40:46 +0200 Subject: [PATCH 22/60] unix2dos: add page --- pages/linux/unix2dos.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/linux/unix2dos.md diff --git a/pages/linux/unix2dos.md b/pages/linux/unix2dos.md new file mode 100644 index 000000000..bc7c4deae --- /dev/null +++ b/pages/linux/unix2dos.md @@ -0,0 +1,12 @@ +# unix2dos + +> Change unix-style line endings to dos-style. +> Replaces CR with CRLF. + +- Change line endings of a file: + +`unix2dos {{filename}}` + +- Create a copy with dos-style line endings: + +`unix2dos -n {{filename}} {{new_filename}}` From 2b0076050b5f1cbb729f4e4b5823a0d9e916af17 Mon Sep 17 00:00:00 2001 From: fejx Date: Wed, 6 May 2020 21:40:22 +0200 Subject: [PATCH 23/60] dos2unix: add page --- pages/linux/dos2unix.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/linux/dos2unix.md diff --git a/pages/linux/dos2unix.md b/pages/linux/dos2unix.md new file mode 100644 index 000000000..38100a067 --- /dev/null +++ b/pages/linux/dos2unix.md @@ -0,0 +1,12 @@ +# dos2unix + +> Change dos-style line endings to unix-style. +> Replaces CRLF with CR. + +- Change line endings of a file: + +`dos2unix {{filename}}` + +- Create a copy with unix-style line endings: + +`dos2unix -n {{filename}} {{new_filename}}` From 7157f0a825881d902dbf1b8d3f563f19444cf1d8 Mon Sep 17 00:00:00 2001 From: fejx Date: Fri, 8 May 2020 08:45:59 +0200 Subject: [PATCH 24/60] mac2unix: add page --- pages/linux/mac2unix.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/linux/mac2unix.md diff --git a/pages/linux/mac2unix.md b/pages/linux/mac2unix.md new file mode 100644 index 000000000..0d6647ca1 --- /dev/null +++ b/pages/linux/mac2unix.md @@ -0,0 +1,12 @@ +# mac2unix + +> Change mac-style line endings to unix-style. +> Replaces LF with CR. + +- Change line endings of a file: + +`mac2unix {{filename}}` + +- Create a copy with unix-style line endings: + +`mac2unix -n {{filename}} {{new_filename}}` From 2074d8ca6431ecde91982be7753a14e298249393 Mon Sep 17 00:00:00 2001 From: fejx Date: Fri, 8 May 2020 08:46:39 +0200 Subject: [PATCH 25/60] unix2mac: add page --- pages/linux/unix2mac.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/linux/unix2mac.md diff --git a/pages/linux/unix2mac.md b/pages/linux/unix2mac.md new file mode 100644 index 000000000..ca658020e --- /dev/null +++ b/pages/linux/unix2mac.md @@ -0,0 +1,12 @@ +# unix2mac + +> Change unix-style line endings to mac-style. +> Replaces CR with LF. + +- Change line endings of a file: + +`unix2mac {{filename}}` + +- Create a copy with mac-style line endings: + +`unix2mac -n {{filename}} {{new_filename}}` From d795b6a8648b7d712440047ccfd470daec074cc5 Mon Sep 17 00:00:00 2001 From: fejx Date: Sun, 10 May 2020 15:12:37 +0200 Subject: [PATCH 26/60] dos2unix, unix2dos, mac2unix, unix2mac: use consistent naming MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Apply suggestions from code review Co-authored-by: Zlatan Vasović --- pages/linux/dos2unix.md | 4 ++-- pages/linux/mac2unix.md | 4 ++-- pages/linux/unix2dos.md | 4 ++-- pages/linux/unix2mac.md | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/pages/linux/dos2unix.md b/pages/linux/dos2unix.md index 38100a067..dea8bf559 100644 --- a/pages/linux/dos2unix.md +++ b/pages/linux/dos2unix.md @@ -1,12 +1,12 @@ # dos2unix -> Change dos-style line endings to unix-style. +> Change DOS-style line endings to Unix-style. > Replaces CRLF with CR. - Change line endings of a file: `dos2unix {{filename}}` -- Create a copy with unix-style line endings: +- Create a copy with Unix-style line endings: `dos2unix -n {{filename}} {{new_filename}}` diff --git a/pages/linux/mac2unix.md b/pages/linux/mac2unix.md index 0d6647ca1..a508c298c 100644 --- a/pages/linux/mac2unix.md +++ b/pages/linux/mac2unix.md @@ -1,12 +1,12 @@ # mac2unix -> Change mac-style line endings to unix-style. +> Change macOS-style line endings to Unix-style. > Replaces LF with CR. - Change line endings of a file: `mac2unix {{filename}}` -- Create a copy with unix-style line endings: +- Create a copy with Unix-style line endings: `mac2unix -n {{filename}} {{new_filename}}` diff --git a/pages/linux/unix2dos.md b/pages/linux/unix2dos.md index bc7c4deae..726e6bd33 100644 --- a/pages/linux/unix2dos.md +++ b/pages/linux/unix2dos.md @@ -1,12 +1,12 @@ # unix2dos -> Change unix-style line endings to dos-style. +> Change Unix-style line endings to DOS-style. > Replaces CR with CRLF. - Change line endings of a file: `unix2dos {{filename}}` -- Create a copy with dos-style line endings: +- Create a copy with DOS-style line endings: `unix2dos -n {{filename}} {{new_filename}}` diff --git a/pages/linux/unix2mac.md b/pages/linux/unix2mac.md index ca658020e..fe591cd21 100644 --- a/pages/linux/unix2mac.md +++ b/pages/linux/unix2mac.md @@ -1,12 +1,12 @@ # unix2mac -> Change unix-style line endings to mac-style. +> Change Unix-style line endings to macOS-style. > Replaces CR with LF. - Change line endings of a file: `unix2mac {{filename}}` -- Create a copy with mac-style line endings: +- Create a copy with macOS-style line endings: `unix2mac -n {{filename}} {{new_filename}}` From 1f499c3c14fb57a6da29262f022e73671385f621 Mon Sep 17 00:00:00 2001 From: fejx Date: Sun, 10 May 2020 21:22:17 +0200 Subject: [PATCH 27/60] dos2unix, unix2dos, mac2unix, unix2mac: rephrase wording in first example Adding 'the' is more accurate because it's *all* of the line endings that get replaced, not just *some* of them. Apply suggestions from code review Co-authored-by: Starbeamrainbowlabs --- pages/linux/dos2unix.md | 2 +- pages/linux/mac2unix.md | 2 +- pages/linux/unix2dos.md | 2 +- pages/linux/unix2mac.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/pages/linux/dos2unix.md b/pages/linux/dos2unix.md index dea8bf559..a3722cc09 100644 --- a/pages/linux/dos2unix.md +++ b/pages/linux/dos2unix.md @@ -3,7 +3,7 @@ > Change DOS-style line endings to Unix-style. > Replaces CRLF with CR. -- Change line endings of a file: +- Change the line endings of a file: `dos2unix {{filename}}` diff --git a/pages/linux/mac2unix.md b/pages/linux/mac2unix.md index a508c298c..5fe8e3d77 100644 --- a/pages/linux/mac2unix.md +++ b/pages/linux/mac2unix.md @@ -3,7 +3,7 @@ > Change macOS-style line endings to Unix-style. > Replaces LF with CR. -- Change line endings of a file: +- Change the line endings of a file: `mac2unix {{filename}}` diff --git a/pages/linux/unix2dos.md b/pages/linux/unix2dos.md index 726e6bd33..57ebfd955 100644 --- a/pages/linux/unix2dos.md +++ b/pages/linux/unix2dos.md @@ -3,7 +3,7 @@ > Change Unix-style line endings to DOS-style. > Replaces CR with CRLF. -- Change line endings of a file: +- Change the line endings of a file: `unix2dos {{filename}}` diff --git a/pages/linux/unix2mac.md b/pages/linux/unix2mac.md index fe591cd21..84c396ec9 100644 --- a/pages/linux/unix2mac.md +++ b/pages/linux/unix2mac.md @@ -3,7 +3,7 @@ > Change Unix-style line endings to macOS-style. > Replaces CR with LF. -- Change line endings of a file: +- Change the line endings of a file: `unix2mac {{filename}}` From fb2f4d205a12c3de4529c7d5aa4e764e639e61f1 Mon Sep 17 00:00:00 2001 From: yurai007 Date: Wed, 13 May 2020 01:54:45 +0200 Subject: [PATCH 28/60] cp: add examples for common -L and Linux specific --parents (#4026) (#4026) --- pages/common/cp.md | 4 ++++ pages/linux/cp.md | 31 +++++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+) create mode 100644 pages/linux/cp.md diff --git a/pages/common/cp.md b/pages/common/cp.md index d03db8790..42bffbf2a 100644 --- a/pages/common/cp.md +++ b/pages/common/cp.md @@ -21,3 +21,7 @@ - Copy text files to another location, in interactive mode (prompts user before overwriting): `cp -i {{*.txt}} {{path/to/target_directory}}` + +- Dereference symbolic links before copying: + +`cp -L {{link}} {{path/to/copy}}` diff --git a/pages/linux/cp.md b/pages/linux/cp.md new file mode 100644 index 000000000..aa87de625 --- /dev/null +++ b/pages/linux/cp.md @@ -0,0 +1,31 @@ +# cp + +> Copy files and directories. + +- Copy a file to another location: + +`cp {{path/to/file.ext}} {{path/to/copy.ext}}` + +- Copy a file into another directory, keeping the filename: + +`cp {{path/to/file.ext}} {{path/to/target_parent_directory}}` + +- Recursively copy a directory's contents to another location (if the destination exists, the directory is copied inside it): + +`cp -r {{path/to/directory}} {{path/to/copy}}` + +- Copy a directory recursively, in verbose mode (shows files as they are copied): + +`cp -vr {{path/to/directory}} {{path/to/copy}}` + +- Copy text files to another location, in interactive mode (prompts user before overwriting): + +`cp -i {{*.txt}} {{path/to/target_directory}}` + +- Dereference symbolic links before copying: + +`cp -L {{link}} {{path/to/copy}}` + +- Use the full path of source files, creating any missing intermediate directories when copying: + +`cp --parents {{source/path/to/file}} {{path/to/copy}}` From 182c6a70368c938ed9ada7645c141947ad1b5723 Mon Sep 17 00:00:00 2001 From: Starbeamrainbowlabs Date: Wed, 13 May 2020 09:42:18 +0100 Subject: [PATCH 29/60] git notes: add page (#4042) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Iván Hernández Cazorla --- pages/common/git-notes.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 pages/common/git-notes.md diff --git a/pages/common/git-notes.md b/pages/common/git-notes.md new file mode 100644 index 000000000..7014ea664 --- /dev/null +++ b/pages/common/git-notes.md @@ -0,0 +1,36 @@ +# git notes + +> Add or inspect object notes. +> More information: . + +- List all notes and the objects they are attached to: + +`git notes list` + +- List all notes attached to a given object (defaults to HEAD): + +`git notes list [{{object}}]` + +- Show the notes attached to a given object (defaults to HEAD): + +`git notes show [{{object}}]` + +- Append a note to a specified object (opens the default text editor): + +`git notes append {{object}}` + +- Append a note to a specified object, specifying the message: + +`git notes append --message="{{message_text}}"` + +- Edit an existing note (defaults to HEAD): + +`git notes edit [{{object}}]` + +- Copy a note from one object to another: + +`git notes copy {{source_object}} {{target_object}}` + +- Remove all the notes added to a specified object: + +`git notes remove {{object}}` From d1f0c8baf1308806b41d7511632e9f57e228762a Mon Sep 17 00:00:00 2001 From: Luca Dorigo Date: Thu, 14 May 2020 00:43:50 +0200 Subject: [PATCH 30/60] unshadow: add page (#4041) Co-authored-by: Starbeamrainbowlabs --- pages/linux/unshadow.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/linux/unshadow.md diff --git a/pages/linux/unshadow.md b/pages/linux/unshadow.md new file mode 100644 index 000000000..44de83dcc --- /dev/null +++ b/pages/linux/unshadow.md @@ -0,0 +1,12 @@ +# unshadow + +> Utility provided by the John the Ripper project to obtain the traditional Unix password file if the system uses shadow passwords. +> More information: . + +- Combine the /etc/shadow and /etc/passwd of the current system: + +`sudo unshadow /etc/passwd /etc/shadow` + +- Combine two arbitrary shadow and password files: + +`sudo unshadow {{/path/to/passwd}} {{/path/to/shadow}}` From eb83f0ee73a33b1f516090341c931a1c80a62037 Mon Sep 17 00:00:00 2001 From: Daniel Bayley Date: Thu, 14 May 2020 16:04:48 +0100 Subject: [PATCH 31/60] whence: add page (#4021) --- pages/osx/whence.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 pages/osx/whence.md diff --git a/pages/osx/whence.md b/pages/osx/whence.md new file mode 100644 index 000000000..c1aa98f07 --- /dev/null +++ b/pages/osx/whence.md @@ -0,0 +1,23 @@ +# whence + +> A zsh builtin to indicate how a given command would be interpreted. + +- Interpret {{command}}, with expansion if defined as an `alias` (similar to the `command -v` builtin): + +`whence {{command}}` + +- Display type of {{command}}, with location if defined as a function, or binary (equivalent to the `type` and `command -V` builtins): + +`whence -v {{command}}` + +- Same as above, except display content of shell functions instead of location (equivalent to `which` builtin): + +`whence -c {{command}}` + +- Same as above, but show all occurrences on command path (equivalent to the `where` builtin): + +`whence -ca {{command}}` + +- Search only the `PATH` for {{command}}, ignoring builtins, aliases or shell functions (equivalent to the `where` command): + +`whence -p {{command}}` From 82f56cf95cbd9c3ec81bb5480e37cc7ca13b2145 Mon Sep 17 00:00:00 2001 From: Pierre Rudloff Date: Thu, 14 May 2020 17:07:23 +0200 Subject: [PATCH 32/60] debchange, debuild, dget, quilt: add pages (#4022) --- pages/common/quilt.md | 28 ++++++++++++++++++++++++++++ pages/linux/debchange.md | 16 ++++++++++++++++ pages/linux/debuild.md | 16 ++++++++++++++++ pages/linux/dget.md | 16 ++++++++++++++++ 4 files changed, 76 insertions(+) create mode 100644 pages/common/quilt.md create mode 100644 pages/linux/debchange.md create mode 100644 pages/linux/debuild.md create mode 100644 pages/linux/dget.md diff --git a/pages/common/quilt.md b/pages/common/quilt.md new file mode 100644 index 000000000..81c434c82 --- /dev/null +++ b/pages/common/quilt.md @@ -0,0 +1,28 @@ +# quilt + +> Tool to manage a series of patches. +> More information: . + +- Import an existing patch from a file: + +`quilt import {{path/to/filename.patch}}` + +- Create a new patch: + +`quilt new {{filename.patch}}` + +- Add a file to the current patch: + +`quilt add {{path/to/file}}` + +- After editing the file, refresh the current patch with the changes: + +`quilt refresh` + +- Apply all the patches in the series file: + +`quilt push -a` + +- Remove all applied patches: + +`quilt pop -a` diff --git a/pages/linux/debchange.md b/pages/linux/debchange.md new file mode 100644 index 000000000..4d087052c --- /dev/null +++ b/pages/linux/debchange.md @@ -0,0 +1,16 @@ +# debchange + +> Tool for maintenance of the debian/changelog file in a Debian source package. +> More information: . + +- Add a new version for a non-maintainer upload to the changelog: + +`debchange --nmu` + +- Add a changelog entry to the current version: + +`debchange --append` + +- Add a changelog entry to close the bug with specified ID: + +`debchange --closes {{bug_id}}` diff --git a/pages/linux/debuild.md b/pages/linux/debuild.md new file mode 100644 index 000000000..cd3824506 --- /dev/null +++ b/pages/linux/debuild.md @@ -0,0 +1,16 @@ +# debuild + +> Tool to build a Debian package from source. +> More information: . + +- Build the package in the current directory: + +`debuild` + +- Build a binary package only: + +`debuild -b` + +- Do not run lintian after building the package: + +`debuild --no-lintian` diff --git a/pages/linux/dget.md b/pages/linux/dget.md new file mode 100644 index 000000000..d996705f1 --- /dev/null +++ b/pages/linux/dget.md @@ -0,0 +1,16 @@ +# dget + +> Download Debian packages. +> More information: . + +- Download a binary package: + +`dget {{package_name}}` + +- Download and extract a package source from its .dsc file: + +`dget {{http://deb.debian.org/debian/pool/main/h/haskell-tldr/haskell-tldr_0.4.0-2.dsc}}` + +- Download a package source tarball from its .dsc file but don't extract it: + +`dget -d {{http://deb.debian.org/debian/pool/main/h/haskell-tldr/haskell-tldr_0.4.0-2.dsc}}` From 025d93d2522a220760ff386a15bc6379f36f9f43 Mon Sep 17 00:00:00 2001 From: Hojjat Date: Thu, 14 May 2020 11:23:32 -0600 Subject: [PATCH 33/60] pkg-config: add page (#4045) --- pages/linux/pkg-config.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 pages/linux/pkg-config.md diff --git a/pages/linux/pkg-config.md b/pages/linux/pkg-config.md new file mode 100644 index 000000000..7b85a504e --- /dev/null +++ b/pages/linux/pkg-config.md @@ -0,0 +1,16 @@ +# pkg-config + +> Provide the details of installed libraries for compiling applications. +> More information: . + +- Get the list of libraries and their dependencies: + +`pkg-config --libs {{library1 library2 ...}}` + +- Get the list of libraries, their dependencies, and proper cflags for gcc: + +`pkg-config --cflags --libs {{library1 library2 ...}}` + +- Compile your code with libgtk-3, libwebkit2gtk-4.0 and all their dependencies: + +`c++ example.cpp $(pkg-config --cflags --libs gtk+-3.0 webkit2gtk-4.0) -o example` From 842eb98af4eff6e53443bec886b4d1368efa6546 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fran=C3=A7ois=20Delbrayelle?= Date: Thu, 14 May 2020 23:31:01 +0200 Subject: [PATCH 34/60] jhipster: add page (#4047) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Zlatan Vasović Co-authored-by: Iván Hernández Cazorla Co-authored-by: Andrik Albuquerque --- pages/common/jhipster.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 pages/common/jhipster.md diff --git a/pages/common/jhipster.md b/pages/common/jhipster.md new file mode 100644 index 000000000..cd25a49b6 --- /dev/null +++ b/pages/common/jhipster.md @@ -0,0 +1,36 @@ +# jhipster + +> Web application generator using either monolithic or microservices architecture. +> More information: . + +- Generate a simple full-stack project (monolithic or microservices): + +`jhipster` + +- Generate a simple frontend project: + +`jhipster --skip-server` + +- Generate a simple backend project: + +`jhipster --skip-client` + +- Apply lastest JHipster updates to the project: + +`jhipster upgrade` + +- Add a new entity to a generated project: + +`jhipster entity {{entity_name}}` + +- Import a JDL file to configure your application (see: https://start.jhipster.tech/jdl-studio/): + +`jhipster import-jdl {{first_file.jh second_file.jh ... n_file.jh}}` + +- Generate a CI/CD pipeline for your application: + +`jhipster ci-cd` + +- Generate a Kubernetes configuration for your application: + +`jhipster kubernetes` From 87332d3bd2fce11580efe00c6ae317ad6b1463cf Mon Sep 17 00:00:00 2001 From: sarnobat Date: Thu, 14 May 2020 19:41:02 -0700 Subject: [PATCH 35/60] vlc: add example (#4048) --- pages/common/vlc.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/pages/common/vlc.md b/pages/common/vlc.md index 417cbf40e..2a0e2fa0f 100644 --- a/pages/common/vlc.md +++ b/pages/common/vlc.md @@ -14,3 +14,7 @@ - Play muted: `vlc --no-audio {{path/to/file}}` + +- Play repeatedly: + +`vlc --loop {{path/to/file}}` From 22f186ac66bd7d8a97bb8a1801f8d2fdb74c3005 Mon Sep 17 00:00:00 2001 From: Ultimate Pea Date: Fri, 15 May 2020 16:12:43 -0700 Subject: [PATCH 36/60] identify: add page (#4036) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Zlatan Vasović Co-authored-by: Andrik Albuquerque Co-authored-by: Iván Hernández Cazorla --- pages/common/identify.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 pages/common/identify.md diff --git a/pages/common/identify.md b/pages/common/identify.md new file mode 100644 index 000000000..6bb2a12ae --- /dev/null +++ b/pages/common/identify.md @@ -0,0 +1,8 @@ +# identify + +> Command line utility of Image Magick project to describe the format and characteristics of one or more image files. +> More information: . + +- Collect dimensions of all jpeg files under current directory: + +`identify -format "%f,%w,%h\n" *.{{jpg}} > {{filelist.csv}}` From 35f90e5f59f5880ea750b67af82c5c66da4df4bb Mon Sep 17 00:00:00 2001 From: michaeldel Date: Tue, 19 May 2020 10:21:38 +0200 Subject: [PATCH 37/60] docker-run: add page (#4054) --- pages/common/docker-run.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 pages/common/docker-run.md diff --git a/pages/common/docker-run.md b/pages/common/docker-run.md new file mode 100644 index 000000000..c50b5c02f --- /dev/null +++ b/pages/common/docker-run.md @@ -0,0 +1,28 @@ +# docker run + +> Run a command in a new Docker container. +> More information: . + +- Run command in a new container from a tagged image: + +`docker run {{image:tag}} {{command}}` + +- Run command in a new container in background and display its ID: + +`docker run -d {{image}} {{command}}` + +- Run command in a one-off container in interactive mode and pseudo-TTY: + +`docker run --rm -it {{image}} {{command}}` + +- Run command in a new container with passed environment variables: + +`docker run -e '{{variable}}={{value}}' -e {{variable}} {{image}} {{command}}` + +- Run command in a new container with bind mounted volumes: + +`docker run -v {{path/to/host_path}}:{{path/to/container_path}} {{image}} {{command}}` + +- Run command in a new container with published ports: + +`docker run -p {{host_port}}:{{container_port}} {{image}} {{command}}` From d841c0de25b23491ce04787f491af789a9f41cdd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Caio=20Amaral=20Corr=C3=AAa?= Date: Tue, 19 May 2020 11:32:20 -0300 Subject: [PATCH 38/60] apktool: add page (#4053) --- pages/common/apktool.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 pages/common/apktool.md diff --git a/pages/common/apktool.md b/pages/common/apktool.md new file mode 100644 index 000000000..4313704a6 --- /dev/null +++ b/pages/common/apktool.md @@ -0,0 +1,16 @@ +# apktool + +> Reverse engineer APK files. +> More information: . + +- Decode an APK file: + +`apktool d {{file.apk}}` + +- Build a folder into an APK file: + +`apktool b {{path/to/directory}}` + +- Install and store frameworks: + +`apktool if {{framework.apk}}` From c298499fb03b08c87ea475cd3708c57dd15375e8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Zlatan=20Vasovi=C4=87?= Date: Thu, 21 May 2020 01:13:29 +0200 Subject: [PATCH 39/60] notify-send: add an icon example (#4056) --- pages/linux/notify-send.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/pages/linux/notify-send.md b/pages/linux/notify-send.md index 4083cfe01..6a9741699 100644 --- a/pages/linux/notify-send.md +++ b/pages/linux/notify-send.md @@ -13,3 +13,7 @@ - Show a notification for 5 seconds: `notify-send -t 5000 {{"Test"}} {{"This is a test"}}` + +- Show a notification with an app's icon: + +`notify-send {{"Test"}} --icon={{google-chrome}}` From 8a9a0e82226eee23750d59dc9934368659d1b313 Mon Sep 17 00:00:00 2001 From: Owen Voke Date: Thu, 21 May 2020 02:28:19 +0100 Subject: [PATCH 40/60] adguardhome: add page (#4055) --- pages/common/adguardhome.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 pages/common/adguardhome.md diff --git a/pages/common/adguardhome.md b/pages/common/adguardhome.md new file mode 100644 index 000000000..7bdd04b5e --- /dev/null +++ b/pages/common/adguardhome.md @@ -0,0 +1,32 @@ +# AdGuardHome + +> A network-wide software for blocking ads & tracking. +> More information: . + +- Run AdGuard Home: + +`AdGuardHome` + +- Run AdGuard Home with a specific config: + +`AdGuardHome --config {{path/to/AdGuardHome.yaml}}` + +- Set the work directory for data to be stored in: + +`AdGuardHome --work-dir {{path/to/directory}}` + +- Install or uninstall AdGuard Home as a service: + +`AdGuardHome --service {{install|uninstall}}` + +- Start the AdGuard Home service: + +`AdGuardHome --service start` + +- Reload the configuration for the AdGuard Home service: + +`AdGuardHome --service reload` + +- Stop or restart the AdGuard Home service: + +`AdGuardHome --service {{stop|restart}}` From 19d232cbf410c48fd3bf8123aed08a806f28f080 Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:39:36 +0800 Subject: [PATCH 41/60] go-mod: add page (#4003) Signed-off-by: gonejack --- pages/common/go-mod.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 pages/common/go-mod.md diff --git a/pages/common/go-mod.md b/pages/common/go-mod.md new file mode 100644 index 000000000..bf0a99ca3 --- /dev/null +++ b/pages/common/go-mod.md @@ -0,0 +1,16 @@ +# go mod + +> Tool for module maintenance. +> More information: . + +- Download modules to local cache: + +`go mod download` + +- Add missing and remove unused modules: + +`go mod tidy` + +- Copy all dependencies into vendor directory: + +`go mod vendor` From f289daca9e02b47658d90c13ae0804228614127c Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:39:47 +0800 Subject: [PATCH 42/60] go-list: add page (#4003) Signed-off-by: gonejack --- pages/common/go-list.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/common/go-list.md diff --git a/pages/common/go-list.md b/pages/common/go-list.md new file mode 100644 index 000000000..0b1ede96d --- /dev/null +++ b/pages/common/go-list.md @@ -0,0 +1,12 @@ +# go list + +> List packages or modules. +> More information: . + +- List all packages: + +`go list all` + +- List all modules: + +`go list -m all` From a6ef97ac93b68e965bd4a1f0d43631ab637cd6f4 Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:39:58 +0800 Subject: [PATCH 43/60] go-generate: add page (#4003) Signed-off-by: gonejack --- pages/common/go-generate.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 pages/common/go-generate.md diff --git a/pages/common/go-generate.md b/pages/common/go-generate.md new file mode 100644 index 000000000..d58cd7d29 --- /dev/null +++ b/pages/common/go-generate.md @@ -0,0 +1,8 @@ +# go generate + +> Generate Go files by processing source. +> More information: . + +- Scan and generate under current directory: + +`go generate .` From 6f6d15a034f527a092c12eb0c0cc43704faef2ce Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:40:07 +0800 Subject: [PATCH 44/60] go-fix: add page (#4003) Signed-off-by: gonejack --- pages/common/go-fix.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 pages/common/go-fix.md diff --git a/pages/common/go-fix.md b/pages/common/go-fix.md new file mode 100644 index 000000000..f1fa2f2bb --- /dev/null +++ b/pages/common/go-fix.md @@ -0,0 +1,8 @@ +# go doc + +> Tool for updating packages to use new APIs. +> More information: . + +- Update packages to use new APIs: + +`go fix {{packages}}` From 16c3791dd9c062ac3897b5849bf5ce07c96dc753 Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:40:17 +0800 Subject: [PATCH 45/60] go-env: add page (#4003) Signed-off-by: gonejack --- pages/common/go-env.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 pages/common/go-env.md diff --git a/pages/common/go-env.md b/pages/common/go-env.md new file mode 100644 index 000000000..dbaa076c0 --- /dev/null +++ b/pages/common/go-env.md @@ -0,0 +1,16 @@ +# go env + +> Tool for printing Go environment information. +> More information: . + +- Show all go environment information: + +`go env` + +- Show specific environment variable: + +`go env {{GOPATH}}` + +- Set go environment value: + +`go env -w {{NAME}}={{VALUE}}` From fe8743a0674e45bf05598b5e8a3b143c365866ab Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:40:35 +0800 Subject: [PATCH 46/60] go-doc: add page (#4003) Signed-off-by: gonejack --- pages/common/go-doc.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/common/go-doc.md diff --git a/pages/common/go-doc.md b/pages/common/go-doc.md new file mode 100644 index 000000000..c128d6a8f --- /dev/null +++ b/pages/common/go-doc.md @@ -0,0 +1,12 @@ +# go doc + +> Tool for showing documentation for package or symbol. +> More information: . + +- Show documentation for {{Foo}} in the current package: + +`go doc {{Foo}}` + +- Show documentation and method summary for {{json.Number}}: + +`go doc {{json.Number}}` From be4d64baf29d6db7a9f79e486155d8c70da9916c Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:40:44 +0800 Subject: [PATCH 47/60] go-clean: add page (#4003) Signed-off-by: gonejack --- pages/common/go-clean.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 pages/common/go-clean.md diff --git a/pages/common/go-clean.md b/pages/common/go-clean.md new file mode 100644 index 000000000..44a42ee7e --- /dev/null +++ b/pages/common/go-clean.md @@ -0,0 +1,24 @@ +# go clean + +> Tool for removing object files and cached files. +> More information: . + +- Print the remove commands only: + +`go clean -n` + +- Remove go build cache: + +`go clean -cache` + +- Remove all test results in the go build cache : + +`go clean -testcache` + +- Remove go module download cache: + +`go clean -modcache` + +- Remove all: + +`go clean -cache -testcache -modcache -i -r` From 799b2d39ed2c33864072fbb46381352cc5612773 Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:40:54 +0800 Subject: [PATCH 48/60] go-build: add page (#4003) Signed-off-by: gonejack --- pages/common/go-build.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 pages/common/go-build.md diff --git a/pages/common/go-build.md b/pages/common/go-build.md new file mode 100644 index 000000000..a8460fe92 --- /dev/null +++ b/pages/common/go-build.md @@ -0,0 +1,12 @@ +# go build + +> Tool for compiling packages and dependencies. +> More information: . + +- Compile a source file into a named executable: + +`go build -o {{executable}} {{path/to/main/file}}.go` + +- Compile a main package into a named executable: + +`go build -o {{executable}} {{path/to/main/package}}` From 81b3fe231ee49f31613b2554587f89bc2d015b7d Mon Sep 17 00:00:00 2001 From: gonejack Date: Fri, 8 May 2020 20:41:05 +0800 Subject: [PATCH 49/60] go-bug: add page (#4003) Signed-off-by: gonejack --- pages/common/go-bug.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 pages/common/go-bug.md diff --git a/pages/common/go-bug.md b/pages/common/go-bug.md new file mode 100644 index 000000000..d85a13648 --- /dev/null +++ b/pages/common/go-bug.md @@ -0,0 +1,8 @@ +# go bug + +> Tool for reporting golang bugs. +> More information: . + +- Open a web page to start a bug report: + +`go bug` From 7221d87294694135b17a26cbde580128f79ee88a Mon Sep 17 00:00:00 2001 From: gonejack Date: Mon, 11 May 2020 11:48:44 +0800 Subject: [PATCH 50/60] go-bug: apply suggestion Signed-off-by: gonejack --- pages/common/go-bug.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/common/go-bug.md b/pages/common/go-bug.md index d85a13648..768259bce 100644 --- a/pages/common/go-bug.md +++ b/pages/common/go-bug.md @@ -1,7 +1,7 @@ # go bug -> Tool for reporting golang bugs. -> More information: . +> Report a bug. +> More information: . - Open a web page to start a bug report: From ae117a5437cdf3ac3563ff4801566f9ed284aae3 Mon Sep 17 00:00:00 2001 From: gonejack Date: Mon, 11 May 2020 11:49:49 +0800 Subject: [PATCH 51/60] go-build: apply suggestions Signed-off-by: gonejack --- pages/common/go-build.md | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/pages/common/go-build.md b/pages/common/go-build.md index a8460fe92..01cea6c8e 100644 --- a/pages/common/go-build.md +++ b/pages/common/go-build.md @@ -1,12 +1,20 @@ # go build -> Tool for compiling packages and dependencies. -> More information: . +> Compile Go sources. +> More information: . -- Compile a source file into a named executable: +- Compile a file: -`go build -o {{executable}} {{path/to/main/file}}.go` +`go build path/to/main.go` -- Compile a main package into a named executable: +- Compile into named output: -`go build -o {{executable}} {{path/to/main/package}}` +`go build -o {{binary}} path/to/source.go` + +- Compile a package: + +`go build -o {{binary}} path/to/package` + +- Compile a main package into an executable, with data race detection: + +`go build -race -o {{executable}} path/to/main/package` From 0f22991cb6ebb51db5bbb688f5b5d3a09e986c97 Mon Sep 17 00:00:00 2001 From: gonejack Date: Mon, 11 May 2020 11:50:47 +0800 Subject: [PATCH 52/60] go-clean: apply suggestions Signed-off-by: gonejack --- pages/common/go-clean.md | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/pages/common/go-clean.md b/pages/common/go-clean.md index 44a42ee7e..c704ee850 100644 --- a/pages/common/go-clean.md +++ b/pages/common/go-clean.md @@ -1,24 +1,20 @@ # go clean -> Tool for removing object files and cached files. -> More information: . +> Remove object files and cached files. +> More information: . - Print the remove commands only: `go clean -n` -- Remove go build cache: +- Remove build cache: `go clean -cache` -- Remove all test results in the go build cache : +- Remove cached test results: `go clean -testcache` -- Remove go module download cache: +- Remove module cache: `go clean -modcache` - -- Remove all: - -`go clean -cache -testcache -modcache -i -r` From ea24f0643a5bb07528eca728f6b9c37a41e40fde Mon Sep 17 00:00:00 2001 From: gonejack Date: Mon, 11 May 2020 12:02:04 +0800 Subject: [PATCH 53/60] go-doc: apply suggestion Signed-off-by: gonejack --- pages/common/go-doc.md | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/pages/common/go-doc.md b/pages/common/go-doc.md index c128d6a8f..f4a031611 100644 --- a/pages/common/go-doc.md +++ b/pages/common/go-doc.md @@ -1,12 +1,24 @@ # go doc -> Tool for showing documentation for package or symbol. -> More information: . +> Show documentation for package or symbol. +> More information: . -- Show documentation for {{Foo}} in the current package: +- Show documentation for current package: -`go doc {{Foo}}` +`go doc` -- Show documentation and method summary for {{json.Number}}: +- Show package documentation and exported symbols: -`go doc {{json.Number}}` +`go doc {{encoding/json}}` + +- Show also documentation of symbols: + +`go doc -all {{encoding/json}}` + +- Show also sources: + +`go doc -all -src {{encoding/json}}` + +- Show a specific symbol: + +`go doc -all -src {{encoding/json.Number}}` From e9bd9da77a0cb90da2d7b16c267817de9f78fca6 Mon Sep 17 00:00:00 2001 From: gonejack Date: Mon, 11 May 2020 12:03:05 +0800 Subject: [PATCH 54/60] go-env: apply suggestions Signed-off-by: gonejack --- pages/common/go-env.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/pages/common/go-env.md b/pages/common/go-env.md index dbaa076c0..e66a7d0b2 100644 --- a/pages/common/go-env.md +++ b/pages/common/go-env.md @@ -1,16 +1,20 @@ # go env -> Tool for printing Go environment information. -> More information: . +> Manage environment variables used by the Go toolchain. +> More information: . -- Show all go environment information: +- Show all environment variables: `go env` -- Show specific environment variable: +- Show an environment variable: `go env {{GOPATH}}` -- Set go environment value: +- Set an environment value: -`go env -w {{NAME}}={{VALUE}}` +`go env -w {{GOBIN}}={{path/to/directory}}` + +- Reset an environment value: + +`go env -u {{GOBIN}}` From 39f30ce6c7150cf9b2bbd5f066615a9535dd4703 Mon Sep 17 00:00:00 2001 From: gonejack Date: Mon, 11 May 2020 12:03:41 +0800 Subject: [PATCH 55/60] go-fix: apply suggestions Signed-off-by: gonejack --- pages/common/go-fix.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pages/common/go-fix.md b/pages/common/go-fix.md index f1fa2f2bb..fcef7e857 100644 --- a/pages/common/go-fix.md +++ b/pages/common/go-fix.md @@ -1,7 +1,7 @@ -# go doc +# go fix -> Tool for updating packages to use new APIs. -> More information: . +> Update packages to use new APIs. +> More information: . - Update packages to use new APIs: From 6888a29a68cd17409a9cd91cb7a12d6667ac9223 Mon Sep 17 00:00:00 2001 From: gonejack Date: Mon, 11 May 2020 12:04:18 +0800 Subject: [PATCH 56/60] go-generate: apply suggestions Signed-off-by: gonejack --- pages/common/go-generate.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pages/common/go-generate.md b/pages/common/go-generate.md index d58cd7d29..2a4955ac5 100644 --- a/pages/common/go-generate.md +++ b/pages/common/go-generate.md @@ -1,8 +1,8 @@ # go generate > Generate Go files by processing source. -> More information: . +> More information: . -- Scan and generate under current directory: +- Generate Go files by running commands within source files: -`go generate .` +`go generate` From 21a74424c7cfaa82fdc9f55a1d00f979ee5cf454 Mon Sep 17 00:00:00 2001 From: gonejack Date: Mon, 11 May 2020 12:08:42 +0800 Subject: [PATCH 57/60] go-mod: apply suggestions Signed-off-by: gonejack --- pages/common/go-mod.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/pages/common/go-mod.md b/pages/common/go-mod.md index bf0a99ca3..c02d2925c 100644 --- a/pages/common/go-mod.md +++ b/pages/common/go-mod.md @@ -1,7 +1,11 @@ # go mod -> Tool for module maintenance. -> More information: . +> Module maintenance. +> More information: . + +- Initialize new module in current directory: + +`go mod init {{moduleName}}` - Download modules to local cache: @@ -11,6 +15,10 @@ `go mod tidy` -- Copy all dependencies into vendor directory: +- Verify dependencies have expected content: + +`go mod verify` + +- Copy all dependencies sources into vendor directory: `go mod vendor` From 1298e61d38addcf235666a10cad15f6355057288 Mon Sep 17 00:00:00 2001 From: gonejack Date: Mon, 11 May 2020 12:09:09 +0800 Subject: [PATCH 58/60] go-version: apply suggestions Signed-off-by: gonejack --- pages/common/go-version.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pages/common/go-version.md b/pages/common/go-version.md index fa2312731..4cf27e7bb 100644 --- a/pages/common/go-version.md +++ b/pages/common/go-version.md @@ -1,12 +1,12 @@ # go version > Print Go version. -> More information: . +> More information: . -- Print version: +- Print Go version: `go version` -- Report the Go version used to build the named executable file: +- Print the Go version used to build the named executable file: `go version {{executable}}` From 8421b10d30c0dfd2a36ea84dde54249de4590e28 Mon Sep 17 00:00:00 2001 From: gonejack Date: Wed, 13 May 2020 17:42:23 +0800 Subject: [PATCH 59/60] go-list: apply suggestions Signed-off-by: gonejack --- pages/common/go-list.md | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/pages/common/go-list.md b/pages/common/go-list.md index 0b1ede96d..5441ccf8c 100644 --- a/pages/common/go-list.md +++ b/pages/common/go-list.md @@ -1,12 +1,20 @@ # go list > List packages or modules. -> More information: . +> More information: . -- List all packages: +- List packages: -`go list all` +`go list ./...` -- List all modules: +- List standard packages: -`go list -m all` +`go list std` + +- List packages in json format: + +`go list -json time net/http` + +- List module dependencies and available updates: + +`go list -m -u all` From 4cac843cae95c7a2aa382595fa4f0837724468bc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=BC=9A=E6=9C=89=E7=8C=AB=E7=9A=84?= Date: Fri, 15 May 2020 00:01:50 +0800 Subject: [PATCH 60/60] go-*: apply additional suggestions Co-authored-by: Starbeamrainbowlabs --- pages/common/go-build.md | 10 +++++----- pages/common/go-clean.md | 8 ++++---- pages/common/go-doc.md | 4 ++-- pages/common/go-env.md | 6 +++--- pages/common/go-generate.md | 2 +- pages/common/go-mod.md | 2 +- pages/common/go-version.md | 2 +- 7 files changed, 17 insertions(+), 17 deletions(-) diff --git a/pages/common/go-build.md b/pages/common/go-build.md index 01cea6c8e..c0e8c6d78 100644 --- a/pages/common/go-build.md +++ b/pages/common/go-build.md @@ -5,16 +5,16 @@ - Compile a file: -`go build path/to/main.go` +`go build {{path/to/main.go}}` -- Compile into named output: +- Compile, specifying the output filename: -`go build -o {{binary}} path/to/source.go` +`go build -o {{path/to/binary}} {{path/to/source.go}}` - Compile a package: -`go build -o {{binary}} path/to/package` +`go build -o {{path/to/binary}} {{path/to/package}}` - Compile a main package into an executable, with data race detection: -`go build -race -o {{executable}} path/to/main/package` +`go build -race -o {{path/to/executable}} {{path/to/main/package}}` diff --git a/pages/common/go-clean.md b/pages/common/go-clean.md index c704ee850..803c82115 100644 --- a/pages/common/go-clean.md +++ b/pages/common/go-clean.md @@ -3,18 +3,18 @@ > Remove object files and cached files. > More information: . -- Print the remove commands only: +- Print the remove commands instead of actually removing anything: `go clean -n` -- Remove build cache: +- Delete the build cache: `go clean -cache` -- Remove cached test results: +- Delete all cached test results: `go clean -testcache` -- Remove module cache: +- Delete the module cache: `go clean -modcache` diff --git a/pages/common/go-doc.md b/pages/common/go-doc.md index f4a031611..d21a84587 100644 --- a/pages/common/go-doc.md +++ b/pages/common/go-doc.md @@ -1,9 +1,9 @@ # go doc -> Show documentation for package or symbol. +> Show documentation for a package or symbol. > More information: . -- Show documentation for current package: +- Show documentation for the current package: `go doc` diff --git a/pages/common/go-env.md b/pages/common/go-env.md index e66a7d0b2..2820bdd4e 100644 --- a/pages/common/go-env.md +++ b/pages/common/go-env.md @@ -7,14 +7,14 @@ `go env` -- Show an environment variable: +- Show a specific environment variable: `go env {{GOPATH}}` -- Set an environment value: +- Set an environment variable to a value: `go env -w {{GOBIN}}={{path/to/directory}}` -- Reset an environment value: +- Reset an environment variable's value: `go env -u {{GOBIN}}` diff --git a/pages/common/go-generate.md b/pages/common/go-generate.md index 2a4955ac5..8a1f3b746 100644 --- a/pages/common/go-generate.md +++ b/pages/common/go-generate.md @@ -1,6 +1,6 @@ # go generate -> Generate Go files by processing source. +> Generate Go files by running commands within source files. > More information: . - Generate Go files by running commands within source files: diff --git a/pages/common/go-mod.md b/pages/common/go-mod.md index c02d2925c..0d1804864 100644 --- a/pages/common/go-mod.md +++ b/pages/common/go-mod.md @@ -19,6 +19,6 @@ `go mod verify` -- Copy all dependencies sources into vendor directory: +- Copy sources of all dependencies into the vendor directory: `go mod vendor` diff --git a/pages/common/go-version.md b/pages/common/go-version.md index 4cf27e7bb..1ed64f493 100644 --- a/pages/common/go-version.md +++ b/pages/common/go-version.md @@ -9,4 +9,4 @@ - Print the Go version used to build the named executable file: -`go version {{executable}}` +`go version {{path/to/executable}}`