--===============1378714924==
Content-Type: multipart/signed;
  boundary="nextPart3982096.4i1WtNVPjT";
  protocol="application/pgp-signature";
  micalg=pgp-sha1
Content-Transfer-Encoding: 7bit

--nextPart3982096.4i1WtNVPjT
Content-Type: text/plain;
  charset="iso-8859-15"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline

Hi Antonio,

A few comments regarding the what's this messages:

On Sunday 17 October 2004 02:47, Antonio Salazar wrote:
> @@ -44,6 +45,10 @@ KOEditorAttachments::KOEditorAttachments
> =A0 =A0topLayout->setSpacing( spacing );
> =A0
> =A0 =A0mAttachments =3D new QListView( this );
> + =A0QWhatsThis::add( mAttachments,
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 i18n("Displays a list =
of current files that "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 =A0 =A0 =A0"have been =
associated with this event or to-do. "

The attachments are not only about attaching files. It's also about attachi=
ng=20
web pages (URLs), mail messages (kmail's message uid), or contacts, etc.=20
Currently possible types are:
=2D) kmail:XXXXXXXXX  ... reference to a mail in kmail (created by drag and=
 drop=20
of the message to the attachment list or the korganizer icon in kontact)
=2D) mailto:XXX@XXX.TLD ... Link to send a new mail message
=2D) uid:XXXXXX ... reference to a contact in kaddressbook (created by dnd =
on=20
the attachment list or the icon in kontact)
=2D) Any "file" URI, e.g. http://xxxx, ftp://xxxx URLs or local or remote f=
ile=20
pathes.

I guess this list will even grow in the future (after all, it's just one=20
additional if loop in the UriHandler::process method).


> =A0 =A0button =3D new QPushButton( i18n("&Edit..."), this );
> + =A0QWhatsThis::add( button,
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 i18n("Shows the same d=
ialog as the Add button, but "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0"in=
stead of adding an attachment, it modifies "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0"th=
e one currently selected in the list above.") );

Is it really important that the add and edit dialogs are the same?=20


> =A0 =A0// Note that the i18n text below is duplicated in readEvent
> + =A0QString whatsThis =3D i18n("Sets the identity corresponding to "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0=A0=A0=A0=A0=A0=A0 =A0 =
"the organizer of this to-do or event. "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =
=A0 "Identities can be set either in the 'Personal'
> " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =
=A0 "section of the KOrganizer configuration, or
> in the " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=
=A0=A0 =A0 "'Security & Privacy'->'Password & User
> Account' " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=
=A0=A0=A0 =A0 "section of the KDE Control Center.
> If you choose " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=
=A0=A0=A0=A0=A0 =A0 "to set it globally for KDE in
> the Control Center, " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=
=A0=A0=A0=A0=A0=A0=A0 =A0 "be sure to check 'Use
> email settings from " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=
=A0=A0=A0=A0=A0=A0=A0 =A0 "Control Center' in the
> 'Personal' section of the " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=
=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 "KOrganizer
> configuration.");

Actually, the list of organizer values is created from all of the following=
=20
values:
=2D) All identities in KMail
=2D) The identity you set in korganizer's config or in the control center
=2D) All additional email addresses that you enter in korganizer's config
=2D) The "This is me" entry in the addressbook


> + =A0QWhatsThis::add( mListView,
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 i18n("Displays informa=
tion about current attendees. "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 =A0=A0=A0=A0=A0"Clicki=
ng on a column title will sort the list "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0"ac=
cording to that column.") );

How about adding "To edit an attendee, select it in this list, and directly=
=20
modify the values in the widgets below. The RSVP column indicates whether a=
=20
response is requested from the attendee."

> =A0 =A0button =3D new QPushButton( i18n("Reload"), this );
> + =A0QWhatsThis::add( button,
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 i18n("Reloads the Gant=
t chart and the list of attendees
> " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 =A0 =A0 =A0"for this=
 to-do.") );

Actually, this reloads all free/busy data for all attendees from the=20
corresponding servers.


> + =A0QWhatsThis::add( mDescriptionEdit,
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 i18n("Sets the descrip=
tion for this event. This "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0"wi=
ll be displayed in a reminder if one is set, "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0"as=
 well as in a tooltip when you hover over the "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0"ev=
ent and on the event itself it is long enough.")
> );

Nope, the description is never shown on the item itself, only in the toolti=
p=20
or the "show" dialog (which is basically the sameas the reminder).


> + =A0QWhatsThis::add( mAlarmSoundButton,
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 i18n("Sets a sound to =
play in conjunction with the popup
> " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 =A0 =A0 =A0"dialog a=
s a reminder.") );
> =A0 =A0mAlarmSoundButton->setPixmap(KOGlobals::self()->smallIcon("playsou=
nd"));
> =A0 =A0mAlarmSoundButton->setToggleButton(true);
> =A0 =A0QToolTip::add(mAlarmSoundButton, i18n("No sound set"));
> @@ -183,6 +218,9 @@ void KOEditorGeneral::initAlarm(QWidget
> =A0 =A0alarmLayout->addWidget(mAlarmSoundButton);
> =A0
> =A0 =A0mAlarmProgramButton =3D new QPushButton(parent);
> + =A0QWhatsThis::add( mAlarmProgramButton,
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 i18n("Sets a program t=
o execute in conjunction with the
> " +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0"=
popup dialog.") );

Actually, I'm not sure if the popup dialog will be triggered in addition to=
=20
the sound/program, or if just the sound/program will be executed, without t=
he=20
popup dialog. Have you checked this?


> + =A0QWhatsThis::add( mTimeButton,
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 i18n("Sets whether or =
not this to-do has a time "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0"as=
sociated with it.") );

How about "Sets whether or not this to-dos start and due dates also have a=
=20
time associated with it."


> + =A0QString whatsThis =3D i18n("Sets the priority of this to-do on a sca=
le "
> + =A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 =
"from one to nine, with one being the higest "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =
=A0 "priority and nine being the lowest. "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =
=A0 "In programs that have a "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =
=A0 "different scale, the numbers will be adjusted "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =
=A0 "to match the appropriate scale.");

Priority 5 is always understood as "Medium" priority, maybe we should menti=
on=20
this.

> + =A0QWhatsThis::add( combo,
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 i18n("The number of th=
e week from the beginning "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 =A0 =A0 =A0"of this mo=
nth on which this event or to-do "
> +=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 =A0 =A0 =A0 =A0"should rec=
ur.") );

I would use "of the month" instead of "of this month", as the recurrence is=
=20
not restricted to this month.


Cheers, and thanks for the work!
Reinhold

=2D-=20
=2D-----------------------------------------------------------------
Reinhold Kainhofer, Vienna, Austria
email: reinhold@kainhofer.com, http://reinhold.kainhofer.com/
 * Financial and Actuarial Mathematics, TU Wien, http://www.fam.tuwien.ac.at
 * K Desktop Environment, http://www.kde.org/, KOrganizer / KPilot maintain=
er

--nextPart3982096.4i1WtNVPjT
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.5 (GNU/Linux)

iD8DBQBBci7vTqjEwhXvPN0RAjhrAKCku9c8jJ3CmZaKk2xUOkpQfvtnnwCgx6H/
NOn8BQPJGDbL2YJPj7t2nFU=
=fTyF
-----END PGP SIGNATURE-----

--nextPart3982096.4i1WtNVPjT--

--===============1378714924==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
kde-pim mailing list
kde-pim@kde.org
https://mail.kde.org/mailman/listinfo/kde-pim
kde-pim home page at http://pim.kde.org/
--===============1378714924==--