Commit Graph

338 Commits

Author SHA1 Message Date
Justus Winter
46af430766
Move sq certify to sq pki. 2024-01-17 14:40:55 +01:00
Justus Winter
0b69ca3552
Typo. 2024-01-17 14:40:55 +01:00
Justus Winter
b000993817
Move all global PKI options to subcommands where they are needed. 2024-01-17 14:40:55 +01:00
Justus Winter
2c7a22558a
Align the pki command line parser definition. 2024-01-16 18:27:10 +01:00
Justus Winter
003939169b
Drop unnecessary quotes. 2024-01-16 17:59:05 +01:00
Justus Winter
695dec0460
Typographic fixes. 2024-01-16 16:32:53 +01:00
Justus Winter
79c573c140
Align spelling and capitalization of Web of Trust. 2024-01-16 16:30:15 +01:00
Justus Winter
ed4f1efcb5
Rename sq wot to sq pki. 2024-01-16 16:22:30 +01:00
Justus Winter
cf6042e1b0
Add a key server from the synchronizing key server pool.
- This server is operated by Todd Fleisher, and comes with the
    highest recommendations regarding its high availability setup.
2024-01-16 15:48:31 +01:00
Justus Winter
19c6719786
Align terminology. 2024-01-16 15:45:47 +01:00
Justus Winter
7bb5a0fc3d
Simplify code.
- Being a non-leaf page implies that it has subcommands.
2024-01-16 14:56:59 +01:00
Justus Winter
b7448a9a16
Don't include the options in non-leaf manual pages. 2024-01-16 14:56:15 +01:00
Justus Winter
bc98f3dd53
Render subcommand headings into links. 2024-01-16 14:46:11 +01:00
Justus Winter
a3b1b2bdce
Improve and align the description of the network protocols. 2024-01-16 14:45:56 +01:00
Justus Winter
b68d22dfc8
Drop period from first line of about texts. 2024-01-16 14:43:59 +01:00
Justus Winter
8ffbb07ebe
Extend sq network keyserver publish'es help, align keyserver URLs. 2024-01-16 14:43:59 +01:00
Justus Winter
59b0b2a543
Rename sq network lookup to fetch, align network commands.
- Fixes #157.
2024-01-16 13:04:41 +01:00
Justus Winter
6a4f32e493
Remove sq keyring join.
- This is the less useful and more dangerous variant of sq keyring
    merge.  The former does not merge two copies of the same
    certificate into one, and is likely not what the user wants or
    expects, and the resulting keyring is more likely to cause
    problems when consumed by implementations.

  - Further, we have to explain the difference between join and merge,
    hurting ergonomics.

  - Once, sq keyring join had the advantage of not buffering
    certificates, but we now do that in order to produce the right
    labels, so even that advantage was gone.

  - Remove it.  Developers who want to produce keyrings with multiple
    copies of the same cert for testing purposes can do so with sq
    packet join.

  - Adapt the subplot tests.  Notably, as sq keyring merge does not
    preserve the order of certs as encountered in the inputs (should
    it?), but orders them by fingerprint, the order in the output is
    not predictable.  To work around, just test listing one key.
2024-01-15 19:21:37 +01:00
Justus Winter
49dd753bab
Harmonize specifying the trust amount.
- See #109.
2024-01-12 18:33:56 +01:00
Justus Winter
6cd2ae9d3b
Point users to our user manual.
- Previously, we pointed users to the API documentation, which
    doesn't seem helpful at all.
