beeware · freakboy3742 · Mar 9, 2023 · Jan 30, 2023 · Feb 5, 2023 · Feb 5, 2023
diff --git a/changes/1062.feature.rst b/changes/1062.feature.rst
@@ -0,0 +1 @@
+A Linux System backend was added, supporting ``.deb`` as a packaging format.
diff --git a/changes/1063.feature.rst b/changes/1063.feature.rst
@@ -0,0 +1 @@
+Support for `.rpm` packaging was added to the Linux system backend.
diff --git a/changes/986.feature.rst b/changes/986.feature.rst
@@ -0,0 +1 @@
+When installing application sources and dependencies, any ``__pycache__`` folders are now automatically removed.
diff --git a/docs/reference/configuration.rst b/docs/reference/configuration.rst
@@ -83,7 +83,13 @@ be obtained by running ``briefcase -h``, and inspecting the help for the
 --------------------------------------------------------------
 
 Configuration options that are specific to a particular output format. For
-example, ``macOS`` applications can be generated in ``app`` or ``dmg`` format.
+example, macOS applications can be generated in ``app`` or ``dmg`` format.
+
+This section can contain additional layers. for example, an app targeting the
+Linux ``system`` backend can define a ``tool.briefcase.app.<app
+name>.linux.system.ubuntu.jammy`` section to provide configurations specific to
+Ubuntu 22.04 "Jammy" deployments. See the documentation for each backend for
+more details.
 
 Project configuration
 =====================
@@ -278,6 +284,14 @@ to an image to use as the background for the installer. As with ``splash``, the
 path should *exclude* the extension, and a platform-appropriate extension will
 be appended when the application is built.
 
+``long_description``
+~~~~~~~~~~~~~~~~~~~~
+
+A longer description of the purpose of the application. This description can be
+multiple paragraphs, if necessary. The long description *must not* be a copy of
+the ``description``, or include the ``description`` as the first line of the
+``long_description``.
+
 ``requires``
 ~~~~~~~~~~~~
 
@@ -289,6 +303,12 @@ application level, *and* platform level, the final set of requirements will be
 the *concatenation* of requirements from all levels, starting from least to
 most specific.
 
+``revision``
+~~~~~~~~~~~~
+
+An identifier used to differentiate specific builds of the same version of an
+app. Defaults to ``1`` if not provided.
+
 ``splash``
 ~~~~~~~~~~
 

diff --git a/docs/reference/platforms/android.rst b/docs/reference/platforms/android.rst
@@ -10,21 +10,21 @@ Icon format
 Android projects use ``.png`` format icons, in round and square variants. An
 application must provide the icons in the following sizes, for 2 variants:
 
-  * ``round``:
+* ``round``:
 
-    * 48px
-    * 72px
-    * 96px
-    * 144px
-    * 192px
+  * 48px
+  * 72px
+  * 96px
+  * 144px
+  * 192px
 
-  * ``square``:
+* ``square``:
 
-    * 48px
-    * 72px
-    * 96px
-    * 144px
-    * 192px
+  * 48px
+  * 72px
+  * 96px
+  * 144px
+  * 192px
 
 Splash Image format
 ===================
@@ -34,27 +34,27 @@ should be a square image with a transparent background. It must be specified
 in a range of sizes and variants, to suit different possible device sizes
 and device display densities:
 
-  * ``normal`` (typical phones; up to 480 density-independent pixels):
+* ``normal`` (typical phones; up to 480 density-independent pixels):
 
-    * 320px
-    * 480px (hdpi)
-    * 640px (xhdpi)
-    * 1280px (xxxhdpi)
+  * 320px
+  * 480px (hdpi)
+  * 640px (xhdpi)
+  * 1280px (xxxhdpi)
 
-  * ``large`` (large format phones, or phone-tablet "phablet" hybrids; up to
-    720 density-indpendent pixels):
+* ``large`` (large format phones, or phone-tablet "phablet" hybrids; up to
+  720 density-indpendent pixels):
 
-    * 480px
-    * 720px (hdpi)
-    * 960px (xhdpi)
-    * 1920px (xxxhdpi)
+  * 480px
+  * 720px (hdpi)
+  * 960px (xhdpi)
+  * 1920px (xxxhdpi)
 
