Page 1 of 1
Developer/Add-On Names
Posted: Wed Aug 25, 2010 1:25 am
by paulz6
From RW Wiki:
3rd Party Developers need to establish their own folder structure for Source material to be located. To do this you need to first decide upon your provider name. It should have no spaces or unusual characters.
Does a hyphen count as an unusual character? Things seem to work.
Re: Developer/Add-On Names
Posted: Wed Aug 25, 2010 1:36 am
by Trainguy76
I think not. If it is you could always use _.
Re: Developer/Add-On Names
Posted: Wed Aug 25, 2010 8:01 am
by AndiS
You could frame this as an example on how the documentation pretends to be complete but cuts out all hard questions which would have demanded communication between programmer and documentation writer.
As it stands, I would not use anything other than characters (upper and lower case) and digits. You could always use upper and lower case for grouping, as in MeTheDeveloper. Be aware that this is mapped to folder names, which means that on Windows, it is not case sensitive. Inside RW, it may well be. I remember some lower case kuju somewhere in the KRS assets which seemed to work fine, but it was fixed, as far as I remember, in RW. But I could not point my finger on a specific item right now.
Of course, they could mean a lot of things with this statement. E.g., umlauts, accented characters, characters which are not legal part of DOS filenames, maybe something else.
Umlauts are one these cases which show you that even if it works somehow, it is not wise to do so. Someone had them in the filename (not provider or product). RW-Tools could not handle them (initially, now fixed, I guess). Also, some people cannot type them, thus they have a hard time Googling for them. In the end, if you go for the international minimum, people will love you (or not hate you) for that.
Now the underscore (_) is the one character which has been a legal part of variable names since stone age. I would count that with "usual characters" although the documentation does not say so.
The hyphen (-) is not illegal in DOS filenames, it is not a special character for string processing, and I cannot think of another case where it plays a role. So you may as well go for that, but see all the caveats above.
Re: Developer/Add-On Names
Posted: Wed Aug 25, 2010 8:11 am
by miglietto
Just a note to say that these names could pass trough many layers like C# code, xml parser, windows filesystem ... and all of them could generate troubles for illegal characters or be or not case sensitive.
Re: Developer/Add-On Names
Posted: Wed Aug 25, 2010 9:13 am
by USRailFan
Hyphens should be OK, at least they work for G-Trax