[cups.development] notifiers and subscriptions

[Michael Sweet]

Jerome Alet wrote:
> ...
>> We implement the IPP notification spec with additional event
>> names, which are documented in the IPP implementation help file:
>>
>>     http://www.cups.org/documentation.php/spec-ipp.html
> 
> I've read this doccument, but it doesn't contain "notify-recipient"
> so it's hard to guess.

That's because it is a supplement to the normal IPP spec documents,
which *do* talk about notify-recipient...

> I've created a subscription manually, but the Create-Printer-Subscription
> documentation doesn't explain how we are supposed to pass the notify-recipient
> IPP attribute.

It is a URI, just like the device-uri attribute.  The scheme part
specifies the notifier, and the rest is notifier-specific, e.g.:

     mygreatnotifier://send-this-to-jerome

> Also searching for "notify-recipient" with the above URL's search box
> gives nothing at all. Same with http://localhost:631/help/, searching
> for "notify-recipient" gives nothing.
> 
> Is there some additionnal help ?

Until I finish up the new chapters on this stuff for the new CUPS
book, no...  Look for other posts on subscriptions for some sample
code...

> ...
>> I would also recommend reading the links I provided as well as
>> chapter 19 of the current CUPS book, which explains how notifiers
>> work and breaks down the current mailto notifier...
> 
> I'm ok to purchase the CUPS book, but does it really cover this
> aspect of things ?

It covers writing notifiers and the specifics of notification
operations and attributes.  The only thing it doesn't include is
sample code to create subscriptions, etc.

> I ask this because the website indicates "1st edition" and if I look
> for this book at Amazon, it says that this edition dates from 2001,
> at a time where to the best of my knowledge CUPS didn't support notifications.

Correct, but the design work was already in place for CUPS 1.2.  The
main things the book doesn't cover are the new web interface and the
policy stuff.  Everything else is still usable with CUPS 1.2...

> Also if I click on the "purchased" link on www.cups.org/book/index.php
> the price listed on this page and the page we land on is not the same,
> so I think maybe there are 2 different books...

Sorry, we had to bump the price (SAMS lowered our discount...) - the
book is the same...  I'll make sure the cups.org site is updated to
reflect the new pricing on easysw.com.

-- 
______________________________________________________________________
Michael Sweet, Easy Software Products           mike at easysw dot com
Internet Printing and Document Software          http://www.easysw.com