I think this is already documented in the help file, but some new 
paragraph to http://wiki.horde.org/Doc/Dev/LegacyApps probably 
wouldn't hurt either.

That is perfect!  Exactly what I need.  The widget allows me to create 
a "Weekly Agenda" that people can easily print on letter size paper.   
Thanks for the info. and examples.  Would you like this info. added to 
the wiki?
Because I didn't understand the widget, I embedded the portal page 
that shows for a non-authorized user but now I will go back to using 
the widget.

It does. You can select either a single calendar or '__all' as the 
calendar to show all calendars (I plan on tweaking - and improving the 
help text - as mentioned in the previous post). You can also specify 
the time period as well, just pass the same parameter name the block 
uses in the query parameters. The help text for kronolith shows this 
(though I just realized it needs to be updated to reflect the new url 
for ajax imples).

Example upcoming events (monthlist) - show 2 months worth of events, 
but with a max. of 10 events:

<div id="kronolist"></div><!--a75c305b1c0a6022--><script 
src="http://host.example.com/horde/services/imple.php?imple=Embed/impleApp=kronolith/view=monthlist/calendar=calendar_name/container=kronolist/months=2/ maxevents=10" 
type="text/javascript"></script>

or for the summary view (show 7 days worth of events only with alarms 
but only show up to 20 events max):

<div id="kronosummary"> </div><!--a75c305b1c0a6022--><script 
type="text/javascript" 
src="http://hostname.example.com/horde/services/imple.php?imple=Embed/impleApp=kronolith/container=kronosummary/view=summary/calendar=calendar_name/days=7/maxvents=20/alarms=1"></script>



   What I ended up doing
No :) No idea what you are saying here.

I didn't do a great job of explaining it.  The calendar summary in the 
portal is perfect.  You can select your calendars and how many weeks 
to show.  It would be really nice if the summary in the widget worked 
the same way as the one in the portal.  What I ended up doing was 
using http://myserver/horde/services/portal/index.php instead as it 
allowed me to set the calendars to show in 
/horde/config/prefs.local.php.  Does that make sense?  With the widget 
you can't select more than one calendar and you can't set the time 
frame either.  Thanks.

Not without some tweaks to the blocks' _content methods. They assume 
if it's not 'all' then the $calendars value is a single string value.

It's simple enough to fix, but I also wanted to look at changing the 
non-embedded $calendar pref to a multienum to allow this in the portal 
as well.

Why not? Can't you pass the required calendars via multiple calendar[] 
URL parameters?

From what I undeerstood from conversation on the mailing list, it was 
about being able to display multiple calendars in the same embedded 
block. It can currently display either one calendar or all calendars, 
nothing in between.

I don't understand at all what you are requesting.

The calendar summary in the portal page has it all.  You can change 
how many events to show and you see multiple calendars in the summary. 
  Perhaps it might be nice to add another option to day, work week, 
week, month, year like agenda and/or calendar summary.  I have had 
requests for this sort of thing.  The widget with view set to summary 
and multiple calendars would be perfect.  With the latest release we 
split our calendars into two so that some events would show in a 
different colour but now we can't embed them in the webpage and show 
them in a combined calendar summary.  Not a big deal but perhaps it 
might be nice?