Branch : - branch - android master - tag -

• Show log

  Commit

• Author : Pierre Le Marre
  Date : 2023-11-16 17:12:03
  Hash : 4ea9d431
  Message : rules: Add support for :all qualifier Some layout options require to be applied to every group to maintain consistency (e.g. a group switcher). Currently this must be done manually for all layout indexes. This is error prone and prevents the increase of the maximum group count. This commit introduces the `:all` qualifier for KcCGST values. When a rule with this qualifier is matched, it will expands the qualified value (and its optional merge mode) for every layout, e.g. `+group(toggle):all` (respectively `|group(toggle)`) would expand to `+group(toggle):1+group(toggle):2` (respectively `|group(toggle):1|group(toggle):2`) if there are 2 layouts, etc. If there is no merge mode, it defaults to *override* `+`, e.g. `x:all` expands to `x:1+x:2+x:3` for 3 layouts. Note that only the qualified *value* is expanded, e.g. `x+y:all` expands to `x+y:1+y:2` for 2 layouts. `:all` can be used in combination with special layout indexes. Since this can lead to an unexpected behaviour, a warning will be raised.

• Files
• README.md
• api
• build
• tools

• README.md

• Fragments for the changelog

  This directory contains fragments for the future NEWS file.

  Introduction

  We use towncrier to produce useful, summarized news files.

  There are 3 sections types:

  • API: changes/api
  • Tools: changes/tools
  • Build System: changes/build

  There are 3 news fragments types:

  • Breaking changes: .breaking
  • New: .feature
  • Fixes: .bugfix

  Adding a fragment

  Add a short description of the change in a file changes/SECTION/ID.FRAGMENT.md, where:

  • SECTION and FRAGMENT values are described in the previous section.
  • ID is the corresponding issue identifier on Github, if relevant. If there is no such issue, then ID should start with + and some identifier that make the file unique in the directory.

  Examples:

  • A bug fix for the issue #463 is an API change, so the corresponding file should be named changes/api/463.bugfix.md.
  • A new feature for tools like #448 corresponds to e.g. changes/tools/+add-verbose-opt.feature.md.

  Guidelines for the fragment files:

  • Use the Markdown markup.
  • Use past tense, e.g. “Fixed a segfault”.
  • Look at the previous releases NEWS file for further examples.

  Build the changelog

  Install towncrier from Pypi:

  python3 -m pip install towncrier
  

  Then build the changelog:

  # Only check the result. Useful after adding a new fragment.
  towncrier build --draft --version 1.8.0
  # Write the changelog & delete the news fragments
  towncrier build --yes --version 1.8.0