doc: document/register the "start on" events

[At Santos]

it is not clear what are the "start on" events.

I had to search to find:
start on local-filesystems
found on:
http://www.linuxplanet.com/linuxplanet/tutorials/7033/1/

I believe something as fundamental as "start on local-filesystems" should be documented somewhere in the core documentation.
(and "man upstart" tells you almost nothing)

I think to help with this, when someone writes a new package which provides new events for upstart, they should submit the new event to the upstart development group. The new event would then get added to a registry of upstart events.
This is kind of how IANA does it - and then the list of allowed values for any parameter is published.
For example, http://www.iana.org/assignments/http-parameters/http-parameters.xhtml

[Scott James Remnant (scott)]

(Sorry, hit the wrong status).

Btw, did you try "man local-filesystems" ? There is actually a man page for most core events, but no single man page linking them together yet - though James has been working on just that.

I don't agree with the IANA approach though

[James Hunt (jamesodhunt)]

Upstart on Ubuntu (Natty) now includes a "well-known events" manual page:

  man 7 upstart-events

Note that it is not in the Upstream version of Upstart since it contains Ubuntu-specifics. If you are not running Natty, you can find the man page here:

    http://people.canonical.com/~jhunt/upstart/man/upstart-events.7

Having downloaded it, view it like this:

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

Alternatively, I've created a PDF version (doesn't render very nicely, but the content is there):

    http://people.canonical.com/~jhunt/upstart/man/upstart-events.pdf

[Scott James Remnant (scott)]

James, STOP changing the status of upstream bug tasks to represent the status in Ubuntu.