[REVIEW] New man page summarising Upstart events

[James Hunt]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi All,

I've put together a new upstart man page which strives to list
"well-known" Upstart events for an Ubuntu system (see attached PDF/troff).

To view the troff directly, pass it through tbl first:

 tbl upstart-events.7 | nroff -man | less


My thoughts:

1) Display Manager

- - If we move to a new DM, can we continue to offer these events?
- - We don't appear to provide the specified events for kdm (kubuntu).
  Is this an oversight?
- - /etc/init/gdm.conf shows "emits starting-dm" which appears to be
  erroneous as it doesn't emit this. Fix is a quick tweak to
  /etc/init/gdm.conf I suspect.
- - I think we may be missing a trick wrt the "desktop-session-start"
  event. If we tweak /etc/gdm/PreSession/Default changing the last
  line from...

     /sbin/initctl -q emit desktop-session-start DISPLAY_MANAGER=gdm

   ...to:

     /sbin/initctl -q emit desktop-session-start DISPLAY_MANAGER=gdm \
       USER=$USER USERNAME=$USERNAME LOGNAME=$LOGNAME

   we get the ability to create jobs that depend on particular users
   logging in! :-)

2) Missing man pages

I believe the rows in the Event column in the first table that are not
in bold denote a comprehensive(?) list of missing upstart-ish man pages.
If so, I'll hack some together for the Natty release.

Note: This man page may need to be revised for Natty as we are
considering introducing some "abstract jobs" to avoid the need to
hard-code specific application names into .conf files. This was
mentioned on as alluded to by Clint on this list recently [1].

[1] https://lists.ubuntu.com/archives/ubuntu-devel/2010-December/032254.html

Kind regards,

James

- --
James Hunt
____________________________________
Ubuntu Foundations Team, Canonical.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAk0sypEACgkQYBWEaHcQG9fbiQCfXKMvBwevd6GqT+N5jbBaFUGB
et4AoIZMjCZWOQU2rB2WLRqof0GsanyM
=Q3op
-----END PGP SIGNATURE-----
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: upstart-events.7
URL: <https://lists.ubuntu.com/archives/upstart-devel/attachments/20110111/652e425f/attachment.ksh>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: upstart-events.pdf
Type: application/pdf
Size: 9638 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/upstart-devel/attachments/20110111/652e425f/attachment.pdf>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: upstart-events.7.sig
Type: application/octet-stream
Size: 72 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/upstart-devel/attachments/20110111/652e425f/attachment.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: upstart-events.pdf.sig
Type: application/octet-stream
Size: 72 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/upstart-devel/attachments/20110111/652e425f/attachment-0001.obj>