After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 543883 - user docs issues
user docs issues
Status: RESOLVED OBSOLETE
Product: evolution
Classification: Applications
Component: User Documentation
2.24.x (obsolete)
Other Linux
: Normal normal
: ---
Assigned To: evolution-user-docs
Evolution QA team
Depends on:
Blocks:
 
 
Reported: 2008-07-20 16:21 UTC by André Klapper
Modified: 2011-08-24 13:47 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Amendments to Evolution help documentation (4.77 KB, patch)
2008-07-21 20:06 UTC, Allan Day
committed Details | Review

Description André Klapper 2008-07-20 16:21:55 UTC
Remaining issues copied from bug 438479 which I just closed.


#: evolution.xml:325(para) 
msgid "Select to use a secure (SSL) connection."
msgstr ""

#: evolution.xml:326(para) 
msgid "If your server supports secure connections, you should enable this
security option. If you are unsure if your server supports a secure connection,
contact your system administrator."
msgstr ""


TLS is not explained at all.




#: evolution.xml:319(para) 
msgid "If you don't know the Server, contact your administrator."

#: evolution.xml:326(para) 
msgid "If your server supports secure connections, you should enable this
security option. If you are unsure if your server supports a secure connection,
contact your system administrator."

#: evolution.xml:332(para) 
msgid "If you are unsure what authentication type you need, contact your system
administrator."

that's so lame. i don't have an administrator here. i always felt fooled when i
got that "you're too dumb, ask your non-existing admin" pop-up under windows.
please mention the ISP.




#: evolution.xml:6461(glossterm) 
msgid "switcher"

ca, c'est merde! how can one translate this? it's never used in the UI. the
glossary entry also does not mean anything. bad.








#: evolution.xml:451(para) 
msgid "Select apply filters to new messages in inbox on this server to apply
filters."

#: evolution.xml:454(para) 
msgid "Select check new messages for junk contents to filter new mails for spam
mails."

souldn't that be something like this?:

msgid "Select »Apply filters to new messages in INBOX on this server« to
apply filters."








 Comment #54 from Andre Klapper    (reporter, points: 28)
2007-05-16 01:48 UTC [reply]

#: evolution.xml:515(para) 
msgid "Select if you want to leave messages on the server."
msgstr "Wählen Sie, ob die Nachrichten auf dem Server belassen werden sollen."

#: evolution.xml:518(para) 
msgid "Select if you want to disable support for all POP3 extensions (support
for POP3)."


isn't this total bullshit buzzword crap, as if the user was too stupid to read,
so i just tell him the same thing twice? repeating the exact same wording over
and over again this nothing to do with "Help", nothing.
instead, explain what it means. what are POP3 extensions at all?










the "Include Threads" feature in the advanced search is not listed in the help
file








ah well... that sentence does not make sense to me:
"The compressed columns have Sender Name and Email, Attachment Icon, Date and
Subject in the second line"
what is in the first line then? aren't we talking about rows instead of columns
here?






#: evolution.xml:1154(para) 
msgid "To set your proxy in KDE:"

#: evolution.xml:1157(para) 
msgid "Click the menu icon > System > Configuration > Yast."

sounds very Novell-/SuSE-specific and should be change to the default GNOME.





#: evolution.xml:1457(para) 
msgid "The icons in the toolbar are explained in <link
linkend=\"tooltip\">tool-tips</link>, which appear when you hold your mouse
pointer over the buttons. The buttons fall into five categories:"
#: evolution.xml:1459(title) 
msgid "Headers and Lists:"
#: evolution.xml:1460(para) 
msgid "At the left edge of the toolbar, you can choose Normal for a default
text style or Header 1 through Header 6 for varying sizes of header from large
(1) to tiny (6). Other styles include preformat, to use the HTML tag for
preformatted blocks of text, and three types of bullet points for lists."

at the left edge, there is the font size, and not header and lists. this is
wrong.







you're mixing "tab" and "window" all the time, e.g. with regard to the default
tab, it's often called default window. this is confusing. please use tab
whenever you talk about a tab.






#: evolution.xml:3494(para) 
msgid "Click Calendars on the Switcher, then click New &gt; Appointment."

i don't get that one. don't we talk about the calendar view itself?
or the tool bar? tool bar i guess. the right-click option (the 4th one) is also missing here.






#: evolution.xml:440(para) 
msgid "Select if you want to limit the number of Global Address Lists (GAL)."

but in the UI, it is:
#: ../camel/camel-exchange-provider.c:61
msgid "_Limit number of GAL responses: %s"

so is this a limit of the number of emails one gets back from ONE GAL, or is
this a limit for the number of GALs themselves? i guess the first one?






