Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/psibi/tldr-hs
Haskell tldr client
https://github.com/psibi/tldr-hs
Last synced: 1 day ago
JSON representation
Haskell tldr client
- Host: GitHub
- URL: https://github.com/psibi/tldr-hs
- Owner: psibi
- License: bsd-3-clause
- Created: 2017-03-18T22:16:30.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-07-22T14:42:46.000Z (over 2 years ago)
- Last Synced: 2025-01-17T07:04:48.234Z (9 days ago)
- Language: Haskell
- Size: 235 KB
- Stars: 92
- Watchers: 6
- Forks: 14
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome - psibi/tldr-hs - 07 star:0.1k fork:0.0k Haskell tldr client (Haskell)
README
# tldr
[](https://dev.azure.com/psibi2000/tldr-hs/_build/latest?definitionId=5?branchName=master)
[](https://hackage.haskell.org/package/tldr)
[](http://stackage.org/nightly/package/tldr)
[](http://stackage.org/lts/package/tldr)
Haskell client for tldr
**Table of Contents**
- [tldr](#tldr)
- [Installation](#installation)
- [Usage](#usage)
- [Offline caching](#offline-caching)
- [Snapshot](#snapshot)
## Installation
See Github releases: https://github.com/psibi/tldr-hs/releases
Executables are available for all the three major platforms: Linux, Windows and MacOS.
Or
1. [Install stack](https://docs.haskellstack.org/en/stable/README/#how-to-install)
2. `stack install tldr`
## Usage
``` shellsession
$ tldr --help
tldr - Simplified and community-driven man pages
Usage: tldr [-v|--version] ((-u|--update) | [-p|--platform PLATFORM]
[-L|--language LOCALE] COMMAND | (-a|--about))
tldr Client program
Available options:
-h,--help Show this help text
-v,--version Show version
-u,--update Update offline cache of tldr pages
-p,--platform PLATFORM Prioritize a specific platform while searching. Valid
values include linux, osx, windows, sunos
-L,--language LOCALE Preferred language for the page returned
COMMAND name of the command
-a,--about About this program
--auto-update-interval DAYS
Perform an automatic update if the cache is older
than DAYS
```
Or a much better example of the usage:
``` shellsession
$ tldr tldr
tldr
Simplified man pages. More information: https://tldr.sh.
- Get typical usages of a command (hint: this is how you got here!):
tldr {{command}}
- Show the tar tldr page for linux:
tldr -p {{linux}} {{tar}}
- Get help for a git subcommand:
tldr {{git checkout}}
```
## Offline caching
On the first run, this program caches all available tldr pages. Since
the number of available tldr pages rises quickly, it is recommended to
regularly update the cache. Such an update can be run manually with:
``` shellsession
$ tldr --update
```
Starting with version `0.9.0`, users of this client can enable automatic
updates by running it with the option `--auto-update-interval DAYS`
specified. The client will then check whether the cached version of the
tldr pages is older than `DAYS` days and perform an update in that case.
To enable this functionality permanently, users can put the line
`alias tldr="tldr --auto-update-interval DAYS"` in their shell
configuration file (e.g. `.bashrc`, `.zshrc`) with the desired update
interval specified.
## Snapshot
