From kde-i18n-doc Sun Jul 28 18:46:54 2013 From: Andreas Cord-Landwehr Date: Sun, 28 Jul 2013 18:46:54 +0000 To: kde-i18n-doc Subject: Re: ROCScore translation question Message-Id: <3218388.8OT9hlLaaK () sooner> X-MARC-Message: https://marc.info/?l=kde-i18n-doc&m=137503751512530 MIME-Version: 1 Content-Type: multipart/mixed; boundary="--nextPart1744037.qxjbOhhblh" This is a multi-part message in MIME format. --nextPart1744037.qxjbOhhblh Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" On Sunday 28 July 2013 20:05:29 Orestes Mas wrote: > Hi, > > in rocscore.po are some strings starting with "Return list all..." (for > instance: "Return list all nodes in the graph."). To my knowledge (I'm not > an english native speaker) this means that hitting the return key will list > all nodes in the graph, but I suspect this interpretation is wrong, because > the given context for these strngs says that they are "Scripting API > description", so "return" sounds more as a return value of a function than > a return key, but in the former case the english sentence isn't well > formed, is it? > > Can someone please clarify me the exact meaning of these strings? > > Note that there are also similar strings but with clearer meaning, as > "Return a list of all edges (incoming and outgoing) of this node.". I've no > problem translating these other strings. Hi Orestes, the "Scripting API description" context is used for all strings that are used in Rocs' in-program programming help that explains the user how to write algorithms for the Rocs graph simulator. You can essentially think of this as the documenation of JavaScript objects/functions that the user can modify in the program at runtime (e.g. what properties of a pointer between two nodes can be accessed, how to compute a shortest path...) With respect to the string you are asking about: the string explains what the return value the "nodes()" function of a graph object is. And you are right, it should be phrased "Return a list of all nodes in the graph.". Thanks for bringing this up! Andreas --nextPart1744037.qxjbOhhblh Content-Transfer-Encoding: 7Bit Content-Type: text/html; charset="us-ascii"

On Sunday 28 July 2013 20:05:29 Orestes Mas wrote:

> Hi,

> in rocscore.po are some strings starting with "Return list all..." (for

> instance: "Return list all nodes in the graph."). To my knowledge (I'm not

> an english native speaker) this means that hitting the return key will list

> all nodes in the graph, but I suspect this interpretation is wrong, because

> the given context for these strngs says that they are "Scripting API

> description", so "return" sounds more as a return value of a function than

> a return key, but in the former case the english sentence isn't well

> formed, is it?

> Can someone please clarify me the exact meaning of these strings?

> Note that there are also similar strings but with clearer meaning, as

> "Return a list of all edges (incoming and outgoing) of this node.". I've no

> problem translating these other strings.

Hi Orestes, the "Scripting API description" context is used for all strings that are used in Rocs' in-program programming help that explains the user how to write algorithms for the Rocs graph simulator. You can essentially think of this as the documenation of JavaScript objects/functions that the user can modify in the program at runtime (e.g. what properties of a pointer between two nodes can be accessed, how to compute a shortest path...)

With respect to the string you are asking about: the string explains what the return value the "nodes()" function of a graph object is. And you are right, it should be phrased "Return a list of all nodes in the graph.".

Thanks for bringing this up!

Andreas

--nextPart1744037.qxjbOhhblh--