2024-01-12 18:22:43 +01:00
Justus Winter
fb0d0294a4
More typographic fixes. 2024-01-12 18:22:05 +01:00
Justus Winter
411db47cdf
Make sq inspect show subkeys without valid binding signatures.
- Fixes #69.
2024-01-12 17:28:38 +01:00
Justus Winter
1596f92a71
Add preliminary user interface guidelines. 2024-01-12 17:22:26 +01:00
Justus Winter
e65edaa04b
Typographic fixes in example. 2024-01-12 17:16:36 +01:00
Justus Winter
f8df0db7be
Render positional arguments. 2024-01-12 17:16:36 +01:00
Justus Winter
18b7f2d30b
Use back ticks for inline code and subcommand references. 2024-01-12 17:16:36 +01:00
Justus Winter
b260c9f3ee
Fix reference. 2024-01-12 14:54:44 +01:00
Justus Winter
47f232f8e0
Don't render subcommand option section if there aren't any. 2024-01-12 13:04:34 +01:00
Justus Winter
01371366b5
Typeset URL. 2024-01-12 12:44:19 +01:00
Justus Winter
9215196dc0
Create a new top-level network, and move relevant subcommands there. 2024-01-12 12:41:47 +01:00
Justus Winter
01c65c045b
Turn implicit links into actual links when rendering html man pages. 2024-01-11 18:17:11 +01:00
Justus Winter
5b92b6ee9d
Make the WoT examples more compact.
- Drop --keyring and --trust-root.  We get that from our certd.
2024-01-11 18:00:50 +01:00
Justus Winter
6d18c95001
Use single quotes in examples, don't quote unnecessarily. 2024-01-11 17:48:37 +01:00
Justus Winter
43dc8fc19f
Improve documentation of the CLI parser infrastructure. 2024-01-11 17:17:45 +01:00
Justus Winter
6c41d0dd43
Move the sq wot gossip example. 2024-01-11 17:08:31 +01:00
Justus Winter
6e07bb93d8
Remove {n} that snuck in. 2024-01-11 16:59:27 +01:00
Justus Winter
615d7ebe6d
Add missing about and long-about for sq wot. 2024-01-11 16:54:39 +01:00
Justus Winter
5b3f59a774
Fix rendering of indented paragraphs after tagged paragraphs. 2024-01-11 16:40:50 +01:00
Justus Winter
36aaf6fe3b
Render EXIT STATUS sections. 2024-01-11 16:34:57 +01:00
Justus Winter
0f3a796bc1
Improve rendering of examples.
- Join adjacent code blocks, prevent wrapping in HTML.
2024-01-11 13:41:51 +01:00
Justus Winter
479aeaec22
Fail the compilation if a line in an example is too long. 2024-01-11 13:26:09 +01:00
Justus Winter
c21d762fff
Put all the parent commands into the see-also section. 2024-01-11 13:00:28 +01:00
Justus Winter
e28e4dd829
Drop crypto-backend information from the manual pages.
- The interface should be independent of the backend, even if
    capabilities vary slightly.
2024-01-11 12:02:25 +01:00
Justus Winter
4fbab2777b
Make all top-level options global.
- This means that they can be given anywhere in the command line,
    not only directly following 'sq'.

  - Remove the '[GLOBAL OPTIONS]' from the man pages.  Adapt pandoc
    filter.
2024-01-11 11:46:39 +01:00
Justus Winter
b5dd71d761
Change sq keyring lint -f to -F to avoid a conflict with --force. 2024-01-11 11:39:24 +01:00
Justus Winter
e131ea102e
Use the README.md as top-level crate documentation.
- Previously, we used a concatenation of all subcommand help
    outputs, but this is unwieldy nowadays and an artifact from back
    when we didn't have proper manual pages and a way to host them
    nicely.  Drop this.
2024-01-10 18:00:33 +01:00
Justus Winter
f384e89cf3
Add documentation links to the README.md. 2024-01-10 17:52:47 +01:00
Justus Winter
d1bc1a3552
Turn entries in the synopsis into links.
- Filter pandoc's AST using lua instead of transforming pandoc's
    output with sed.  This allows us to also turn the entries in the
    synopsis into links, greatly improving usability.

  - Also, tweak the title.
2024-01-10 17:52:47 +01:00
Justus Winter
0e36c0f75a
Certify user IDs matched by email.
- Fixes #66.
2024-01-10 14:20:38 +01:00
Justus Winter
f3dbe53b91
Generalize certifying, prepare for email and fuzzy matching.
- This doesn't change the behavior, but prepares the code for
    matching on emails and fuzzy matching, and certifying multiple
    user IDs in one go.
2024-01-10 13:54:35 +01:00