Mir

Merge lp:~alan-griffiths/mir/update-docs into lp:mir

Proposed by Alan Griffiths
Status: Merged
Merged at revision: 4276
Proposed branch: lp:~alan-griffiths/mir/update-docs
Merge into: lp:mir
Diff against target: 76 lines (+29/-7)
2 files modified
doc/Doxyfile.in (+9/-5)
doc/mainpage.md (+20/-2)
To merge this branch: bzr merge lp:~alan-griffiths/mir/update-docs
Reviewer Review Type Date Requested Status
Mir CI Bot continuous-integration Needs Fixing
Brandon Schaefer (community) Approve
Review via email: mp+331448@code.launchpad.net

Commit message

Rework to mention snaps and Wayland

To post a comment you must log in.
Revision history for this message
Mir CI Bot (mir-ci-bot) wrote :

PASSED: Continuous integration, rev:4274
https://mir-jenkins.ubuntu.com/job/mir-ci/3701/
Executed test runs:
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-mir/5074
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-0-fetch/5310
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-1-sourcepkg/release=artful/5298
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-1-sourcepkg/release=xenial/5298
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-1-sourcepkg/release=zesty/5298
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=artful/5118
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=artful/5118/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=zesty/5118
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=zesty/5118/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=artful/5118
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=artful/5118/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=xenial/5118
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=xenial/5118/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=zesty/5118
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=zesty/5118/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=artful/5118
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=artful/5118/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=zesty/5118
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=zesty/5118/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=i386,compiler=gcc,platform=mesa,release=xenial/5118
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=i386,compiler=gcc,platform=mesa,release=xenial/5118/artifact/output/*zip*/output.zip

Click here to trigger a rebuild:
https://mir-jenkins.ubuntu.com/job/mir-ci/3701/rebuild

review: Approve (continuous-integration)
Revision history for this message
Mir CI Bot (mir-ci-bot) wrote :

FAILED: Continuous integration, rev:4275
https://mir-jenkins.ubuntu.com/job/mir-ci/3702/
Executed test runs:
    FAILURE: https://mir-jenkins.ubuntu.com/job/build-mir/5076/console
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-0-fetch/5314
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-1-sourcepkg/release=artful/5302
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-1-sourcepkg/release=xenial/5302
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-1-sourcepkg/release=zesty/5302
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=artful/5120
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=artful/5120/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=zesty/5120
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=zesty/5120/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=artful/5120
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=artful/5120/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=xenial/5120
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=xenial/5120/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=zesty/5120
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=zesty/5120/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=artful/5120
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=artful/5120/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=zesty/5120
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=zesty/5120/artifact/output/*zip*/output.zip
    FAILURE: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=i386,compiler=gcc,platform=mesa,release=xenial/5120/console

Click here to trigger a rebuild:
https://mir-jenkins.ubuntu.com/job/mir-ci/3702/rebuild

review: Needs Fixing (continuous-integration)
Revision history for this message
Mir CI Bot (mir-ci-bot) wrote :

PASSED: Continuous integration, rev:4279
https://mir-jenkins.ubuntu.com/job/mir-ci/3703/
Executed test runs:
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-mir/5077
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-0-fetch/5315
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-1-sourcepkg/release=artful/5303
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-1-sourcepkg/release=xenial/5303
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-1-sourcepkg/release=zesty/5303
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=artful/5121
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=artful/5121/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=zesty/5121
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=clang,platform=mesa,release=zesty/5121/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=artful/5121
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=artful/5121/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=xenial/5121
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=xenial/5121/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=zesty/5121
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=amd64,compiler=gcc,platform=mesa,release=zesty/5121/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=artful/5121
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=artful/5121/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=zesty/5121
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=cross-armhf,compiler=gcc,platform=mesa,release=zesty/5121/artifact/output/*zip*/output.zip
    SUCCESS: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=i386,compiler=gcc,platform=mesa,release=xenial/5121
        deb: https://mir-jenkins.ubuntu.com/job/build-2-binpkg-mir/arch=i386,compiler=gcc,platform=mesa,release=xenial/5121/artifact/output/*zip*/output.zip

Click here to trigger a rebuild:
https://mir-jenkins.ubuntu.com/job/mir-ci/3703/rebuild

review: Approve (continuous-integration)
Revision history for this message
Brandon Schaefer (brandontschaefer) wrote :

lgtm

