[Bug 76553] New: Add Documentation Entry: Strange GUI, impossible to add documentation

[Robert Vogl]

------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
      
http://bugs.kde.org/show_bug.cgi?id=76553      
           Summary: Add Documentation Entry: Strange GUI, impossible to add
                    documentation
           Product: kdevelop
           Version: 3.0.1
          Platform: Compiled Sources
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: normal
          Priority: NOR
         Component: general
        AssignedTo: kdevelop-devel kdevelop org
        ReportedBy: robert.vogl esg de


Version:           3.0.1 (using KDE KDE 3.1.4)
Installed from:    Compiled From Sources
OS:          Linux

The dialog to integrate external documentation (Configure KDevelop/Documentation Tree/KDevelop TOC Documentation) is not intuitive to handle. If I like to add external documentation I have to specifiy a location prior to the title. I expect the reverse order. The title-widget is greyed out. Why is the user prevented from specifying the desired title? The location dialog asks for a *.toc file. How to get or create that??? It is impossible simply to specify a local directory that holds an index.html-file for documentation that was delivered as HTML (and not generated by Doxygen).

The table shows three columns named "Name", "Title" and "URL". Therefore if I click on "Edit" I expect to edit name, title and URL of an entry of that table. But I'm asked to change a "Documentation Path" (I guess same as URL) instead. The widget for "Library name" and "Library source path"(?) are grayed out and cannot be changed (am I really in the edit-dialog!?). And why is the Edit-Dialog completely different from the Add-Dialog? This is not intuitive.

A confusing GUI is a bug. Nevertheless my integrated documentation never shows up in the "Documentation" window.