[BUG #6968] modified manual to reflect @ hints in code structure
[BUG #6968] changed all occurrences of # hints into @ hints in the manual
[BUG #6968] add deprecation warning for #-hints