when you refer to contacts/mail/tasks/memos/calendar, you sometimes talk about
components, sometimes about tools, and sometimes about windows.
the UI states that these are "windows".
please don't confuse the user.





#: evolution.xml:889(bridgehead) 
msgid "Month Pane"
#: evolution.xml:890(para) 
msgid "The month pane is a small view of a calendar month.


argh... you called that also "little calendar" and "mini calendar" in the docs.
please stick to the same terms.

#: evolution.xml:3396(para) 
msgid "You can also select an arbitrary range of days in the small calendar
just above the switcher at the left. To do this, select the days that you want
to view in your calendar."

clarify this also here:
#: evolution.xml:5843(para) 
msgid "Shows the week numbers next to the respective weeks in the calendar."








#: evolution.xml:5911(title) 
msgid "Creating a Contact"
#: evolution.xml:5912(para) 
msgid "To add a new contact list, either local or remote:"
#: evolution.xml:5915(para) 
msgid "Click Contacts."
#: evolution.xml:5918(para) 
msgid "Click the down-arrow next to New."
#: evolution.xml:5921(para) 
msgid "Select Contact List."
#: evolution.xml:5924(para) 
msgid "Type a name and location for the Address Book."


so you talk about contacts, contact lists, and address books in the same
paragraph, and i have no clue at all how to translate this properly. messy.










#: evolution.xml:6305(glossterm) 
msgid "automatic indexing"

#: evolution.xml:6307(para) 
msgid "A pre-downloading procedure that allows Novell&reg; Evolution&trade; to
quickly refer to data. It enables faster searches and decreases memory usage
for data displays."

WTF? this sounds like total marketing buzzword crap.
what is a "pre-downloading procedure"? what exactly does "refer" here mean?
what are "data displays"? sigh.








#: evolution.xml:1804(para) 
msgid "When you send a message that is encrypted, you must encrypt it using
your intended recipient's public key. To receive an encrypted message, you must
make sure that the sender has your public key in advance. For signing messages,
you encrypt the signature with your private key, so only your public key can
unlock it. When you send the message, the recipient gets your public key and
unlocks the signature, verifying your identity."

no, when i send a signed message the recipient does not automatically get my
public key. he has to have it in advance, this is wrong.




#: evolution.xml:2115(para) 
msgid "For POP mail, filters are applied as messages are downloaded. For IMAP
mail, filters are applied to new messages when you open the Inbox folder. On
Exchange servers, filters are not applied until you select your Inbox folder
and click Message &gt; Apply Filters, or press Ctrl+Y. To force your filters to
act on all messages in the folder, select the entire folder by pressing Ctrl+A,
then apply the filters by pressing Ctrl+Y."


this is at the end of the "Importing Multiple Files" section, I have no idea
why. probably it's wrong here.





right-click vs right click. everywhere :-)
double click vs double click.





VCF and vCard and VCard are used.






#: evolution.xml:3199(para) 
msgid "Open the list creation dialog box by clicking the New List button."

where is that?







#: evolution.xml:4128(para) evolution.xml:5041(para) 
msgid "In the Start Date field, type the date this reminder note should appear
in the recipients&rsquo; Calendars."

memos do not have recipients, this cannot correctly be translated.





#: evolution.xml:3617(para) 
msgid "If you are using a Novell GroupWise or Microsoft Exchange server, other
people on the server can check your schedule to see if you are available at any
given time. If you have an appointment that is flexible or that you want to
designate as Free rather than Busy time, select the Free box in the Show Time
As section. Normally, appointments display as Busy."

where is that section? isn't that "Options > Show time as busy" in the menu
bar?





#: evolution.xml:3724(para) 
msgid "A meeting can have only one organizer, and only the organizer can add
participants. You can designate yourself the organizer of the meeting, but if
you are not the original organizer, you can create confusion in the scheduling
process. If you want to invite additional people to a meeting without changing
the organizer, it is best to forward the first organizer's message to the
additional participants."

what does "designate" here **exactly** mean? please reword.






#: evolution.xml:3769(para) 
msgid "Adjust the meeting time, either by dragging the meeting borders or by
using the Autopick buttons to choose a time automatically, then click Save and
Close. Attendees on an Exchange server have the appointment updated
automatically; others receive e-mail notification of any change in plans."

buttons? i can only see one. there are two other buttons, "<<" and ">>", but
they are not mentioned at all in the docs, so i won't touch them. ;-)





msgid "You can change the default settings of your send items. Click Advanced
Send Options to prioritise, classify your send messages. You can also set the
date for reply request so that recipient will know the immediacy and can
accordingly response to your message . Enable status tracking and set Return
Notification for Mail, Calendar and Task."

where? where is "Advanced Send Options"? i have no idea what you talk about.





