1
Fork 0
mirror of https://github.com/RGBCube/serenity synced 2025-05-15 05:54:59 +00:00
serenity/Base/usr/share/man/man1/base64.md
Kemal Zebari 1d43bfc598 base64: Implement -w/--wrap
This is an option supported by coreutils, so we might as well support
it too.

It allows users to wrap their encoded output after the "column" value
they provide.

This commit also has the Markdown look more like what we see
when running ArgsParser::print_usage_markdown() (and it fixes some
of the examples).
2024-01-21 21:54:51 -05:00

34 lines
709 B
Markdown

## Name
base64 - encode and decode to base64
## Synopsis
```**sh
$ base64 [--decode] [--wrap column] [file]
```
## Description
`base64` encodes or decodes to base64 the data in file `file` or from stdin if
file is not specified or file is `-`.
## Options
* `-d`, `--decode`: Decode data
* `-w column`, `--wrap column`: When encoding, wrap output after `column` characters
## Examples
```sh
# base64 encode the text 'A'
$ echo 'A' | base64
# base64 encode the content of hi.txt
$ base64 hi.txt
# base64 encode the content of baz.txt and wrap after 4 columns
$ base64 -w 4 baz.txt
# base64 decode the text 'Zm9v'
$ echo 'Zm9v' | base64 -d
# base64 decode the content of foo.txt
$ base64 -d foo.txt
```