Commit Graph

250 Commits (9c57a5751ee5c0403700c9da0d35ba56b08c1995)

Author SHA1 Message Date
Matthias Clasen e8599bb869 Clarify flatpak update docs
NAME is optional.
2016-08-04 18:40:09 -04:00
Matthias Clasen 414cd0afce Document --appstream option
This option of flatpak update was undocumented.
2016-08-04 14:08:09 -04:00
matthiasclasen 4cce620585 Merge pull request #219 from mwleeds/allow-git-paths
builder: Allow git sources to be specified as paths
2016-08-03 09:45:11 -04:00
Simon McVittie 4dd59eeecb docs: include sub-documents from $(srcdir)
This fixes "make distcheck".

Signed-off-by: Simon McVittie <smcv@debian.org>
2016-08-01 11:15:07 +01:00
Simon McVittie 6ec373a1f6 Distribute flatpak-metadata.xml in tarball releases
This was missing from 0.6.8, causing a build with xmlto available
to fail.

Signed-off-by: Simon McVittie <smcv@debian.org>
2016-08-01 11:09:07 +01:00
Alexander Larsson 07b342a937 Properly make clean the docs 2016-07-31 00:11:31 +02:00
Matthew Leeds 25d88477c5 builder: Allow git sources to be specified as paths
Currently to use a local copy of a git repo you have to specify the url
as "file:///path/to/repo". This commit allows you to specify a path directly
as "/path/to/repo", which is faster and more space-efficient because
git-clone will hardlink the objects rather than copying them.
2016-07-29 16:01:30 -04:00
Alexander Larsson 003ef9ee2e Revert "Set up logging to the journal" 2016-07-29 00:24:43 +02:00
Matthias Clasen 003d96e3df Add an --arch option to flatpak list
This enables filtering by arch when listing installations.
2016-07-26 13:39:57 -04:00
Matthias Clasen 6e0d8e394e Document the new option 2016-07-25 10:36:00 -04:00
matthiasclasen 5216540b7b Merge pull request #205 from mwleeds/fix-typos
doc/flatpak-builder: Fix typos
2016-07-23 15:17:28 -04:00
Matthew Leeds 783f8ba1fe doc/flatpak-builder: Fix typos 2016-07-22 15:05:15 -04:00
Matthew Leeds 90bd06304a docs: Clarify which options can be used multiple times
Some of the options do not explicitly say they can be used multiple
times even though it's clear from the code that they can. This commit
fixes that by saying so in the manpages.
2016-07-22 13:32:45 -04:00
Matthew Leeds 60fb5ec03a doc/flatpak-install: Fix duplicate option 2016-07-15 11:04:34 -04:00
Matthias Clasen bf96dd248f Build html documentation from the man pages
This will be useful for putting the docs online.
2016-07-12 00:41:13 -04:00
Alexander Larsson 92ab585e6f Merge pull request #171 from mariospr/no-desktop
flatpak-run: Add a new --no-desktop option to prevent creation of cgroups
2016-07-02 00:05:30 +02:00
Mario Sanchez Prada 8c8b91609c flatpak-run: Add a new --no-desktop option to prevent creation of cgroups
This is not intented for normal use, but it can be useful in cases where
we don't have a running session and sandboxing is not strictly required.
2016-07-01 22:12:04 +01:00
Alexander Larsson de7445b0b5 doc/flatpak-metadata: Add some extra clarifications 2016-07-01 11:23:38 +02:00
Matthias Clasen a1ef27cafb Document the metadata format
This is useful information that should be available in a
single place.
2016-06-30 20:16:48 -04:00
Alexander Larsson 5ab628d0ee Install/update/uninstall related refs
Any "related" references from the same remote are automatically
handled when installing, unless you specify --no-related.

The set of related refs is based on the declared extensions for
the main ref. By default, all such extensions are automatically
installed/updated unless they have "no-autodownload" set to false
in the extension info, and its not already installed locally.

Only extensions marked as "autodelete" will be automatically deleted
when you remove the main ref.

There is some special handling:

Any *.Debug or *.Locale extension is automatically treated as "autodelete".

A *.Locale extension that is autodownloaded will be subsetted using subpaths
such that existing subpaths are kept, and the current locale is added.
2016-06-30 16:55:32 +02:00
Alexander Larsson de8d8a36c2 Merge pull request #158 from hadess/wip/use-git-patch
Add "use-git" option for patch source types
2016-06-28 15:24:49 +02:00
Alexander Larsson 7070dbf96c Make journal always available in the sandbox
I don't think it makes sense to have to enable this for everything.
It should be safe in the sense that you can't ever do more than
the user can do anyway, and there is no way to use this to communicate
with the rest of the system because you can't read from it.
The worst this could ever cause is to overload the system, but the
sandbox doesn't protect against that in any other way anyway.
2016-06-28 15:05:01 +02:00
Bastien Nocera c646f386eb builder: Add "use-git" option for patch source type
Closes #6
2016-06-28 14:24:16 +02:00
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