Skip to content

Commit

Permalink
Updates README
Browse files Browse the repository at this point in the history
Signed-off-by: Stephan Kämper <[email protected]>
  • Loading branch information
s2k committed Nov 30, 2024
1 parent 33470da commit 8924219
Showing 1 changed file with 8 additions and 4 deletions.
12 changes: 8 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
`fd` reads files (or STDIN) _as a sequence of (UTF-8) characters_ and dumps the content to _STDOUT_, thus the name `fd`. It does so in two columns, the left one will display the hex values of the bytes in the file, the right one will display the characters.

## History

I created this tool **back in 2004**. It was programmed in a different world: On another operating system, using another file system (which most notably didn't have the concept of case-sensitive file names). This version originally used ISO-8859-1 as the default (and only) encoding, while it now assumes UTF-8.

The early versions had it easy: Each character was assumed to use one byte in the file. This made displaying it in rows with a constant number of characters easy. Nowadays, however, a singe character may be composed of a (varying) number of bytes, making it impossible to always display the same number of characters in each row.
Expand All @@ -26,19 +26,23 @@ gem 'fd'

Then execute:

$ bundle install
```bash
bundle install
```

Or install it yourself as:

$ gem install fd
```bash
gem install fd
```

Also see the [fd page on rubygems.org](https://rubygems.org/gems/fd)

## Usage

You can pass _file names_ on the command line:

```
```bash
fd [-w number] [file_names]
```

Expand Down

0 comments on commit 8924219

Please sign in to comment.