-  * ``xlarge`` (tablets; larger than 720 density-independent pixels)
+* ``xlarge`` (tablets; larger than 720 density-independent pixels)
 
-    * 720px
-    * 1080px (hdpi)
-    * 1440px (xhdpi)
-    * 2880px (xxxhdpi)
+  * 720px
+  * 1080px (hdpi)
+  * 1440px (xhdpi)
+  * 2880px (xxxhdpi)
 
 Consult `the Android documentation
 <https://developer.android.com/training/multiscreen/screensizes>`__

diff --git a/docs/reference/platforms/iOS.rst b/docs/reference/platforms/iOS.rst
@@ -10,29 +10,29 @@ Icon format
 iOS projects use ``.png`` format icons. An application must provide icons of
 the following sizes:
 
-  * 20px
-  * 29px
-  * 40px
-  * 58px
-  * 60px
-  * 76px
-  * 80px
-  * 87px
-  * 120px
-  * 152px
-  * 167px
-  * 180px
-  * 1024px
+* 20px
+* 29px
+* 40px
+* 58px
+* 60px
+* 76px
+* 80px
+* 87px
+* 120px
+* 152px
+* 167px
+* 180px
+* 1024px
 
 Splash Image format
 ===================
 
 iOS projects use ``.png`` format splash screen images. A splash screen should
 be a square, transparent image, provided in the following sizes:
 
-  * 1024px
-  * 2048px
-  * 3072px
+* 1024px
+* 2048px
+* 3072px
 
 You can specify a background color for the splash screen using the
 ``splash_background_color`` configuration setting.

diff --git a/docs/reference/platforms/linux/appimage.rst b/docs/reference/platforms/linux/appimage.rst
@@ -49,12 +49,12 @@ Icon format
 AppImages uses ``.png`` format icons. An application must provide icons in
 the following sizes:
 
-  * 16px
-  * 32px
-  * 64px
-  * 128px
-  * 256px
-  * 512px
+* 16px
+* 32px
+* 64px
+* 128px
+* 256px
+* 512px
 
 Splash Image format
 ===================
@@ -76,8 +76,8 @@ Application configuration
 =========================
 
 The following options can be added to the
-``tool.briefcase.app.<appname>.linux`` section of your ``pyproject.toml``
-file.
+``tool.briefcase.app.<appname>.linux.appimage`` section of your
+``pyproject.toml`` file.
 
 ``system_requires``
 ~~~~~~~~~~~~~~~~~~~

diff --git a/docs/reference/platforms/linux/flatpak.rst b/docs/reference/platforms/linux/flatpak.rst
@@ -44,12 +44,12 @@ Icon format
 Flatpak uses ``.png`` format icons. An application must provide icons in
 the following sizes:
 
-  * 16px
-  * 32px
-  * 64px
-  * 128px
-  * 256px
-  * 512px
+* 16px
+* 32px
+* 64px
+* 128px
+* 256px
+* 512px
 
 Splash Image format
 ===================
@@ -60,8 +60,8 @@ Application configuration
 =========================
 
 The following options can be added to the
-``tool.briefcase.app.<appname>.linux`` section of your ``pyproject.toml``
-file.
+``tool.briefcase.app.<appname>.linux.flatpak`` section of your
+``pyproject.toml`` file.
 
 ``flatpak_runtime_repo_alias``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

diff --git a/docs/reference/platforms/linux/index.rst b/docs/reference/platforms/linux/index.rst
@@ -2,13 +2,14 @@
 Linux
 =====
 
-Briefcase supports packaging Linux apps in `AppImage <https://appimage.org>`__
-and `Flatpak <https://flatpak.org>`__ formats.
+Briefcase supports packaging Linux apps as native system packages, as an `AppImage
+<https://appimage.org>`__, and in `Flatpak <https://flatpak.org>`__ format.
 
-The default output format for Linux is :doc:`AppImage <./appimage>`.
+The default output format for Linux is :doc:`system packages <./system>`.
 
 .. toctree::
    :maxdepth: 1
 
+   system
    appimage
    flatpak