From c27646a68921458d04a4903a3511538802095b30 Mon Sep 17 00:00:00 2001 From: Mattias Wadman Date: Sat, 23 Jul 2022 22:50:33 +0200 Subject: [PATCH] doc: Update and shorten README.md a bit --- README.md | 14 +++----------- 1 file changed, 3 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 8451e909..b407b448 100644 --- a/README.md +++ b/README.md @@ -6,17 +6,11 @@ Tool, language and decoders for working with binary data. fq is inspired by the well known jq tool and language and allows you to work with binary formats the same way you would using jq. In addition it can present data like a hex viewer, transform, slice and concatenate binary data. It also supports nested formats and has an interactive REPL with auto-completion. -It was originally designed to query, inspect and debug media codecs and containers like mp4, flac, mp3, jpeg. Since then it has been extended to support a variety of formats like executables, packet captures (including TCP reassembly) and serialization formats like JSON, YAML, XML, ASN1 BER, Avro, CBOR, protobuf. +It was originally designed to query, inspect and debug media codecs and containers like mp4, flac, mp3, jpeg. Since then it has been extended to support a variety of formats like executables, packet captures (including TCP reassembly) and serialization formats like JSON, YAML, XML, ASN1 BER, Avro, CBOR, protobuf. In addition it also has functions to work with URL:s, convert to/from hex, number bases, search for things etc. In summary it aims to be jq, hexdump, dd and gdb for files combined into one. -**NOTE:** fq is still early in development so things might change, be broken or do not make sense. -That also means that there is a great opportunity to help out! - -### Name - -The "f" in fq originate from [file(1)](https://man7.org/linux/man-pages/man1/file.1.html) and format in FFmpeg terminology. -I pronounce jq /‘dʒei’kju:/ so I usually pronounce fq /‘ef’kju:/. +**NOTE:** fq is still early in development so things might change, be broken or do not make sense. That also means that there is a great opportunity to help out! ### Goals @@ -139,9 +133,7 @@ yaml, [#]: sh-end -#### Other non-binary formats - -Can go to/from XML, JSON, jq-flavored JSON, YAML, TOML, CSV, URLs, hex string, base64, string encodings etc. +It can also work with some common text formats like URL:s, hex, base64, PEM etc and for some serialization formats like XML, YAML etc it can transform both from and to jq values. For details see [formats.md](doc/formats.md) and [usage.md](doc/usage.md).