diff options
author | Jakob Odersky <jakob@odersky.com> | 2018-12-26 16:55:45 +0100 |
---|---|---|
committer | Jakob Odersky <jakob@odersky.com> | 2018-12-26 16:55:45 +0100 |
commit | b13be6260cad20a71006a827fb43cd7bb0621408 (patch) | |
tree | 782ff38267a98d36cadecd9f849a5fc938173c64 /README.md | |
parent | 433a83ff8e4849211ed1547d4246ef11afd059ac (diff) | |
download | codename-b13be6260cad20a71006a827fb43cd7bb0621408.tar.gz codename-b13be6260cad20a71006a827fb43cd7bb0621408.tar.bz2 codename-b13be6260cad20a71006a827fb43cd7bb0621408.zip |
Add readme and license
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..5e8506d --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +Utility to generate code names, suitable for placeholders of project +names. + +## Building +This is a scala-native project. The binary can be built by running +`sbt nativeLink`. Version information is derived from git, with +initial "v" dropped (e.g. the tag v1.2.3 represents version 1.2.3). + +## Usage +Refer to the help message of the utility (`codename --help`) for an +authoritative answer. + +``` +Usage: codename [OPTIONS...] [SPECIFICATION...] +Generate a random codename according to a specification ("A a n" by default). + +Options: + + -h, --help show help message + -v, --version show version information + +Specification: + + SPEC ::= { 'A' | 'a' | 'n' | SEP } + SEP ::= char + +where an 'A' is replaced by a random adverb, an 'a' by an adjective and +an 'n' by a noun. + +For example, the specification "A-a-n" will produce a code name such as: +"extra-pickled-umbrella" + +Multiple specifications may be given, each of which will be printed on a +separate line. +``` |