~mna/runes

68d29361e7e0807f5a1af1b82a402e5f57aba4bf — Martin Angers 1 year, 2 months ago 9658fe0
doc;
2 files changed, 50 insertions(+), 0 deletions(-)

A LICENSE
A README.md
A LICENSE => LICENSE +11 -0
@@ 0,0 1,11 @@
Copyright (c) 2020, Martin Angers

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

A README.md => README.md +39 -0
@@ 0,0 1,39 @@
# runes

Command runes prints Unicode runes to stdout along with the rune's
category and sub-category, its UTF8 and UTF16 encoding information
and its official name. Specific code points and ranges of code
points can be provided as arguments.

* Canonical repository: https://git.sr.ht/~mna/runes
* Issues: https://todo.sr.ht/~mna/runes

## Usage

```
usage: runes [-h] [-json] [CODEPT ...] [START-END ...] [- STRING ...]

The runes command prints information about Unicode code points. Without
argument, all code points are printed; specific code points can be requested as
arguments, and ranges of code points are supported (e.g. 0x17-0x60). Code
points starting with '0x' or 'u+' are considered in hexadecimal (the 'x' and
'u' are case insensitive), otherwise the number is processed as decimal.

A single dash '-' can be used so that subsequent arguments are treated as
strings for which each rune will be printed.

The output follows the order of runes as specified on the command-line,
the same rune will be printed multiple times if it is specified or included
in multiple arguments.

Examples:
    runes
    runes 0x2318 40-60
    runes u+1f970 0X55-0XA0 - "Some string"
```

## License

The [BSD 3-Clause license][bsd].

[bsd]: http://opensource.org/licenses/BSD-3-Clause