Firstly, thank you to those who document boinc wonderfully well.

I have recent used this page

Application configuration

for the first time, and would like to make a couple of suggestions.

I found the documented application called "uppercase" confusing, (and yes i did type the application name in uppercase without thinking. lol)

May i suggest where <name>uppercase</name> or <app_name>uppercase</app_name> is used replace it with Application_Name

I knew where to look to find client_state.xml, but a link to where to find it would be helpful, and a reminder that this is not the name displayed by boinc manager or the operating system.

Application_Name may contain uppercase, lowercase, numerics and special characters.



<app_version> questions.

I did not use the <app_version> stanza.

How is the version number specified? i can't see the parameter to set in the app_config.xml file.

Where is the version number found? I think the answer is in the app_config.xml file as <app_version_num>

<plan_class> is not well documented.


Lastly,it would be helpful to give the reader some links to examples.

Firstly, thank you to those who document boinc wonderfully well.

I have recent used this page

Application configuration

for the first time, and would like to make a couple of suggestions.

I found the documented application called "uppercase" confusing, (and yes i did type the application name in uppercase without thinking. lol)

May i suggest where <name>uppercase</name> or <app_name>uppercase</app_name> is used replace it with Application_Name

I knew where to look to find client_state.xml, but a link to where to find it would be helpful, and a reminder that this is not the name displayed by boinc manager or the operating system.

Application_Name may contain uppercase, lowercase, numerics and special characters.

That's worth thinking about, and I'll maybe implement it when the web site finds its style sheet again, so I can see the layout properly.

It would require some adjustment to the example section:

name
short name of the application as found in the corresponding <name>xxxxx</name> tags in your client_state.xml file. In the above example, the application name is "uppercase".

<app_version> questions.

I did not use the <app_version> stanza.

How is the version number specified? i can't see the parameter to set in the app_config.xml file.

Where is the version number found? I think the answer is in the app_config.xml file as <app_version_num>

I don't think the granularity of app_config goes down as low as the version number level. The hierarchy is

Application
... Plan class
... ... Version (number)

If you were able to use it, you would take it from <version_num> in the <app_version> section of client_state.xml

<plan_class> is not well documented.

Lastly,it would be helpful to give the reader some links to examples.

I'll leave that for more experienced documenters to consider.

Application_Name and example adjusted.

Application_Name may contain uppercase, lowercase, numerics and special characters.

I don't concur.
&lt;name&gt;&lt;/name&gt; contains the same name of the application as stored in client_state.xml, and is just the short application name used by BOINC and the project. It is the &lt;user_friendly_name&gt;&lt;/user_friendly_name&gt; in app_info.xml and client_state.xml that can contain uppercase and lowercase characters, because this reads in a user friendly way the application's name.
Both can contain numerics and special characters.

---

Application_Name may contain uppercase, lowercase, numerics and special characters.

I don't concur.

The wiki still includes (and i should have pointed to this on my original post) these two lines towards the end of the page

All the tags use lowercase characters.
The app_name may contain uppercase characters.

To be clearer, the second line, and all similar references to application name valid characters could simply be deleted. There is no reason to make comment on the case or otherwise, it simply needs to match (exactly) what is in the client_state.xml - or have i misunderstood something?

Having checked some further into it, I see I am wrong.
For example, Einstein@Home had an application stored in client_state.xml called

<name>einsteinbinary_BRP5</name>

I've adjusted the wiki to hopefully make things more clear.

---

I've adjusted the wiki to hopefully make things more clear.

Thank you Jord.