Recent commits to derivepassphrase.git (c4574c9f06dd37f8a95af0efafb068ad62a8b7d7)

Merge topic branch 'usage-fixes' into master

2025-01-11T18:54:56+01:00

* t/usage-fixes:
  Fix tests for rephrased "Cannot update the %s settings" message
</pre>

Fix tests for rephrased "Cannot update the %s settings" message

2025-01-11T18:51:01+01:00

The rephrasing was introduced in
1b29904d789be7742119bfa06ce11aa5b7ffb6f9.
</pre>

Merge topic branch 'usage-fixes' into master

2025-01-11T16:39:58+01:00

* t/usage-fixes:
  Fix translation string formatting of preformatted paragraphs
  Make debug and info messages from exporter subcommands translatable
</pre>

Fix translation string formatting of preformatted paragraphs

2025-01-11T16:33:03+01:00

Due to a sign error, the paragraph content was being dropped.

And since we now actively include translation strings with preformatted
paragraphs, include coverage tracking for this case.
</pre>

Make debug and info messages from exporter subcommands translatable

2025-01-11T16:28:48+01:00

We add all debug and info messages from the `derivepassphrase export
vault` subcommand to the translatable strings enums.  We also improve
several debug messages from the "inline calculation" style to the more
easily translatable "tabular listing of relevant data" style.

Two unimportant info messages were dropped:

  * Attempting to parse as v0.2 configuration
  * Attempting to parse as v0.3 configuration
</pre>

Merge topic branch 'documentation-fixes' into master

2025-01-11T15:50:31+01:00

* t/documentation-fixes:
  Overhaul all other manpages and copyedit everything for consistency
</pre>

Overhaul all other manpages and copyedit everything for consistency

2025-01-11T15:38:02+01:00

The top-level `derivepassphrase` command, and the subcommands `export`
and `export vault` now have proper manpages (both manpage and online
formats) similar to `derivepassphrase vault`.

All manpages document the `--help`, `--version`, `--debug`, `--verbose`
and `--quiet` options.  If a command only delegates to subcommands,
a SUBCOMMANDS section is now present, and the DESCRIPTION section has
the subcommand listing deduplicated.  The COMPATIBILITY section details
compatibility only for this command, and refers to subcommand manpages
as necessary.

The new manpages do not tabulate their diagnostics yet, nor do they
include examples.
</pre>

Move manpage directory out of docs, to top-level

2025-01-08T14:52:31+01:00

The `docs` directory contains sources for the documentation website, to
be uploaded to the WWW.  While also "online" documentation (in the sense
that they are browsable on the customer's computer system), manpages are
not typically distributed online (in the WWW sense).

Besides, the `docs` directory already contains a rendering of the
manpage.
</pre>

Merge topic branch 'usage-fixes' into master

2025-01-07T23:42:07+01:00

* t/usage-fixes:
  Incorporate revised wording from the manpage into the README
</pre>

Incorporate revised wording from the manpage into the README

2025-01-07T23:36:49+01:00

The revised wording spells out the strength guarantee of the derivation
scheme and the purpose of the configuration file more explicitly.

We intentionally keep the introductory sentences (one-line description
and first sentence of the first explanatory paragraph) different,
because they have different contexts to work with; in particular, the
manpage contains a synopsis section and can refer to the SERVICE metavar
in its one-line description, whereas the README cannot, and should also
mention SSH keys early.
</pre>