mirror of
https://github.com/vee1e/flare-floss.git
synced 2026-09-01 09:49:59 +00:00
tags: separate multi-tag families from single tags
This commit is contained in:
parent
2af52bd74a
commit
ed923fda2e
1 changed files with 17 additions and 12 deletions
29
doc/tags.md
29
doc/tags.md
|
|
@ -12,22 +12,27 @@ to the data under [floss/tags/data/](../floss/tags/data/).
|
|||
|
||||
## Tag families
|
||||
|
||||
Tags are grouped into families, one per tag-source directory under
|
||||
[floss/tags/data/](../floss/tags/data/). A family name matches any tag in that
|
||||
family, so `--tag oss` matches every open-source library tag, and
|
||||
`--no-tag oss` drops all of them at once.
|
||||
A family name matches any tag in that family, so `--tag oss` matches every
|
||||
open-source library tag, and `--no-tag oss` drops all of them at once.
|
||||
|
||||
| Family | Example tags | Source |
|
||||
|---|---|---|
|
||||
| `winapi` | `#winapi` | Windows API usage database (`floss/tags/data/winapi/`) |
|
||||
| `crt` | `#msvc` | Microsoft C runtime library (`floss/tags/data/crt/`) |
|
||||
| `expert` | `#capa` | Expert / capa rules (`floss/tags/data/expert/`) |
|
||||
| `gp` | `#common`, `#code-junk` | Global-prevalence database (`floss/tags/data/gp/`) |
|
||||
| `oss` | `#openssl`, `#zlib`, `#curl`, … | Open-source library databases (`floss/tags/data/oss/`) |
|
||||
The multi-tag families are:
|
||||
|
||||
The `oss` family has one tag per library, derived from the file name in
|
||||
| Family | Tags |
|
||||
|---|---|
|
||||
| `gp` | `#common`, `#code-junk` |
|
||||
| `oss` | one tag per library, e.g. `#openssl`, `#zlib`, `#curl` |
|
||||
|
||||
The `oss` family derives each library tag from the file name in
|
||||
`floss/tags/data/oss/` (for example `openssl.jsonl.gz` → `#openssl`).
|
||||
|
||||
The remaining tags are single tags, not families, and can be filtered directly:
|
||||
|
||||
| Tag | Source |
|
||||
|---|---|
|
||||
| `#winapi` | Windows API usage database (`floss/tags/data/winapi/`) |
|
||||
| `#msvc` | Microsoft C runtime library (`floss/tags/data/crt/`) |
|
||||
| `#capa` | Expert / capa rules (`floss/tags/data/expert/`) |
|
||||
|
||||
## Match behavior
|
||||
|
||||
Tag matching is normalized: a leading `#` is stripped and the tag is lowercased,
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue