Commit Graph

237 Commits

Author SHA1 Message Date
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
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