summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJakob Kaivo <jkk@ung.org>2019-08-01 09:59:14 -0400
committerJakob Kaivo <jkk@ung.org>2019-08-01 09:59:14 -0400
commitfff56280ea009d490b3abd23b5ad920cdd483908 (patch)
tree5bfd678f07d4c2f84f0347c65ea935dc0dc93b99 /README.md
parentc8319c68c2d5b85dd2c000d19bc760b1fcc384fb (diff)
add -q optionarray
Diffstat (limited to 'README.md')
-rw-r--r--README.md15
1 files changed, 10 insertions, 5 deletions
diff --git a/README.md b/README.md
index 501e107..d15dba0 100644
--- a/README.md
+++ b/README.md
@@ -4,12 +4,12 @@ translate files to C arrays
## Synopsis
-`array [-s] [file...]`
+`array [-s] [-q qualifier] [file...]`
## Description
-The `array` utility translates its input into C arrays (of type
-`unsigned char`) that can then be used (via `#include`) in larger C programs.
+The `array` utility translates its input into C arrays (of a qualified type
+of `char`) that can then be used (via `#include`) in larger C programs.
This is useful if you need to embed a binary (e.g. an image) or text (e.g.
a template) file and need to ship a program as a single, self-contained
executable.
@@ -17,12 +17,17 @@ executable.
## Options
The `array` utility conforms to the XBD Utility Syntax Guidelines. It supports
-one option:
+the following options:
`-s` Include an additional identifier in the output indicating
the size of the array. See STDOUT below for a detailed
description.
+`-q` Apply the C type qualifier `qualifier` to the generated array. If
+ none is provided, the default is `unsigned`. To remove any qualifiers
+ altogether (e.g. to declare an array of `char`), specify the empty
+ string (e.g. `-q ''`).
+
## Operands
The `array` utility supports the following operands:
@@ -41,7 +46,7 @@ Input files are treated as raw binary streams, with no requirements on format.
## STDOUT
-A definition of a C array of type `unsigned char` and unspecified length, with
+A definition of a C array of type qualified `char` and unspecified length, with
members initialized to the bytes of the input file. Each array is named with
the name of the input file, except all non alphanumeric characters (as
identified by the function `isalnum()`) are translated to `_`. If the input