Bug: Debug console documentation

[SSH]

Just been re-reading some bits of the manual and found the debug mode script single-stepping with Scroll Lock and Right Shift. Cool: helped me get a stairs animation right.

However, it took me some effort to get the debug console up. Eventually, I pressed ` instead of ~ and it came up. The "to the left of 1" description was right but the key symbol not! Has anyone else had this problem? Maybe my keyboard is an odd one (HP external keyboard used on Toshiba laptop)  but if others have had this problem, it might be worth updating the help file...

Do many people use these, as I had forgotten about them!

[Scorpiorus]

Hmm, for me the Tilde key (that just under Esc) is both ~ and `, i.e. pressing tilde -> '`' and shift + tilde -> '~'

The thing is the console pops up on pressing `, it doesn't react to shift+tilde (ie ~), though. So, if you have them as different keys...

[SSH]

Maybe it should be user-configurable, like the CTRL-X etc debug functions are?

Debug(5, 0) for console and Debug(6, 0) for script line?

my ~ key is next to Return, sharing the "#" key
my ` key is next to 1, sharing with ¬ and ¦

so CJ: fix that documentation!

[dasjoe]

i would not call it a bug, it's the layout of your keyboard that matters.

on german keyboards (like mine ) the key next to 1 is ^ and shares with °.
so, it differs from country to country..

[SSH]

Yes, but it it ~ or ` that starts up the debug console for you?

[Proskrito]

its the key under the esc besides the one, no matter what is it labeled with.

[Ishmael]

My key next to 1 has § on it, and with shift I get a ½... Finnish keyboard... the character the key is bound to doesn't matter. The position of it. There are some kind of key location codes also... The same key opens the console in many many games and other.

That's why the "(the key next to 1)" is there, me thinks.

[SSH]

Well, then the manual should say "The key next to 1" (~ on some keybaords) instead of the other way around...

[Ishmael]

I think this has something to do with AGS being english... ¬_¬

[Pumaman]

Well spotted, I can see how this can be confusing.

The actual keycode that AGS reacts to is  `  which is normally to the left of the 1 key.

On UK keyboards, this key is also the | key, on US keyboards it is the ~ key. The AGS documentation was assuming people were using a standard US-International keyboard when of course this varies, sorry I forgot about that.

So it is actually the  `  key that is important, wherever it may be located. Luckily most keyboards do all have that on the key next to 1, it's just the shifted version that differs.

I will update the documentation to reflect this.