STL docs in Gideon? (was: Re: playing with gideon)

[Tamas Nagy]

IMHO, KDevelop/Gideon should contain only carefully selected and
essential documentation.  Let me explain:
Gideon integrates lot of languages/tools (C, C++, Java, CVS, SVN, ...)
If you add this, you other people might ask for adding a complete Java
reference, CVS/SVN manual, ... And the result: it would be almost
impossibly to package and distribute Gideon/Kdevelop due its size. BTW,
most of the distributions are containing doc packages already for
these...

I would suggest a different solution: 
- place a dummy HTML file with reference to the original document... If
somebody wants it, could browse it online...
- create a custom document installator accessible from the configuration
menu, which could download and
  integrate all the third party documents (C, C++, Java, Python, Perl,
..., CVS/SVN/Perforce manuals) into Gideon
- Gideon would have the most uptodate and comprehensive developer's
documentation framework;)

This way much more document would be available without having gigantic
size packages...

Just my 2 cents,
Tamas




-----Original Message-----
From: kdevelop-devel-admin at barney.cs.uni-potsdam.de
[mailto:kdevelop-devel-admin at barney.cs.uni-potsdam.de] On Behalf Of
Sebastian Kratzert
Sent: Saturday, November 09, 2002 3:40 PM
To: kdevelop-devel at kdevelop.org
Subject: STL docs in Gideon? (was: Re: playing with gideon)


Am Friday 08 November 2002 23:18 schrieb August Hörandl:
> Am Sonntag, 3. November 2002 21:34 schrieb Sebastian Kratzert:
> > In the Makefile.am of STL there is the install part disabled. 
> > Somebody knows why? Additionally there are no .html and no mechanism

> > for their creation in Makefile.am, only .gif's and .h's
> > Sadly I don't know how to create the html files.
>
> i searched
> * the cvs attic  
>http://kdewebcvs.pandmservices.com/cgi-bin/cvsweb.cgi/kdevelop/doc/stl/
>Atti
>c/ there they are ;-)
> * http://www.sgi.com/tech/stl/download.html -
>   if you go to "Download the STL documentation" - there they are, too
>
> i copied the files frm sgi to
>   /opt/kde3/share/doc/HTML/en/kdevdoctreeview/stl
> and gideon is happy ;-)
>
> this raises some questions:
> - Why were these files removed? the copyright seems to allow
>   distribution

I found something in the mailarchive.
http://lists.kde.org/?l=kdevelop-devel&m=98866703216376&w=2

> - if the files aren't included into gideon, there should be "dummy
html"
>   files with the install instructions

If 2MB of zipped files aren't to much I would include them in gideon.

-- 
bye,

Sebastian






_______________________________________________
Kdevelop-devel mailing list Kdevelop-devel at barney.cs.uni-potsdam.de
http://barney.cs.uni-potsdam.de/mailman/listinfo/kdevelop-devel