Commit Graph

327 Commits (576854fc7b9ed01c8645cc797681cfb219fc4e34)

Author SHA1 Message Date
Alexander Larsson 43dbf96f7c Merge pull request #148 from matthiasclasen/journal
make journal logging work in the sandbox
2016-06-27 11:14:11 +02:00
matthiasclasen 5eede39078 Merge pull request #146 from matthiasclasen/document-d
gdb in sandbox doesn't work
2016-06-24 21:14:33 -04:00
Anssi Hannula 3fb031582e Fix builddir option type in flatpak-builder documentation 2016-06-24 11:33:02 +03:00
Matthias Clasen f6af5702db Document new socket option 2016-06-24 02:01:05 -04:00
Matthias Clasen c195c4197d Expand the flatpak run --devel docs
Mention that --devel also affects the seccomp profile.
Took me a while to find that out.
2016-06-23 14:31:40 -04:00
Alexander Larsson 640bf9e69c remote-ls: Better multiarch support
By default, only show supported refs. Use --arch to limit it
to a specific arch, or --arch=* to list all.
2016-06-23 13:08:12 +02:00
Alexander Larsson 8740a9ded3 Add flatpak --supported-arches 2016-06-23 11:12:28 +02:00
Matthias Clasen 0c873100b7 Document the flatpak-builder var support 2016-06-23 10:06:53 +02:00
Matthias Clasen 0ae7c446a1 Clarify the documentation a bit
Revise the man pages for the new document commands a bit, using
'document id' consistently, and adding cross references among them.
2016-06-18 21:08:27 -04:00
Matthias Clasen c35d7d141a Update overview man page
Group the document-related commands together, and add the new ones.
2016-06-16 15:05:18 -04:00
Matthias Clasen 9c16751709 flatpak: Add a command to list exported documents
This lists all the files that are exported, possibly limited
to a single app id.
2016-06-16 15:05:18 -04:00
Matthias Clasen 8281e614ce flatpak: Add a way to revoke privileges for exported documents
This adds --forbid-read, --forbid-write, --forbid-delete and
--forbid-grant-permissons options to flatpaks document-export
command, to let it revoke permissions on exported documents.
2016-06-16 15:05:18 -04:00
Matthias Clasen 528b1f8e29 flatpak: Add a document-unexport command
This calls org.freedesktop.portal.Documents.Delete to remove
an exported file from the document database altogether.
2016-06-16 15:05:18 -04:00
Matthias Clasen 52d32da215 flatpak: Add a document-info command
This uses the newly introduced non-portal interface to the
documents portal to obtain and show information about an
exported file.
2016-06-16 15:05:18 -04:00
Matthias Clasen 98a66ce6d8 Rename export-file to document-export
This fits better with the naming scheme for commands in general, and
will let us add more document portal related commands in the future.
2016-06-15 14:07:36 -04:00
Alexander Larsson a84f725211 Support --device=all
This gives the application full access to the host /dev. Obviously
this is not great in terms of sandboxing, but its nice for applications
that use flatpak mostly as a way to do distribution of the app.

