Bug 76553 - Add Documentation Entry: Strange GUI, impossible to add documentation
Summary: Add Documentation Entry: Strange GUI, impossible to add documentation
Status: RESOLVED FIXED
Alias: None
Product: kdevelop
Classification: Applications
Component: doctreeview (show other bugs)
Version: 3.0.1
Platform: Compiled Sources Linux
: NOR normal
Target Milestone: ---
Assignee: KDevelop Developers
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-03-02 11:06 UTC by Robert Vogl
Modified: 2004-05-08 00:17 UTC (History)
0 users

See Also:
Latest Commit:
Version Fixed In:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Robert Vogl 2004-03-02 11:06:46 UTC
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.
Comment 1 Alexander Dymo 2004-03-03 19:47:41 UTC
CVS commit by dymo: 

Use "all/allfiles" mimetype in "add bookmark" dialog. We can bookmark and view not only html files.
CCMAIL: 76553@bugs.kde.org


  M +1 -1      doctreeglobalconfigwidget.cpp   1.31


--- kdevelop/parts/doctreeview/doctreeglobalconfigwidget.cpp  #1.30:1.31
@@ -345,5 +345,5 @@ void DocTreeGlobalConfigWidget::runHtdig
 void DocTreeGlobalConfigWidget::addBookmarkClicked()
 {
-    AddDocItemDialog dlg;
+    AddDocItemDialog dlg(KFile::File, "all/allfiles");
     if (!dlg.exec())
         return;


Comment 2 Robert Vogl 2004-03-19 01:02:31 UTC
Ich werde ab  08.03.2004 nicht im B
Comment 3 Alexander Dymo 2004-05-08 00:17:54 UTC
Add and edit dialogs look the same in new documentation plugin now. Hope it also presents a saner way to add documentation catalogs.
Nevertheless, title field is also usually greyed and located under location field. This is done because title is determined automatically and usually can not be changed.