review: Approve
Revision history for this message
Mir CI Bot (mir-ci-bot) wrote :
review: Needs Fixing (continuous-integration)

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
=== modified file 'doc/Doxyfile.in'
--- doc/Doxyfile.in 2017-09-07 09:53:20 +0000
+++ doc/Doxyfile.in 2017-09-28 13:33:53 +0000
@@ -784,7 +784,8 @@
784INPUT = @CMAKE_CURRENT_SOURCE_DIR@/README.md \784INPUT = @CMAKE_CURRENT_SOURCE_DIR@/README.md \
785 @CMAKE_CURRENT_SOURCE_DIR@/HACKING.md \785 @CMAKE_CURRENT_SOURCE_DIR@/HACKING.md \
786 @CMAKE_CURRENT_SOURCE_DIR@/doc \786 @CMAKE_CURRENT_SOURCE_DIR@/doc \
787 @CMAKE_CURRENT_SOURCE_DIR@/examples \787 @CMAKE_CURRENT_SOURCE_DIR@/examples/miral-kiosk \
788 @CMAKE_CURRENT_SOURCE_DIR@/examples/miral-shell \
788 @CMAKE_CURRENT_SOURCE_DIR@/include \789 @CMAKE_CURRENT_SOURCE_DIR@/include \
789 @MIR_GENERATED_INCLUDE_DIRECTORIES_FLATTENED@790 @MIR_GENERATED_INCLUDE_DIRECTORIES_FLATTENED@
790791
@@ -859,7 +860,9 @@
859# Note that relative paths are relative to the directory from which doxygen is860# Note that relative paths are relative to the directory from which doxygen is
860# run.861# run.
861862
862EXCLUDE =863EXCLUDE = @CMAKE_CURRENT_SOURCE_DIR@/include/server \
864 @CMAKE_CURRENT_SOURCE_DIR@/include/platform \
865 @CMAKE_CURRENT_SOURCE_DIR@/include/platforms
863866
864# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or867# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
865# directories that are symbolic links (a Unix file system feature) are excluded868# directories that are symbolic links (a Unix file system feature) are excluded
@@ -876,9 +879,10 @@
876# exclude all test directories for example use the pattern */test/*879# exclude all test directories for example use the pattern */test/*
877880
878EXCLUDE_PATTERNS = *.capnp.c++ \881EXCLUDE_PATTERNS = *.capnp.c++ \
879 @CMAKE_CURRENT_SOURCE_DIR@/include/server/* \882 */detail/* \
880 @CMAKE_CURRENT_SOURCE_DIR@/include/test/mir/* \883 @CMAKE_CURRENT_SOURCE_DIR@/examples/multi_stream.cpp \
881 @CMAKE_CURRENT_SOURCE_DIR@/examples/multi_stream.cpp884 @CMAKE_CURRENT_SOURCE_DIR@/examples/uses_non_client_symbol.cpp \
885 @CMAKE_CURRENT_SOURCE_DIR@/examples/miral-shell/titlebar_config.*
882886
883# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names887# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
884# (namespaces, classes, functions, etc.) that should be excluded from the888# (namespaces, classes, functions, etc.) that should be excluded from the
885889
=== modified file 'doc/mainpage.md'
--- doc/mainpage.md 2017-09-08 13:26:03 +0000
+++ doc/mainpage.md 2017-09-28 13:33:53 +0000
@@ -5,14 +5,32 @@
5window server system to unlock next-generation user experiences for devices5window server system to unlock next-generation user experiences for devices
6ranging from Linux desktop to mobile and IoT devices powered by Ubuntu.6ranging from Linux desktop to mobile and IoT devices powered by Ubuntu.
77
8 - If you just want to try out the Mir demos, see: \ref getting_and_using_mir8 - If you want to use the Mir snaps, see:
9 [Run a kiosk snap on Ubuntu Core](https://developer.ubuntu.com/core/examples/snaps-on-mir)
10
11 - If you want to try out the Mir demos on desktop, see: \ref getting_and_using_mir
912
10 - If you want to get involved in Mir development, see: \ref getting_involved_in_mir13 - If you want to get involved in Mir development, see: \ref getting_involved_in_mir
1114
12Using Mir for client development15Using Mir for client development
13--------------------------------16--------------------------------
1417
15Install the headers and libraries for using libmirclient in development:18This is usually something you don't need to do explicitly, it is normally
19handled by a GUI toolkit (or library).
20
21A toolkit can run on Mir in three ways: using Wayland protocols, using the Mir
22client API or using X11 translation by the Xmir server.
23
24 - Qt, has "wayland" and "mir" plugins that can be selected by setting
25 the QT_QPA_PLATFORM environment variable to "wayland" or "ubuntumirclient"
26 respectively.
27
28 - SDL can be built with "wayland" and "mir" support and these options selected
29 by setting the SDL_VIDEODRIVER environment variable to "wayland" or "mir".
30
31If want to use the Mir client library directly (e.g. you are working on "mir"
32support for a toolkit or library) Install the headers and libraries for using
33libmirclient in development:
1634
17 $ sudo apt install libmirclient-dev35 $ sudo apt install libmirclient-dev
1836

Subscribers

People subscribed via source and target branches