Also, its not like the app has full access to anything, its still
limited to the access right of the user.
2016-06-14 22:33:14 +02:00
Matthias Clasen f1350f7853 flatpak-override docs: Add missing options
The --system-own-name and --system-talk-name options were missing
here.
2016-06-09 22:57:46 -04:00
Matthias Clasen 6ffb5cf21b flatpak-override docs: Fix spelling
We use well-known, following the D-Bus specification.
2016-06-09 22:54:09 -04:00
Matthias Clasen e7fe604ae5 flatpak-remote-modify docs: Fix broken references
The commands were rotated: it is remote-add, not add-remote.
2016-06-09 22:52:06 -04:00
Matthias Clasen f0782d72df flatpak-remote-ls docs: Add cross-references 2016-06-09 22:52:06 -04:00
Matthias Clasen 9a4fabed69 Fix a typo 2016-06-09 22:52:06 -04:00
Matthias Clasen 79365a7407 flatpak run docs: Fix formatting of references
These need to be comma-separated.
2016-06-09 22:52:06 -04:00
Matthias Clasen d40253444a flatpak-builder docs: fix nonexisting reference
flatpak doesn't have a build-build command.
2016-06-09 22:34:32 -04:00
Alexander Larsson 56cd2940aa Merge pull request #95 from matthiasclasen/manifest-docs
consider sources
2016-06-09 12:32:19 +02:00
Matthias Clasen 991c6b837a Document recursive modules and includes 2016-06-09 06:27:44 -04:00
Alexander Larsson bd66da0dad builder: Add support for patching mtime in python bytecode headers
This makes them work at runtime (as the mtime will then be 0) and
makes builds more repeatable.
2016-06-08 13:28:27 +02:00
Matthias Clasen 33f14a7002 Document /app/manifest.json
This is a nice bit of reproducibility that we shouldn't leave
undocumented.
2016-06-07 15:20:20 -04:00
Matthias Clasen a512da2592 Recommend a shell script wrapper for passing arguments
This has come up as a question, so document it.
2016-06-03 09:08:55 -04:00
Matthias Clasen db540a15e7 Document the --oci option of flatpak build-import-bundle 2016-06-02 15:02:49 -04:00
Matthias Clasen b4d5ec76a8 Document the --oci option of flatpak build-bundle 2016-06-02 14:53:22 -04:00
Alexander Larsson 71be0b2977 Merge pull request #62 from matthiasclasen/build-docs
Some fixed for flatpak-build(1)
2016-06-02 08:53:59 +02:00
matthiasclasen 4d8445fbb7 Small additions to flatpak-builder(1) (#63)
Document that app-id is the same as id, and fix a case
of suffixed<>suffix confusion.
2016-06-02 08:52:25 +02:00
Matthias Clasen 6ca2641203 Spelling: well-known
This is the spelling that is used in the D-Bus specification.
2016-06-01 15:38:23 -04:00
Matthias Clasen 6177f85c4d Document more options for flatpak build
The --default-arch, --system-own-name and --system-talk-name options
were all missing from the man page. Add them.
2016-06-01 15:36:50 -04:00
Matthias Clasen 77fe43808d Document --version and --verbose for flatpak-build
These options were missing here.
2016-06-01 15:31:13 -04:00
Matthias Clasen 2c591b2fcd Document --no-filesystem in flatpak-build(1)
Also document the :ro suffix for --filesystem.
2016-06-01 15:28:49 -04:00
Alexander Larsson f9cbcc3996 Merge pull request #49 from jsoref/spelling
spelling fixes
2016-05-27 09:02:14 +02:00
Josh Soref 2dc56c77a2 spelling: repository 2016-05-27 06:45:53 +00:00
Josh Soref 4dad6b458e spelling: repositories 2016-05-27 06:45:39 +00:00
Josh Soref eaaa06ef27 spelling: distinguished 2016-05-27 06:40:23 +00:00
Josh Soref 794c62cc44 spelling: available 2016-05-27 06:37:37 +00:00
Matthias Clasen c129fb7155 Document restrictions on module names 2016-05-27 00:42:37 -04:00
Alexander Larsson c48272c6db uninstall: Default to whatever branch is installed 2016-05-26 19:08:46 +02:00
Alexander Larsson bf294fb7c5 install: Be smarter about choosing the default branch name
We look for any matching ref on the remote and use that if there is a single match.
2016-05-26 19:06:51 +02:00
Alexander Larsson 3d232bbe15 Merge pull request #161 from smcv/spelling
Fix various spelling mistakes
2016-05-17 17:51:20 +02:00
Simon McVittie a4641280a7 Fix various spelling mistakes
Mostly detected by Debian's Lintian tool.

Signed-off-by: Simon McVittie <smcv@debian.org>
2016-05-17 11:43:32 +01:00
Matthias Clasen 0cfd001d9b Add some new api to the docs 2016-05-16 19:49:48 -04:00
Matthias Clasen e7d53ca7cb Add new FlatpakRemote apis to the docs 2016-05-16 19:37:08 -04:00
Alexander Larsson 2875cdead5 remote-delete: Move to FlatpakDir and add checks for installed refs
You can't remove a remote unless you --force or there are no installs
from it.
2016-05-13 14:17:46 +02:00
Alexander Larsson fcf137f25d Remove references to --gpg-key= as it never worked 2016-05-11 15:39:11 +02:00
Alexander Larsson 28c1c65d8f Builder: Support disabled=true to not build a module
This is a simple way to "comment out" a module.
2016-05-09 17:24:42 +02:00
Alexander Larsson 8abbc0186e Rename everything but the on-disk location to flatpak 2016-05-09 11:11:55 +02:00
Alexander Larsson ba37b22d78 Rename library to libflatpak 2016-05-09 09:46:26 +02:00
Alexander Larsson 6a613d1fab Rename all non-autogenerated symbols to flatpak 2016-05-09 09:00:20 +02:00
Tristan Van Berkom 51e387159b build-export: Add --arch option
This patch adds the --arch option to the build-export builtin command.

Previously build-export derives this from the metadata and then falls back
to xdg_app_get_arch(), except that this does not work when the metadata does
not specify an arch (such as with extensions like .Debug or .Locale).

https://bugs.freedesktop.org/show_bug.cgi?id=95226
2016-05-03 09:05:56 +02:00
Tristan Van Berkom aa69c1afef xdg-app-builder: Add --arch command line option
This is only useful for building for architectures which are
compatible with the build host, e.g. building i686 binaries on
an x86_64 build host.
2016-05-02 08:46:52 +02:00
Alexander Larsson f37b3261d6 Add support for disabled remotes
If this is set we don't list them by default, and we don't
automatically update apps from them.
2016-04-27 13:39:34 +02:00
Alexander Larsson 406ee7da18 docs: Fix typo 2016-04-26 10:34:53 +02:00
Matthias Clasen dd8ef68f76 Expands docs around dbus policy options
We should mention that the NAME may end with .* to match multiple
names. Also, add the --system- variants of these options to the
xdg-app run man page where they were missing.
2016-04-20 15:27:27 -04:00
Alexander Larsson b16517798f Add --ref to build-import-bundle to override branch name 2016-04-20 11:46:13 +02:00
Alexander Larsson cfd3f303b1 Add build-import-bundle command 2016-04-19 13:53:26 +02:00
Alexander Larsson c8cdb75a09 Merge branch 'typo-fix' of https://github.com/matthiasclasen/xdg-app into matthiasclasen-typo-fix 2016-04-16 21:43:06 +02:00
Matthias Clasen 1c41cac06b Document field types
This is not entirely clear for all fields from the documentation.
2016-04-16 00:54:34 -04:00
Matthias Clasen 73c98722e8 Fix a typo
s/extention/extension/
2016-04-16 00:11:39 -04:00
Matthias Clasen 3299640b2d Remove a duplicate { 2016-04-16 00:11:05 -04:00
Alexander Larsson 265ba5e528 Merge pull request #128 from matthiasclasen/run-fixes
Some fixes for xdg-app-builder --run
2016-04-15 11:50:34 +02:00
Matthias Clasen 1992901b63 Document --force-clean
We shouldn't allow new options to be added without documentation.
2016-04-14 19:29:41 -04:00
Matthias Clasen ae96c039f9 Document --run better
The xdg-app-builder commandline with --run looks a bit different,
spell this out in the docs.
2016-04-14 19:18:35 -04:00
Matthias Clasen fd4c1018d4 docs: Move generic options up top
It is nicer if --help, --version and --verbose are together
at the top of the options list.
2016-04-14 10:05:45 -04:00
Matthias Clasen 6c1970ad45 Document --log-session-bus and --log-system-bus 2016-04-14 10:04:43 -04:00
Matthias Clasen 74074facaf Explain --repo-url a bit better
Make it clearer that this must be accessible from the systems
where the bundle is installed, it is not useful to specify
your local repository here.
2016-04-13 18:23:26 -04:00
Matthias Clasen ef02059906 docs: Mention bundle installation in overview 2016-04-13 17:42:12 -04:00
Matthias Clasen 0e2d8ec886 Trivial doc fixes
Just add some punctuation.
2016-04-13 17:39:31 -04:00
Matthias Clasen 5d27b8742a Document the --bundle option
I was looking for information on how to install bundles, and found
nothing, since the --bundle option wasn't documented.
2016-04-13 17:36:40 -04:00
Alexander Larsson 19509eb808 Merge pull request #123 from matthiasclasen/doc-builder-details
doc: Explain .xdg-app-builder
2016-04-13 16:12:32 +02:00
Alexander Larsson 2472d3905f Merge pull request #124 from matthiasclasen/typo-fix
Fix a possibly confusing doc typo
2016-04-13 16:12:01 +02:00
Matthias Clasen a286692010 Fix a possibly confusing doc typo 2016-04-13 09:36:19 -04:00
Matthias Clasen cb9b3e6987 doc: Explain .xdg-app-builder
This directory can grow quite large (my local example here is 900M),
so we should document that it is safe to remove.
2016-04-13 09:26:59 -04:00
Matthias Clasen 726a8fe935 doc: Clarify the cleanup docs
Mention explicitly that full paths are not expected to have the
/app prefix. I was confused about this, so others might too.
2016-04-13 07:49:25 -04:00
Alexander Larsson eb3a0df75c Add xdg-app build-sign to sign a single commit 2016-04-13 10:08:59 +02:00
Matthias Clasen f1843adaf9 doc: Add build-args to xdg-app-builder man page
This option was missing from the "Build Options" section.
2016-04-12 19:04:30 -04:00
Matthias Clasen bcef5ca3ea Improve the xdg-app-builder man page
Fix some inconsistencies, and update the example to not
not use app-id.
2016-04-12 16:00:28 -04:00
Matthias Clasen e29192c89f doc: Make xdg-app-build-init man page match reality
The order of arguments did not match what the tool expects.
DIRECTORY comes first.
2016-04-12 14:52:04 -04:00
Alexander Larsson 3cc45ccf13 Add support for subpath limited installs
This allows you to install e.g. org.freedesktop.Platform.Locale
but only the /sv subdir, and replaces using separate branches for
each locale.
2016-04-07 20:36:53 +02:00
Matthias Clasen 2a2ae8008b More class hiding 2016-03-25 11:38:41 -04:00
Matthias Clasen 516432740d doc: Add xdg_app_installation_install_bundle 2016-03-25 11:36:20 -04:00
Matthias Clasen 5f02c340b4 docs: Hide class structs
There is no intention to let any of these be subclasses,
so don't show the classes.
2016-03-25 11:33:30 -04:00
Matthias Clasen 1c41f04dbb docs: Exclude more private headers
This reduces the noise in the gtk-doc output.
2016-03-25 11:26:07 -04:00
Matthias Clasen 5f657bee2f docs: No need for a deprecated index
No deprecated APIs yet - knock on wood!
2016-03-25 11:17:40 -04:00
Matthias Clasen 7a5f874e69 docs: Pick up the version number automatically
This is copied from what GTK+ does for its docs.
2016-03-25 11:16:20 -04:00
Matthias Clasen 7873de5155 doc: Minor reshuffling 2016-03-25 10:53:26 -04:00
Matthias Clasen 9649cae95f Add xdg-app info to docs
Add the info command in xdg-app(1), and build the existing
man page for it.
2016-03-22 11:37:18 -04:00
Matthias Clasen f46dce3188 Align contents of xdg-app.1 with xdg-app --help 2016-03-22 11:26:17 -04:00
Matthias Clasen 2d678c9379 Document xdg-app-build-bundle 2016-03-22 11:26:17 -04:00
Alexander Larsson 69890db5f1 build-update-repo: Add --generate-static-deltas option 2016-02-25 21:13:20 +01:00
Alexander Larsson c84ebe0440 Support --filesystem=xdg-run/foo 2016-02-25 17:11:37 +01:00
Alexander Larsson 26cd90e100 Allow specifying subdir of xdg dir, like: --filesytem=xdg-download/subdir 2016-02-25 16:51:45 +01:00
Alexander Larsson b9368753fa docs: Add docs for shell sources 2016-02-22 16:26:46 +01:00
Alexander Larsson d5d47aa458 builder: Support separating out locale data 2016-02-18 19:22:34 +01:00
Alexander Larsson 6b6e4b213a Add docs for appstream-compose option. 2016-02-18 17:35:11 +01:00
Alexander Larsson bb4d67b086 builder: Support tags 2016-02-17 14:54:16 +01:00
Alexander Larsson be97206c7b build-init: Support --tag=FOO 2016-02-17 14:50:34 +01:00
Alexander Larsson 71259fa711 builder: Support local archives with path property 2016-02-17 14:50:01 +01:00
Alexander Larsson 6c5feb4e05 builder: Add support for --run to start a command in the build dir 2016-02-17 10:26:35 +01:00
Alexander Larsson 1d5fb6438b Add xdg-app info command 2016-02-02 17:51:10 +01:00
Alexander Larsson 9f2769e0ce builder: Use non-parallel-make option instead of looking at .NONPARALLEL 2016-02-01 21:40:22 +01:00
Simon McVittie 9a6bf95054 Disable gtkdoc-check by default for now
We know the documentation is incomplete, so there seems little value
in having 'make check' tell us that. Everything except the documentation
check is expected to succeed, so it's now more useful to report test
failures in continuous integration systems, making functional
regressions more visible.

Signed-off-by: Simon McVittie <smcv@debian.org>
2016-01-29 09:41:23 +01:00
Alexander Larsson 4ac5befb7f Support a proxy on the system bus similar to the one on the session bus 2016-01-29 08:50:11 +01:00
Sam Thursfield 66cdd7b197 Document the structs in libxdg-app 2016-01-28 11:26:12 +01:00
Sam Thursfield f3f6ca8ddf docs: Fix gtk-doc documentation
We need to explicitly tell gtk-doc about the XDG_APP_EXTERN macro,
otherwise it will ignore all of the function definitions.

Full docs are now produced. There are plenty of warnings which can be
fixed later.
2016-01-27 16:45:55 +01:00
Alexander Larsson 7940a773ef Always build libxmlapp 2016-01-22 22:19:52 +01:00
Alexander Larsson 7f05ac562c update: Make both branch and name optional
We know what is installed, so we just update everything
that you don't specify the details for.
2016-01-22 15:21:20 +01:00
Alexander Larsson 472405ff7f builder: Add platform-extensions 2016-01-20 14:41:09 +01:00
Alexander Larsson 6d2aa7b29e builder: Support sdk-extensions 2016-01-20 14:11:29 +01:00
Alexander Larsson 022b9876f7 build-init: Add --sdk-extension 2016-01-20 14:00:53 +01:00
Alexander Larsson 9e8ca412f5 build-update-repo: Add --prune and --prune-depth options 2016-01-19 12:26:45 +01:00
Alexander Larsson 6e204a4d2e Add support to gpg sign summaries and appstream 2016-01-18 21:36:57 +01:00
Alexander Larsson e91a4c79e0 Builder: Support commiting a platform 2016-01-18 15:22:56 +01:00
Alexander Larsson 3341fb08ad builder: Allow building runtime sdks (based on existing sdk)
This includes a few different changes:
 * Add build-runtime boolean property
 * Rename "app-id" property to "id"
 * Add metadata property to use a custom base metadata file
 * Default to writable-sdk to TRUE for runtimes
 * Default prefix to /usr for runtimes
 * Put manifest in usr for runtimes
 * Pick up debuginfo from usr for runtimes
 * Make build-finish work on runtimes, but only export appdata
2016-01-18 11:43:02 +01:00
Alexander Larsson efad98815a build-export: Add --include option 2016-01-18 11:22:25 +01:00
Sam Thursfield 5210387fcf docs: Add missing full stops in xdg-app-builder manpage 2016-01-17 18:33:26 +00:00
Alexander Larsson 5a12157add remote-ls: Regularize --runtime and --app user 2016-01-13 17:21:08 +01:00
Alexander Larsson 025fa4e4d6 Merge list-apps and list-runtimes into single list command 2016-01-13 17:02:15 +01:00
Alexander Larsson 37c6485183 docs: Update for the new command names 2016-01-13 16:33:43 +01:00
Alexander Larsson d43e797b4b builder: Add support for rename-appdata-file option 2016-01-12 16:30:20 +01:00
Alexander Larsson 689c36aa8f builder: Pass --body, --subject and --gpg-sign to build-export 2016-01-12 12:25:45 +01:00
Alexander Larsson f95cd2d029 builder: Add option to enable ccache use in build 2016-01-12 12:09:09 +01:00
Alexander Larsson e1cb723c55 build: Add --bind-mount and --build-dir arguments 2016-01-12 10:42:04 +01:00
Alexander Larsson 1934562ca2 run: Be more flexible with --runtime option, and add --runtime-version
This makes it easier to experiment with running an app with a
different runtime.
2016-01-12 09:57:20 +01:00
Alexander Larsson df75f881e7 export: Add docs for the new command line arguments 2016-01-12 09:14:12 +01:00
Alexander Larsson 33f634ec67 export: Support --exclude 2016-01-11 13:57:59 +01:00
Alexander Larsson 98a7d731ad builder: Add support for separating out debuginfo 2016-01-11 11:40:46 +01:00
Alexander Larsson 6ddee9905b build-export: Add --runtime commit support 2015-12-21 15:38:42 +01:00
Alexander Larsson 3adb84e368 build-finish: Add --no-exports 2015-12-21 15:37:26 +01:00
Alexander Larsson 1264335458 builder: Add --disable-updates
Download sources, but never update existing sources (like git or bzr).
2015-12-21 10:39:23 +01:00
Alexander Larsson ea543c8f93 lib/app: Add support for repo priorities
New repos default to prio 1, bundle repos default to prio 0.
Listing repos returns in sorted order, with add order as secondary
sort key.
2015-12-21 10:28:15 +01:00
Alexander Larsson b9b9ad9ccc app: Support --no-pull and --no-deploy in the install and update commands
This adds general support for the local app branch to be further ahead
of the active deployement, including showing this in list-app and
list-runtime commands.
2015-12-18 11:41:07 +01:00
Alexander Larsson 80c6a8b66c ls-remote: Support showing remote commit ids 2015-12-18 11:04:41 +01:00
Alexander Larsson 67de92042b apps: Use "branch", not "version" when talking about app branches 2015-12-17 20:07:14 +01:00
Alexander Larsson 570ba8b55f Add --enable-libxdgapp configure flag and disable lib by default 2015-12-16 15:27:42 +01:00
Alexander Larsson 619adeb74c builder: Add cleanup-command property
This allows you to do some custom cleanup operations
2015-12-16 14:50:05 +01:00
Alexander Larsson 739b5ab6db builder: Support writable-sdk option 2015-12-15 19:36:10 +01:00
Alexander Larsson 1baa77f107 build-init: Allow writable sdk 2015-12-15 19:36:06 +01:00
Alexander Larsson a0885d4576 builder: Allow specifying custom prefix 2015-12-15 19:36:06 +01:00
Alexander Larsson 54c52d9363 builder: Add --keep-build-dirs option
This is useful if you want to later make changes to the built stuff.
2015-12-09 21:10:22 +01:00
Alexander Larsson 6a82dd4ee3 builder: Support specifying revision in bzr sources 2015-12-09 14:06:59 +01:00
Alexander Larsson 3fdfef7e40 builder: Allow optionally specifying remote file sources 2015-12-09 12:01:55 +01:00
Alexander Larsson 6c999147c4 Add XdgAppRemoteRef do docs 2015-12-04 20:22:57 +01:00
Emmanuele Bassi f23090a615 Generate the API reference for libxdg-app
We use the good old gtk-doc.
2015-12-04 15:00:35 +00:00
Alexander Larsson ad7b379398 Add no-enumerate flag to remote and set if for bundle origin remotes 2015-12-04 11:40:51 +01:00