When I generate documentation using Doxygen I get several empty packages representing system namespaces like 'Linq' and so on. The question is how to get rid of them?
I had the same problem and found one solution. Putting the using ... lines between \cond and \endcond tags hides them in the helpfile output.
I'm not very glad about that, changing something in the doxy file would be easier. Maybe there's another better solution?
The problem is new with the new doxygen version v1.8.1.1
I've removed them by adding this in the Doxyfile
EXCLUDE_SYMBOLS = System
Related
I have recently run on this problem. I have tried to add namespace to Views/web.config or on top of the view, but still occur on the problem, where View can't find the contents of namespace.
Problem
Ofcorse it is not a big problem, but it is annoying to always write the full namespace.
Maybe you should try write another using that contains your Resources path?
This is one of the things I find infuriating about C#. I have thsi massive library im trying to use right now and for some reason the people who create the code examples are not smart enough to include the namespaces you need to import in the examples. This is usualyl the case. I find myself searching through the namespace, hundreds sometimes nested trying to figure out which ones i need to import. In java netbeans, it even tells me which packages to import because it searches for me. But in C# i always waste countless time searching through the namespace manually.
Is there any way I can get around this. Like right now im trying to find which namespace contains TwitterCredentials for Tweetinvi library.
Seriously, why do people not include the namespace in code examples. It's just stupid not to!
And why does visual studio not make suggestions like java. It's just common sense really....
You can press Ctrl + . on each word that has error or point to small blue bar under the word and click on dropdown, and use offered namespace.
I am the developer of Tweetinvi :)
ALL the classes you need in Tweetinvi are located in the Tweetinvi.Core.* namespace.
TwitterCredentials.cs
To answer your question regarding Namespaces and why I do not include them in the examples. The reason is that as mentioned by Reza Aghaei Visual Studio and Resharper allow developers to include namespaces.
Furthermore as you mentioned the library is big and therefore multiple namespaces might be required and I am not going to add all of them in each example. Otherwise the documentation would just be huge.
I hope you will like the library and please feel free to ask any question here on stackoverflow or on github.
Happy coding.
PS: By the way you can also use Github to search for filename with a 't' keystroke on the Source Code page.
Monodevelop automatically generates verbose documentation for functions and classes if "///" is typed in the appropriate place, upon typing the third '/'.
I want it to go over all of my code, though - I thought there was some button somewhere, and I looked around in the drop-down menus, tried right-clicking file names, etc.
I could not find such an option - does it not exist? I could not find a plugin that does that either.
Try to use Edit-> Document buffer.
It will make /// comments for all your public methods/classes without any comment upon it in current file.
It won't work if you have // comment upon method/class or for protected/private elements.
It is not possible. Your options are:
Manually typing three slashes before each and every function
Using an external tool
Online searches have not come up with any plugins for monodevelop that would do that, and the option does not exist in the vanilla IDE.
I keep coming accross code samples online for ASP.net c#, however they never seem to list which namespaces they include, for example:
using System.Data.SqlClient;
etc etc
Am I missing something obvious or should I be expected to know exactly what namespaces each code example requires?
When I'm in that situation, typically I search for the class on MSDN. The documentation will tell you which namespaces contain the class.
If they don't include them, you can follow this list in order:
Find that they are in one of the namespaces listed in the "blank code file" template , or
In Visual Studio You can click the missing type and press shift+F10 or Ctrl+. To get the option to automatically add the using statement (if the assembly is referenced)
With Resharper, Select the type and hit alt+enter for Resharper to find the namespace for you, and add it to the usings (possibly even reference the assembly as well)
Go to MSDN and search the name.
Go to Google and search the name (honestly, I normally do this before hitting MSDN anyway)
Compain to the article author
If code samples use the assemblies that a project references by default, then you can hover on the class name and click shift+F10 which will add the using statement automatically. If the class is not in any of the referenced assemblies then you are out of luck and need to know in what assembly does the class resides.
A quick google search can help, and in time you will memorize the namespaces... Of course its best if samples included the namespace and reference info, but mostly they do not.
If you are viewing code in Visual studio, just hover mouse over class or object you want and you will get tool tip about it if assemly of that class is present or you can google for particular class.For example if you want to know more about 'DataTable'class, just google it and you will come to know that its part of Syste.Data namespace.
I'm with the OP on this one. Having to just magically "know" what namespaces are required seems supremely silly.
I spent some time before C# as a Java Developer, and the NetBeans IDE will resolve these for you automatically. Ctrl-Shift-I, and it will insert all the packages (ie, namespaces) you need. If more than one package defines the class you are resolving, a window pops up and lets you choose which one you want.
For as fine a product as VS is, I am incredulous that this feature is not included.
How can I syntax highlight using the scintilla. I have no idea how to use it. I need a code sample that loads scintilla, puts a String[], and runs it in a richtextbox.
You might find your answer here.
alternatively apparently some file can't be found it seems like an installation issue.
might find more here