However when I try to use the "Search" box in this tool ,it occurs a bug and result a crach .It said helpLibAgent.exe has a problem and has to close ,and the the page show the "HTTP 500" message. what it happened?
Great extension, addresses a major problem with VS2010.
BUT I don't see anyplace where I can report a bug.
Frequently when I start up VS, I get a notification of an exception in the Help Viewer Keyword index tab. It doesn't let me copy and paste this message. I could take a screenshot if the developer is interested.
It would be really great if it was coupled with the F1 key; at the moment, context-sensitive help can't be coupled with this extension (unless I'm missing something that should be more obvious).
While H3Viewer makes the "Help Experience" in VS2010 a little bit less painful, I'd prefer to get help in an _internal_ viewer; switching between applications for no apparent reason at all drives me nuts.
For those unsure of how to install a VS Extension please see..
Bloody great extension Ryan thanks for making this available so soon after RTM.
This seems not to work with VS 2010 Express.
The installation of the .vsix displays "This extension is not installed on any of the products currently installed" (translated from french).
And, directly in VS, HelpViewer is not listed in the online Extension Manager.
I tried to paste the .vsix file in my VS appdata directory too, but it is not recognized.
Any idea ? Is the extension compatible with the Express versions ?
This extension makes a lot better. Thanks for creating it. I had posted yesterday on the channel9 forums about how awful the new help system is.
After installing your extension I had a few issues remaining. Search is still a bit wonky (not too sure what you can do about that), and pressing F1 in the test editor bypasses the your extension completely. TOC sometimes begins appearing in the help contents even though I have it turned off in the extension.
F1 calls are still going to be serviced by the HelpLibAgent, and not by this VS Extension. This extension was basicaly to provide an integrated Keyword Index.
I'm curious, is your issue with the new help system the lack of an index, related to the TOC, or something else?
I'm part of the team that's responsible for the help viewer, so here's your chance to provide direct feedback :)
Personally, I greatly dislike the fact that the tree on the left scrolls with the rest of the page. I keep having to press Home to get back to top once reading to the end of the article to navigate elsewhere.
The inability to properly resize the tree is also annoying. It took a while to discover the sizer button in the first place, and then to figure out that you're supposed to just click it (and not drag it). Even then, a proper solution that'd let me drag it to get precisely the width I want would be much preferred.
I also liked the old-style index with its find-as-you-type functionality, because it lets you start with something that "might be right", and immediately see the actual options that are available.
Note how all three points are taken care of by your extension, however :)
> I'm part of the team that's responsible for the help viewer,
> so here's your chance to provide direct feedback :)
* When the Help Library Agent starts it pops up a balloon tooltip telling me that it's started. I also need to manually stop it when I'm done using help
* I can't resize the divider between the contents "tree" and the document on the right
* I can't view "nearby" content pages via the list on the left. I get sibling nodes and parent nodes, but not children. I also cannot "explore" nearby content pages - it requires a large amount of clicking and I can never get a clear view of all of the content options available to me on a subject.
* There is no index
* Search is not very good - only 10 items are shown per page. There is no way to know what the contents an article is - no mention of the platform in the search results - ATL? C ? .NET?
* There is no way to switch to .NET 3.5 or 2.0 content.
* The Help Settings window does not match the Visual Studio 2010 visual experience. The text on it is blurry (WPF issues?). It has a "Settings" link on the top right - "Settings for Settings"? The sub pages show "Cancel", which is confusing since it returns to the previous page rather than cancelling the dialog. Selecting "Check for Updates" does not give me an option to only update a subset of the content - I'm forced to download all 1192 MB.
There are some good things - the dreaded "merging help indexes" is gone and there is now a way to update offline content... very nice.
All I really want is something similar to Document Explorer - a standalone app, no web server (ie/ use an async puggable protocol such as ms-help), a Contents and Index "isolated" from the document so that it doesn't "reset" change position when selecting a document, and favorites/bookmarks. That's it.
The first time I showed VS2010's help to a coworker he said "Ohhhh.. it's just like Java!". Trust me, it wasn't a compliment! Everyone I know is still using VS2008's help.
constructor points to 404 file not found page.
When I use the index to navigate to "CountdownEvent" it shows some entries for about.., all members, constructor, methods, properties. If I click on "constructor" it opens a help page with a 404 error. The URL is this:
I've found a 'logic bomb' in external viewer code. If it's set to use the internal viewer it's fine, but using an external viewer (Firefox in my case) opens a new window for every topic that's highlighted. So scrolling down the topic list by holding down the down-arrow key attempted to open 15 or so separate Firefox windows - it then crashed both VS and Firefox. Note, this is particularly the case when Firefox is not initially loaded - it seems that the 'open window' messages get queued, but focus stays on the index or ToC allowing more messages to queue up.
On the plus side the index implementation is actually better than the 'missing' one; brilliant work, thanks.
TOC doesn't work for me: on clicking any item there, a 404 error page is displayed (help is in local mode, the URLs are all http://127.0.0.1/... , VS internal and external browser give exactly the same results).
The problem is that
Thank you for H3Viewer.
There's a disappointing problem with keyboard shortcuts. Really impossible to browse mainly with keyboard.
When the focus is on a frame control e.g. Contens tab, there's no way to browse page backward and forward and to scroll the help page.
When the focus is in the page (let's click on page), some shortcuts are not working: Ctrl-Left, Ctrl-Right. And Ctrl-N opens the IE, not a new tab.
As well there's no way to switch focus from the frame to the help page not touching the mouse.
The IE browser control cause such problem in most applications. A possible solution would be to overlap the page by a transparent window and pass through all mouse events, reverting the focus to the frame every time.
Important shortcuts would be functional at any state of the focus:
Ctrl-Up,Down – page scrolling.
Alt-Left,Right – backward, forward
Tab – move to next link on page
Enter – open link
Ctrl-Tab, CtrlShift-Tab – next/previous help tab.
Alt-Up,Down – next/previous topic (in TOC order)
P.S. I hate to jerk the hand from keyboard to mouse. Don't you?
Persistence now works great thanks Ryan.
Wish list for the future :-)
* TOC Tab - with full TOC
* Ctrl+Click items (or Search button) to open in new page tab (IDE).
* Shift+Click items (or Search button) to open in default browser.
* Would rather standard Ctrl+Shift click than the target check box option (open in IDE by default).
Ryan, do you have an actual EXE associated with this extension? If you did then we could make the Agent registry item point to your viewer.. HelpViewerProgID=<ViewerPath> and then you could direct all F1 help calls to open inside the VS IDE (or in def browser according to your options). That would please some developers I think.
Another wish list
* Requires at least 3 characters before refresh the index;
* Delay refreshing the index while user is typing;
* Dock the HelpViewer at left of the embedded browser, or vice versa (if possible)
Thanks, Ryan, this extension is awesome;
Maybe you can use pipes to create communication with an external EXE and handles F1 call.
I do actual have a slight delay for faster typers (albeit very small delay), but i can increase it. perhaps i'll add the min number of characters to a config file/reg key. Is there a reason other than perf why you'd want a minimun set?
As for dockable left of the browser, you should already be able to do this. Just grab the title bar and move it over.
finally got around to adding the TOC, and i cleaned up some encoding issues, so download the latest to get it.. I'm also doing some investigation around getting F1 to pop into the IDE browser as wel. Stay tuned.
I've tried installing this three separate times over the last week... each time the extension doesn't work and I get the same error (visible on the index tab):
"Unable to connect to remote server: Help Agent unavailable, attempting to restart"
I've tried running as Administrator (I don't do this normally), doesn't help. If I attempt to search for a specific term through the extension's UI, I see that the extension is attempting to connect to 127.0.0.1:47873/help/blahblah... but apparently nothing is listening there.
This sounds like a great extension... help?
That message usually occurs when the Help Agent isn't running. Can you confirm that you've set your help settings to 'Local' vs. 'Online'? Via the IDE, Help-->Manage Help Settings. This will launch the Help Library Manager where you can choose online or offline help.
Also, what happens when you just hit F1?
I'm getting the exact same thing. I've verified that my help settings are set to 'local', and when I hit F1, it brings up help in IE at http://127.0.0.1:47873/help/etc. I also see the Help Library Agent icon in the task bar. Any help would be appreciated, as I've gone back to VS2008 for documentation; the 2010 help system is horrible.
When "Display TOC in page" option is turned off (and why would I want it on, when there's the index toolwindow?), code snippets in pages get mangled. For example, here's the first VB snippet from String.ToString as it should look (with TOC enabled):
Public Overridable Function ToString As String
Dim instance As Object
Dim returnValue As String
returnValue = instance.ToString()
Here's the same one with "TOC disabled" (which, so far as I can see, just adds "&embedded=True" to the URL:
PublicOverridableFunction ToString AsString
Dim instance AsObjectDim returnValue AsString
returnValue = instance.ToString()
As you can see, the keywords are all jammed together. It also does this to line breaks occasionally.
interesting. Yep all the TOC selection does is add a query string param that the help runtime evaluates. It appears that the resulting HTML is mangled in few cases (the transformation is done through via the core help code) when the TOC is left out. I'll look into that one
Paul O'Rear and I also got reports that some users saw code snippets with words jammed together. However on our PCs (any browser) we could not reproduce the problem. If I did a "view source" on the page I could not see a reason why the words would be jammedtogether in code snippets. Very simple text formatting. Pavel I wonder if your "view source" shows correct text or words jammedtogether?
This doesn't seem to be browser-specific, either - IE8, Firefox and Opera all show this problem.
That's interesting because I embed the IE component in the H3Viewer window. You would think it would show the same problem as IE8.
Thanks so much for this tool - it looks great! I just did a quick test and had the "Use my default viewer" box checked and it brought up my selection in Google Chrome instead of IE (which is my default viewer).
Has anyone else seen this?