Whole Tomato Software Forums
Whole Tomato Software Forums
Main Site | Profile | Register | Active Topics | Members | Search | FAQ
 All Forums
 Visual Assist
 Technical Support
 Quick info tooltip trimmed left

You must be registered to post a reply.
Click here to register.

Screensize:
UserName:
Password:
Format: BoldItalicizeUnderlineStrikethrough Align leftCenterAlign right Insert horizontal ruleUpload and insert imageInsert hyperlinkInsert email addressInsert codeInsert quoted textInsert listInsert Emoji
   
Message:

Forum code is on.
Html is off.

 
Check to subscribe to this topic.
   

T O P I C    R E V I E W
tony.riviere Posted - Aug 28 2018 : 11:25:37 AM
It sounds like VAX reformat the comments of a function or a class in the quick info tooltip ; especially it removes consecutive whitespace to keep only one. The direct side effect is that it removes the formatting if we have piece of code in the comment:



I don't know if it is wanted feature or not. I was expecting that it preserve the formatting.
3   L A T E S T    R E P L I E S    (Newest First)
feline Posted - Aug 29 2018 : 07:12:26 AM
I am not sure how deliberate collapsing all of the white space is, but it is often "useful". It is quite common to come across formatted comment blocks, which work well in the code file, but that won't work well or make much sense when shown in a different font, in a tooltip. Here collapsing the spaces gets as much of the useful content as possible into the available space.
tony.riviere Posted - Aug 29 2018 : 04:15:37 AM
Actually, the function had a template parameter (not shown in the screenshot), and I was using the comments to show an example of code the function was expecting. I ended up this by adding just the expected prototype:
/// @tparam TFunc    ExpRet(ExpParam...)

But you're right, since the font in the tooltip is not a good one to display code, it may not be the right place to do so.

However it's a bit weird that all whitespaces are collapsed unless it's a wanted feature?
feline Posted - Aug 28 2018 : 11:37:14 AM
I see the effect here, but since the tooltip is using a non fixed space font, the indenting isn't going to be very informative regardless. It will work for one level, but telling different levels of indenting apart? That is quickly going to start getting tricky.

It's a question of how much we want to show in a "preview" of the comment. For small comments everything fits into the tooltip just fine, but as the comment block gets bigger, there comes a point where only some of the comment is shown in the tooltip. Do you have a lot of preview code like this in tooltips? Does the code ever get more complex than one level of indenting?

© 2023 Whole Tomato Software, LLC Go To Top Of Page
Snitz Forums 2000