13. Auto-bookmarks from specially formatted script comments.

The screenshot for bookmark is very useful but is it possible to replace the numbers in the icons with arbitrary text when creating the bookmark using formatted comment? Something like:

	Code:
	-- [bookmark:text to show])

I'm sorry I don't understand. The bookmark is a small floating circle that fits only 1 character and it's very small on purpose as not to obscure the work area. Where do you see user's specified bookmark text to show up? Or you want this text painted over the screenshot area? In the latest case, why not enter it in the comments near the bookmark marker?

	Code:
	-- My text here [bookmark] more of my text -- even more of my text here

Last edited by SysOp on Tue Jun 12, 2012 10:44 am; edited 1 time in total

The numbers are good to show which hotkey does jump to the corresponding bookmark but other than that, they're mostly meaningless. Unless you can memorize to what part of the code they're assigned to, which is a bit hard when the number goes above 4 (at least for me it is). The extended comments you suggest are easily visible on screenshots and I've been using them in the past but when you've got nearly all 10 bookmarks in a script it's pretty cumbersome to hover the mouse above them to check them one by one.

What I'm thinking about is that it would be a nice touch if you could add the text after ':' in the "[bookmark:text here]" structure to the number in the floating circle (and make it a floating ellipse/box if it is necessary to fit) so that you can have both: the number and the text. You could give it a restriction to size to avoid covering large parts of the working screen area but I wouldn't bother doing so, I guess users can decide what's the best for them in this matter and won't use long texts if that obstructs them in work.

Of course, this would only affect bookmarks added through formatted comments, the regular ones added by clicking or using hotkeys could remain the same. You could even handle them separately. By having a bookmark structure like this users could easily and quickly create a clickable TOC to their code.

I suppose this wouldn't be a simple task to achieve and I'm not speaking for other users but I'd find it extremely useful. Consider it as a feature request ;) And let me know what do you think about it, please!

Thank you very much for your suggestions.

On a related subject, we are planning on implementing new Task List feature in the next maintenance release, which will provide new visual strip or pan with a list of bookmarks and to-do items found in the current file and other previously opened files and procedural objects. There users will be able to see them all at once, without a need to hoover over each circle. I guess a user-defined hot key will be available to show/hide the list with one key press.

That's even a better idea. Sounds very promising, I'm looking forward to it.