[PATCH weston 02/15] libweston: untangle weston_compositor_remove_output doc

[Pekka Paalanen]

From: Pekka Paalanen <pekka.paalanen at collabora.co.uk>

Trying to make it more readable. Things that happen in the same step are
kept in the same paragraph.

Signed-off-by: Pekka Paalanen <pekka.paalanen at collabora.co.uk>
---
 libweston/compositor.c | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/libweston/compositor.c b/libweston/compositor.c
index 2bca19c..7510fab 100644
--- a/libweston/compositor.c
+++ b/libweston/compositor.c
@@ -4516,18 +4516,26 @@ weston_output_enable_undo(struct weston_output *output)
 	output->enabled = false;
 }
 
-/** Removes output from compositor's output list
+/** Removes output from compositor's live outputs list
  *
  * \param output The weston_output object that is being removed.
  *
- * Presentation feedback is discarded.
- * Compositor is notified that outputs were changed and
- * applies the necessary changes.
- * All views assigned to the weston_output object are
- * moved to a new output.
- * Signal is emitted to notify all users of the weston_output
+ * The following happens:
+ *
+ * - The output assignments of all views in the current scenegraph are
+ * recomputed.
+ *
+ * - Presentation feedback is discarded.
+ *
+ * - Compositor is notified that outputs were changed and
+ * applies the necessary changes to re-layout outputs.
+ *
+ * - Signal is emitted to notify all users of the weston_output
  * object that the output is being destroyed.
- * wl_output protocol objects referencing this weston_output
+ * All views assigned to the weston_output object are
+ * moved to a new output by the shell, if necessary.
+ *
+ * - wl_output protocol objects referencing this weston_output
  * are made inert.
  */
 static void
-- 
2.10.2