#: evolution.xml:5519(para) 
msgid "Previous versions of Evolution included directory servers, folder
settings, and Exchange delegation in the settings tool. Directory servers can
now be set up as contacts groups in the Contacts tool, you can change folder
settings in the folder right-click menu, and Exchange delegation is available
in the Message Menu of the Exchange tool."

an exchange "tool" ("window" in the UI?) does not exist anymore. please
correct.
Comment 1 Allan Day 2008-07-20 21:57:48 UTC
I'm confirming this.

Andre: if you need the help, and can point me in the direction of the right evolution.xml file, I'll have a go at clearing these up.
Comment 2 André Klapper 2008-07-20 22:27:49 UTC
I had a huge cleanup today while watching Tour de France and fixed around 200 bugs. This is all that is left.
The Evolution user docs have always been in a bad state (with regard to spelling and grammar) since 2.0, for the ones I have listed here I've either been too lazy or didn't get it. I regularly rant on this topic. :-)

The code is in svn, see http://svn.gnome.org/viewvc/evolution/trunk/help/C/evolution.xml for a quick look. If you want to check out the code from svn and work on it, see http://live.gnome.org/SubversionFAQ for more information.
Comment 3 Allan Day 2008-07-21 20:06:57 UTC
Created attachment 114947 [details] [review]
Amendments to Evolution help documentation

Here's a patch which sorts out some of these issues. I'm not sure whether I've got all of them quite right, and there's more work to do, but it's a start.
Comment 4 André Klapper 2008-07-21 21:05:08 UTC
Rocks! Thanks, these are sentences that I (being a normal user) understand!
Comment 5 André Klapper 2008-07-21 21:17:46 UTC
patch committed with one change (mention both free webmail providers and sysadmins):
http://svn.gnome.org/viewvc/evolution?view=revision&revision=35815
Comment 6 Allan Day 2008-07-21 21:24:19 UTC
These are the remaining issues that didn't get patched:


#: evolution.xml:325(para) 
msgid "Select to use a secure (SSL) connection."
msgstr ""

#: evolution.xml:326(para) 
msgid "If your server supports secure connections, you should enable this
security option. If you are unsure if your server supports a secure connection,
contact your system administrator."
msgstr ""


TLS is not explained at all.



#: evolution.xml:6461(glossterm) 
msgid "switcher"

ca, c'est merde! how can one translate this? it's never used in the UI. the
glossary entry also does not mean anything. bad.



#: evolution.xml:451(para) 
msgid "Select apply filters to new messages in inbox on this server to apply
filters."

#: evolution.xml:454(para) 
msgid "Select check new messages for junk contents to filter new mails for spam
mails."

souldn't that be something like this?:

msgid "Select »Apply filters to new messages in INBOX on this server« to
apply filters."








 Comment #54 from Andre Klapper    (reporter, points: 28)
2007-05-16 01:48 UTC [reply]

#: evolution.xml:515(para) 
msgid "Select if you want to leave messages on the server."
msgstr "Wählen Sie, ob die Nachrichten auf dem Server belassen werden sollen."

#: evolution.xml:518(para) 
msgid "Select if you want to disable support for all POP3 extensions (support
for POP3)."


isn't this total bullshit buzzword crap, as if the user was too stupid to read,
so i just tell him the same thing twice? repeating the exact same wording over
and over again this nothing to do with "Help", nothing.
instead, explain what it means. what are POP3 extensions at all?






the "Include Threads" feature in the advanced search is not listed in the help
file





ah well... that sentence does not make sense to me:
"The compressed columns have Sender Name and Email, Attachment Icon, Date and
Subject in the second line"
what is in the first line then? aren't we talking about rows instead of columns
here?




#: evolution.xml:1154(para) 
msgid "To set your proxy in KDE:"

#: evolution.xml:1157(para) 
msgid "Click the menu icon &gt; System &gt; Configuration &gt; Yast."

sounds very Novell-/SuSE-specific and should be change to the default GNOME.





#: evolution.xml:1457(para) 
msgid "The icons in the toolbar are explained in <link
linkend=\"tooltip\">tool-tips</link>, which appear when you hold your mouse
pointer over the buttons. The buttons fall into five categories:"
#: evolution.xml:1459(title) 
msgid "Headers and Lists:"
#: evolution.xml:1460(para) 
msgid "At the left edge of the toolbar, you can choose Normal for a default
text style or Header 1 through Header 6 for varying sizes of header from large
(1) to tiny (6). Other styles include preformat, to use the HTML tag for
preformatted blocks of text, and three types of bullet points for lists."

at the left edge, there is the font size, and not header and lists. this is
wrong.





you're mixing "tab" and "window" all the time, e.g. with regard to the default
tab, it's often called default window. this is confusing. please use tab
whenever you talk about a tab.






