IF YOU WOULD LIKE TO GET AN ACCOUNT, please write an
email to Administrator. User accounts are meant only to access repo
and report issues and/or generate pull requests.
This is a purpose-specific Git hosting for
BaseALT
projects. Thank you for your understanding!
Только зарегистрированные пользователи имеют доступ к сервису!
Для получения аккаунта, обратитесь к администратору.
- 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.
- 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.
- 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.
- While sq packet isn't quite the right home for these commands,
they shouldn't be featured so prominently and clutter the
top-level subcommand hierarchy.
- See also #169.
- Examples may not wrap around in rendered documentation, and if
they do, it may distort the meaning. Care must be taken to keep
the line length reasonable.
- Previously, there were two ways of generating manual pages.
We used to use the upstream clap_mangen crate, but decided to
develop our own custom formatter. However, we didn't quite switch
to it, keeping the old mechanism in place and adding our new
solution to sq, activated by a hidden environment variable.
- This patch drops the upstream formatter, and uses the custom
formatter during build time. First, our custom code can be
tweaked easily to suit our needs, and switching back to the
upstream solution is easy enough should it better suit our needs.
Second, generating manual pages at build time should help
cross-building environments.
