State of documentation

[Wolfgang Bangerth]

David,

> >> To make sure that the headers are found, you can hover or right-click
> >> a red-underlined missing header, and then add manual include paths.

OK, I've put a note into the manual to this effect.


> >> (Or you can simply add a newline-separated ".kdev_include_paths" file
> >> at the top of your project). This, by the way, is something that could
> >> use some documentation too. :-)

I think this is not something you'd want joe schmo user to do, so I'll leave 
it out of the manual :-)


> > Before I put this into the documentation somewhere: Is there a dialog
> > somewhere where this could be set? While playing, I've occasionally come
> > across things like what you describe where you resolve a problem (a
> > missing path to include files, or other stuff that's listed in the
> > "Problems" tool view) but where there doesn't seem to be an associated
> > dialog where one could have done this *before* the problem even
> > appeared, or where one could undo a mistake. In other words, is it true
> > that KDevelop stores information on projects that isn't presented in an
> > editable form in a dialog box? If so, why?
> > 
> > Thanks in advance for your help, and I'll be happy to put any answers
> > into the manual as usual :-)
> >  W.
> 
> No, there's no dialog for this, unfortunately. We could put it
> somewhere into the project-configuration, but right now, it's simply a
> context-sensitive helper to discover the .kdev_include_paths
> functionality. Basically though, KDevelop should be able to discover
> the correct include-paths automatically in many cases by using
> information from the build-system (be it cmake or custom makefiles),
> so the user shouldn't be bothered with this until he actually
> discovers that it doesn't work.

I think a way to have this internal information displayed would be very 
useful, and be it only so that you can verify that KDevelop searches where you 
think it searches. I've opened
  https://bugs.kde.org/show_bug.cgi?id=274712
for this.

Best
 W.

-------------------------------------------------------------------------
Wolfgang Bangerth                email:            bangerth at math.tamu.edu
                                 www: http://www.math.tamu.edu/~bangerth/