#: evolution.xml:3494(para) 
msgid "Click Calendars on the Switcher, then click New &gt; Appointment."

i don't get that one. don't we talk about the calendar view itself?
or the tool bar? tool bar i guess. the right-click option (the 4th one) is also
missing here.






#: evolution.xml:440(para) 
msgid "Select if you want to limit the number of Global Address Lists (GAL)."

but in the UI, it is:
#: ../camel/camel-exchange-provider.c:61
msgid "_Limit number of GAL responses: %s"

so is this a limit of the number of emails one gets back from ONE GAL, or is
this a limit for the number of GALs themselves? i guess the first one?






when you refer to contacts/mail/tasks/memos/calendar, you sometimes talk about
components, sometimes about tools, and sometimes about windows.
the UI states that these are "windows".
please don't confuse the user.





#: evolution.xml:889(bridgehead) 
msgid "Month Pane"
#: evolution.xml:890(para) 
msgid "The month pane is a small view of a calendar month.


argh... you called that also "little calendar" and "mini calendar" in the docs.
please stick to the same terms.

#: evolution.xml:3396(para) 
msgid "You can also select an arbitrary range of days in the small calendar
just above the switcher at the left. To do this, select the days that you want
to view in your calendar."

clarify this also here:
#: evolution.xml:5843(para) 
msgid "Shows the week numbers next to the respective weeks in the calendar."








#: evolution.xml:5911(title) 
msgid "Creating a Contact"
#: evolution.xml:5912(para) 
msgid "To add a new contact list, either local or remote:"
#: evolution.xml:5915(para) 
msgid "Click Contacts."
#: evolution.xml:5918(para) 
msgid "Click the down-arrow next to New."
#: evolution.xml:5921(para) 
msgid "Select Contact List."
#: evolution.xml:5924(para) 
msgid "Type a name and location for the Address Book."


so you talk about contacts, contact lists, and address books in the same
paragraph, and i have no clue at all how to translate this properly. messy.






#: evolution.xml:2115(para) 
msgid "For POP mail, filters are applied as messages are downloaded. For IMAP
mail, filters are applied to new messages when you open the Inbox folder. On
Exchange servers, filters are not applied until you select your Inbox folder
and click Message &gt; Apply Filters, or press Ctrl+Y. To force your filters to
act on all messages in the folder, select the entire folder by pressing Ctrl+A,
then apply the filters by pressing Ctrl+Y."


this is at the end of the "Importing Multiple Files" section, I have no idea
why. probably it's wrong here.





right-click vs right click. everywhere :-)
double click vs double click.





VCF and vCard and VCard are used.






#: evolution.xml:3199(para) 
msgid "Open the list creation dialog box by clicking the New List button."

where is that?







#: evolution.xml:4128(para) evolution.xml:5041(para) 
msgid "In the Start Date field, type the date this reminder note should appear
in the recipients&rsquo; Calendars."

memos do not have recipients, this cannot correctly be translated.





#: evolution.xml:3617(para) 
msgid "If you are using a Novell GroupWise or Microsoft Exchange server, other
people on the server can check your schedule to see if you are available at any
given time. If you have an appointment that is flexible or that you want to
designate as Free rather than Busy time, select the Free box in the Show Time
As section. Normally, appointments display as Busy."

where is that section? isn't that "Options > Show time as busy" in the menu
bar?







#: evolution.xml:3769(para) 
msgid "Adjust the meeting time, either by dragging the meeting borders or by
using the Autopick buttons to choose a time automatically, then click Save and
Close. Attendees on an Exchange server have the appointment updated
automatically; others receive e-mail notification of any change in plans."

buttons? i can only see one. there are two other buttons, "<<" and ">>", but
they are not mentioned at all in the docs, so i won't touch them. ;-)





msgid "You can change the default settings of your send items. Click Advanced
Send Options to prioritise, classify your send messages. You can also set the
date for reply request so that recipient will know the immediacy and can
accordingly response to your message . Enable status tracking and set Return
Notification for Mail, Calendar and Task."

where? where is "Advanced Send Options"? i have no idea what you talk about.





#: evolution.xml:5519(para) 
msgid "Previous versions of Evolution included directory servers, folder
settings, and Exchange delegation in the settings tool. Directory servers can
now be set up as contacts groups in the Contacts tool, you can change folder
settings in the folder right-click menu, and Exchange delegation is available
in the Message Menu of the Exchange tool."

an exchange "tool" ("window" in the UI?) does not exist anymore. please
correct.
Comment 7 André Klapper 2011-08-24 13:47:43 UTC
I am closing this as OBSOLETE we killed the traditional user manual in favor of
a topic-based, Mallard formatted one in Evolution version 3.1.5/3.1.90.