This requires a consistent way to determine url based on the current data studio version.

I think we should discuss this before implementing it.

Just use the URL defined in AquaFoldSite.ONLINE_DOCUMENTATION

Is there a scenario as how one could reproduce the Out of Memory problem and get the link to the mentioned doc?

I tried the following ways:
* if setting for instance the param to 50M, and then opening ADS, a warning is given that the number is less than the recommended one; clicking OK, ADS Initializing screen appears, the CPU gets 100% usage, but nothing else seems to happen next;
* if setting it to 200M, ADS opens OK, but if for instance trying to query a large amount of data from a DB, CPU gets to 100%, and, as above, everything seems frozen.

In both situations I would have expected to see an error message dialog displaying the link. 

In the second situation, in the ~/.datastudio/logs/datastudio.log file an Out of memory exception is printed (java.lang.OutOfMemoryError: PermGen space).

What I'd recommend is allocate at least 400 MB to ADS, then execute a query with very large result set. Lets say 200k records. Open up a new query panel and execute the same query again. You'll very quickly run out of memory and should see the appropriate error message.

Also, to ensure that the correct memory parameter is being modified, only vmwarg.2 should be modified in the below referenced picture. The PermGen size should not be reduced.

http://www.aquaclusters.com/app/home/project/public/aquadatastudio/wikibook/Documentation12/page/50/Launcher-Memory-Configuration#windows

This issue was created specifically for Git Client.

To test this scenario mount a repository with lots of history information. A good candidate is linux repository(https://github.com/torvalds/linux).

Now launch Git Client and select "Show Complete History". Try navigating thru different branches you should be able to see a dialog with Memory Configuration link (See attached screenshot)

Verified using ADStudio 14 Dev 36 on Ubuntu 12.10, as described by Asif, with a large repository, An Error Occurred window appears having a link pointing, however, to a currently invalid address: http://www.aquaclusters.com/app/home/project/public/aquadatastudio/wikibook/Documentation14/page/50#linux

Is this the intended address?

If trying as Sachin mentioned, an error message as in the attached image (ads_low_on_memory.png) shows up, however with no link to an online documentation. So I moved then this issue to the Git Component. If the link should appear in this case also (on DB queries), I guess another issue should be created.

Asif, lets migrate the enhancements to our standard low_memory error message as well

@Crisitan,

The documentation is specific to v14 and will be a valid when we clone current documentation to v14.

@Sachin,

I looked into different places where we handle out of memory exception. There is no consistent error message dialog or a standard place this error is displayed - it is handled in different ways. I would suggest create separate bugs for individual cases to avoid any regression.

Do note that we try to centralize the message and code in AFMemoryException, such as AFMemoryException.OUT_OF_MEMORY_MESSAGE.

@Niels,

Thanks for your insight. In most cases, we prefix/suffix some message to give user some context. And to make the link work with native browser we will have to use HtmlTextPane.

Verified in 14.0.0-beta-17. Downloaded Linux and tested Show Complete History and link to memory configuration is shown to users on Out of Memory