English wording proof-reading?

[David Hampton]

On Fri, 2007-01-19 at 14:22 +0100, Christian Stimming wrote:

> I'd like to improve the wording of UI texts in the HBCI/aqbanking module
> of GnuCash (trunk). A bunch of strings need to be modified anyway
> because the module supports not only HBCI but also OFX Direct Connect
> and other online banking techniques, as implemented in the aqbanking
> library.
> 
> Could I get some feedback about the wording in the attached patch? If I
> change those strings anyway, it would be better to remove bad wordings
> as well :-)

Here are a couple of proposed changes.

David




> @@ -612,13 +612,12 @@
>        printf("on_aqhbci_button: Oops, aqhbci wizard return nonzero value: %d. The called program was \"%s\".\n", res, wizard_path);
>        gnc_error_dialog
>  	(info->window,
> -       /* Each of the %s is the name of the backend, e.g. "aqhbci". */
> -	 _("The external program \"%s Setup Wizard\" returned a nonzero "
> -	   "exit code which means it has not been finished successfully. "
> -	   "The further HBCI setup can only be finished if the %s "
> -	   "Setup Wizard is run successfully. Please try to start and "
> -	   "successfully finish the %s Setup Wizard program again."),
> -	 backend_name, backend_name, backend_name);
> +	 _("The external program \"AqBanking Setup Wizard\" returned a "
> +	   "nonzero exit code which means it has not been finished "
> +	   "successfully.  The further Online Banking setup can only "
> +	   "be finished if the AqBanking Setup Wizard is run successfully. "
> +	   "Please try to start and successfully finish the AqBanking "
> +	   "Setup Wizard program again."));

A 'nonzero exit code' is programmer speak.  How about this:

        The external program "AqBanking Setup Wizard" returned an
        indication that it failed to create <something>.  Any further
        Online Banking setup can only be performed if the AqBanking
        Setup Wizard is run successfully.  Please try running the
        AqBanking Setup Wizard again.

>        druid_disable_next_button(info);
>      }
>    } else {
> @@ -626,10 +625,10 @@
>      gnc_error_dialog
>        (info->window,
>         /* Each of the %s is the name of the backend, e.g. "aqhbci". */
> -       _("The external program \"%s Setup Wizard\" has not been found. \n\n"
> +       _("The external program \"AqBanking Setup Wizard\" has not "
> +	 "been found. \n\n"
>  	 "The package aqbanking is supposed to install the program "
> -	 "\"%s-qt3-wizard\". Please check your installation of aqbanking."),
> -       backend_name, backend_name);
> +	 "\"qt3-wizard\". Please check your installation of aqbanking."));

        The aqbanking package should include the program "%
        s-qt3-wizard". Please check your installation to ensure this
        program is present.

Maybe add:

        On some distributions this may require installing additional
        packages.

> @@ -31,21 +31,21 @@
>  	<widget class="GnomeDruidPageEdge" id="druidpagestart1">
>  	  <property name="visible">True</property>
>  	  <property name="position">GNOME_EDGE_START</property>
> -	  <property name="title" translatable="yes">Initial HBCI Setup</property>
> -	  <property name="text" translatable="yes">This druid helps you setting up your HBCI connection with your bank.
> +	  <property name="title" translatable="yes">Initial Online Banking Setup</property>
> +	  <property name="text" translatable="yes">This druid helps you setting up your Online Banking connection with your bank.
>  
> -You first need to apply for HBCI access at your bank. If your bank  decides to grant you HBCI access, the bank will send you a letter,  containing 
> +You first need to apply for Online Banking access at your bank. If your bank  decides to grant you Online Banking access, the bank will send you a letter,  containing 

You first need to apply for Online Banking access at your bank. If your
bank decides to grant you electronic access, they will send you a letter
containing 

>  
>  * The bank code of your bank
>  * The user ID that identifies you to your bank
> -* The Internet address of your bank's HBCI server
> -* Information about the cryptographic public key of your bank (&quot;Ini-Letter&quot;).
> +* The Internet address of your bank's Online Banking server
> +* For HBCI Online Banking, information about the cryptographic public key of your bank (&quot;Ini-Letter&quot;).
>  
>  This information will be needed in the following. Press &quot;Forward&quot; now.
>  
> -NOTE: NO WARRANTIES FOR ANYTHING. Some banks are running a poorly implemented HBCI. You should not rely on time-critical transfers through HBCI, since sometimes your bank does not give you correct feedback when a transfer has been rejected.
> +NOTE: NO WARRANTIES FOR ANYTHING. Some banks are running a poorly implemented Online Banking. You should not rely on time-critical transfers through Online Banking, since sometimes your bank does not give you correct feedback when a transfer has been rejected.

NOTE: NO WARRANTIES FOR ANYTHING. Some banks run a poorly implemented
Online Banking server. You should not rely on time-critical transfers
through Online Banking, because sometimes the bank does not give you
correct feedback when a transfer is rejected.

> @@ -253,10 +253,10 @@
>  	<widget class="GnomeDruidPageEdge" id="initial_finish_page">
>  	  <property name="visible">True</property>
>  	  <property name="position">GNOME_EDGE_FINISH</property>
> -	  <property name="title" translatable="yes">HBCI Setup Finished</property>
> -	  <property name="text" translatable="yes">Now the setup for all HBCI accounts that are matching to a GnuCash account is finished. You can now invoke HBCI actions on those accounts.
> +	  <property name="title" translatable="yes">Online Banking Setup Finished</property>
> +	  <property name="text" translatable="yes">Now the setup for all Online Banking accounts that are matching to a GnuCash account is finished. You can now invoke Online Banking actions on those accounts.

The setup for matching Online Banking accounts to GnuCash account is now
finished. You can now invoke Online Banking actions on those accounts.