LinuxCommandLibrary

tldrl

List recent commands with fuzzy search

TLDR

View documentation for the original command

$ tldr tldr-lint
copy

SYNOPSIS

tldr [options] command
tldr --update
tldr --version

PARAMETERS

command
    The name of the command for which to retrieve simplified examples (e.g., ls, grep, tar).

-l, --list
    Lists all available tldr pages in the local cache.

-r, --random
    Displays a random tldr page, useful for discovering new commands or learning.

-p <platform>, --platform <platform>
    Specifies the operating system platform for which to display the page (e.g., linux, osx, windows, android, sunos). By default, it detects the current platform.

-s <query>, --search <query>
    Searches for tldr pages containing the specified keyword(s) in their names or descriptions.

-u, --update
    Updates the local cache of tldr pages by downloading the latest versions from the repository.

-c, --clear-cache
    Clears the locally stored tldr pages cache, forcing a fresh download on the next query.

-v, --version
    Displays the version information of the installed tldr client.

-h, --help
    Shows the help message and available options for the tldr client.

DESCRIPTION

tldr (Too Long; Didn't Read) is a community-driven collection of simplified and practical examples for common Linux, macOS, and Windows command-line utilities.

It serves as a quick-reference alternative to traditional man pages, which can often be exhaustive and overwhelming for users just looking for basic syntax or common use cases. Instead of providing every possible option and detail, tldr focuses on showing practical, real-world examples of how commands are used, making it much faster to grasp essential functionality.

The project is maintained by a global community of contributors, ensuring that the content is current, relevant, and covers a wide array of commands and platforms. This collaborative nature makes tldr a highly valuable resource for developers and system administrators seeking concise, actionable command-line guidance.

CAVEATS

tldr pages are community-contributed and focus on common use cases, so they may not cover every obscure option or edge case. For exhaustive documentation, the traditional man pages are still the definitive source. An internet connection is required for initial setup and updates of the page cache.

COMMUNITY DRIVEN

The content of tldr pages is entirely community-contributed and maintained. This collaborative model ensures that the pages are practical, up-to-date, and cover a wide range of real-world scenarios and commands across various operating systems.

INSTALLATION

tldr clients are available in various programming languages (e.g., Node.js, Python, Rust, Go) and can typically be installed via platform-specific package managers (e.g., apt install tldr on Debian/Ubuntu, brew install tldr on macOS) or language-specific package managers (e.g., npm install -g tldr, pip install tldr).

HISTORY

The tldr project was initiated by Romain Coeur in 2017 with the goal of creating a more accessible and example-driven complement to standard manual pages. Its simple, practical approach quickly resonated with developers and system administrators. Since its inception, a diverse community has grown around it, contributing new pages and maintaining existing ones, solidifying its role as a go-to resource for quick command-line assistance.

SEE ALSO

man(1), info(1), apropos(1)

Copied to clipboard