diff --git a/doc/flatpak-build-bundle.xml b/doc/flatpak-build-bundle.xml
index e3cdcd67..42aaabc4 100644
--- a/doc/flatpak-build-bundle.xml
+++ b/doc/flatpak-build-bundle.xml
@@ -48,11 +48,11 @@
in the repository at LOCATION. If
a BRANCH is specified, this branch of
the application is used.
-
The format of the bundle file is that of an ostree static delta
diff --git a/doc/flatpak-build-commit-from.xml b/doc/flatpak-build-commit-from.xml
index 9e919408..b1b82f25 100644
--- a/doc/flatpak-build-commit-from.xml
+++ b/doc/flatpak-build-commit-from.xml
@@ -46,11 +46,11 @@
contents (and most of the metadata) taken from another
branch, either from another repo, or from another branch in
the same repository.
-
This command is very useful when you want to maintain a branch
diff --git a/doc/flatpak-build-export.xml b/doc/flatpak-build-export.xml
index 67413a91..a8f94226 100644
--- a/doc/flatpak-build-export.xml
+++ b/doc/flatpak-build-export.xml
@@ -63,16 +63,14 @@
subdirectories and the metadata file are included
in the commit, anything else is ignored.
-
The build-update-repo command should be used to update repository
metadata whenever application builds are added to a repository.
@@ -112,9 +110,8 @@
-
diff --git a/doc/flatpak-build-update-repo.xml b/doc/flatpak-build-update-repo.xml
index 761d21b4..1c23fa44 100644
--- a/doc/flatpak-build-update-repo.xml
+++ b/doc/flatpak-build-update-repo.xml
@@ -102,9 +102,8 @@
-
diff --git a/doc/flatpak-flatpakref.xml b/doc/flatpak-flatpakref.xml
index a8d2854e..01530fc0 100644
--- a/doc/flatpak-flatpakref.xml
+++ b/doc/flatpak-flatpakref.xml
@@ -107,13 +107,10 @@
(string)The url of a webpage describing the application or runtime.
-
(boolean)
diff --git a/doc/flatpak-flatpakrepo.xml b/doc/flatpak-flatpakrepo.xml
index 675c0b5e..c49a4fe7 100644
--- a/doc/flatpak-flatpakrepo.xml
+++ b/doc/flatpak-flatpakrepo.xml
@@ -103,13 +103,10 @@
(string)The url of a webpage describing the remote.
-
@@ -121,10 +118,7 @@
Title=GEdit
Url=http://sdk.gnome.org/repo-apps/
GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
-
diff --git a/doc/flatpak-metadata.xml b/doc/flatpak-metadata.xml
index 80f1e825..3490cfe4 100644
--- a/doc/flatpak-metadata.xml
+++ b/doc/flatpak-metadata.xml
@@ -665,7 +665,6 @@
Available since 0.6.7.
-
diff --git a/doc/flatpak-remote-modify.xml b/doc/flatpak-remote-modify.xml
index 9e961435..64d9a374 100644
--- a/doc/flatpak-remote-modify.xml
+++ b/doc/flatpak-remote-modify.xml
@@ -189,18 +189,16 @@
-
diff --git a/doc/flatpak-remote.xml b/doc/flatpak-remote.xml
index 8d8b8ad4..116e8e2d 100644
--- a/doc/flatpak-remote.xml
+++ b/doc/flatpak-remote.xml
@@ -80,18 +80,13 @@
(boolean)Whether to use GPG verification for the summary of this remote.
-
-
All flatpak-specific keys have a xa. prefix:
@@ -148,13 +143,17 @@
[remote "gnome-nightly-apps"]
gpg-verify=true
gpg-verify-summary=true
-
url=https://sdk.gnome.org/nightly/repo-apps/
xa.title=GNOME Applications
+
+
+
+[remote "flathub"]
+gpg-verify=true
+gpg-verify-summary=false
+collection-id=org.flathub.Stable
+url=https://dl.flathub.org/repo/
+xa.title=Flathub