Valeri, Please play with your imagination, but do not send wrong information to this list if you do not know what you are talking about concerning the new HELP system currently under development. We want to improve the situation (fast help and better help). Note that this new facility will not be part of the 4.01 release in December, but we expect to have it in the next iteration next year. Rene Brun On Fri, 12 Nov 2004, Faine, Valeri wrote: > Hello Axel, > > I am sorry, I think this just because of lack of information explaining the > idea. > One said there will be new class and it was the only information about that. > Thatr left plenty of the space for imagination to work . . . > > Thank you > > ---- > Best regards > Valeri > > > > -----Original Message----- > > From: Axel Naumann [mailto:axel-naumann@gmx.de] > > Sent: Friday, November 12, 2004 12:34 PM > > To: Faine, Valeri > > Cc: 'roottalk@pcroot.cern.ch' > > Subject: Re: [ROOT] THtml and Contet menu > > > > Jesus, Valeri, please: the html will still exist, and nobody will notice > > any difference. When you tell THtml to generate documentation you will > > get your html as you used to. I thought I had explained all that in > > detail in my answer. You are right that some info is not available in > > the html files, but that's because it's not needed for html files, and > > it never was (like "what classes will I have to regenerate when file X > > has changed"). The original html doc will be improved, not replaced. > > > > Please, read Rene's and my answer before indirectly claiming silly > > things like "we do need some special ROOT-based Web browser plug-in to > > be able to get access to ALL ROOT Help". This is just plain wrong, and > > all the emails you could have read in this thread tell you the exact > > opposite. I'm very willing to discuss each bit of the (not even fixed) > > implementation - if the discussion is getting us somewhere. > > > > Axel. > > > > Faine, Valeri wrote: > > >>Hi Valeri, > > >> > > >> > Thank you very much for your precise clarification. > > >> > > >>You're welcome. > > >> > > >> > Is it possible to create the ROOT HELP file from its HTML > counterpart? > > >> > > >> >> Both output formats - html files > > >> >> and the online html help (and any other, non-html formats that > people > > >> >> implement) - are generated from the objects stored in the root file. > > >> > > >>Or: no. the .root file is the core, not the .html files. > > > > > > > > > This means we have to forget about HTML and about any user code and we > do > > > need some special ROOT-based Web browser plug-in to be able to get > access to > > > ALL ROOT Help information. Your ".root file is the core" sounds for me > like > > > some information will be not available through HTML will be it? > > > > > > What about ROOT file in "XML format" using ROOT XML I/O feature? > > > > > > Thank you, Valeri > > > > > > > > >>Axel. > > >> > > >> > > >>>>-----Original Message----- > > >>>>From: Axel Naumann [mailto:axel-naumann@gmx.de] > > >>>>Sent: Friday, November 12, 2004 12:50 AM > > >>>>To: Valeri Fine > > >>>>Cc: 'Thomas Bretz'; roottalk@pcroot.cern.ch > > >>>>Subject: RE: [ROOT] THtml and Contet menu > > >>>> > > >>>>Hi Valeri, > > >>>>as Rene pointed out, there will be both .html and .root. The root file > > >>>>contains objects - storing those in html introduces an overhead that's > > > > > > not > > > > > >>>>worth it. So instead of creating the application around a data format, > > >>>>there will be a data format that suits the application. Browsers read > > >>>>html, root reads root files. The root file will not replace the html > > > > > > doc; > > > > > >>>>there will be an additional online help. Both output formats - html > > > > > > files > > > > > >>>>and the online html help (and any other, non-html formats that people > > >>>>implement) - are generated from the objects stored in the root file. > > >>>> > > >>>>Cheers, Axel. > > >>>> > > >>>> > > >>>> > > >>>>>Hello Rene, > > >>>>> > > >>>>>Some question inspired by this discussion. > > >>>>> > > >>>>> > > >>>>> > > >>>>>>We intend to use this class to browse any html document and in > > >>>>>>particular > > >>>>>>the ROOT documentation itself that will be available in super > > > > > > compressed > > > > > >>>>>>form in $ROOTSYS/etc/help.root. > > >>>>> > > >>>>> > > >>>>>Why do you want to save it in the very "root" format? > > >>>>>With the plain HTML one could have used it with and with no ROOT. > > >>>>> > > >>>>>Are you going to repeat the Microsoft approach? > > >>>>>They indeed had the own binary format for HELP files but then . . . > > >>>>> > > >>>>>The HTML text file can be zipped just one care about the file size. > For > > >>>>>example, > > >>>>>Window XP can read transparently the files within ZIP archive without > > >>>>>bothering > > >>>>>the user to uncompress it first. ROOT can do that also. I mean, > > > > > > instead > > > > > >>>>>of > > >>>>>reading the ROOT file with the help information; ROOT can unzip the > > > > > > text > > > > > >>>>>file with > > >>>>>the HTML inside. > > >>>>> > > >>>>>By the way, it would have made it fully compatible with the > > > > > > corresponding > > > > > >>>>>Qt text > > >>>>>widgets. > > >>>>> > > >>>>>As result, our Qt users will enjoy this format with no extra effort > > > > > > also. > > > > > >>>>>Just my 2 cents. > > >>>>> > > >>>>> > > >>>>>Hope this helps, Valeri > > >>>>> > > >>>>> > > >>>>> > > >>>>> > > >>>>>>Hi Thomas, > > >>>>>> > > >>>>>>Good that you ask this question! > > >>>>>> > > >>>>>>We are just about to introduce a new class TGHtml. > > >>>>>>We intend to use this class to browse any html document and in > > >>>>>>particular > > >>>>>>the ROOT documentation itself that will be available in super > > > > > > compressed > > > > > >>>>>>form in $ROOTSYS/etc/help.root. > > >>>>>>Axel Naumann is working on a modification of THtml that will > generate > > >>>>>>help.root > > >>>>>>file automatically (or any user classes). > > >>>>>>The idea that you should be able to get quickly the help from the > > >>>>>>browser, > > >>>>>>the command line, the pad, etc. > > >>>>>> > > >>>>>>The TGHtml class could be used to browse any kind of document. One > > > > > > could > > > > > >>>>>>even > > >>>>>>imagine that stdout from ROOT could be automatically hyperlinked > with > > >>>>>>this > > >>>>>>class. > > >>>>>> > > >>>>>>TGHtml will be introduced in CVS before the production release in > > >>>>>>December. > > >>>>>>The adaptation to the ROOT help system is scheduled for the first > > >>>>>>quarter of > > >>>>>>next year. > > >>>>>> > > >>>>>>Rene Brun > > >>>>>> > > >>>>>>Thomas Bretz wrote: > > >>>>>> > > >>>>>> > > >>>>>>>Dear all, > > >>>>>>> > > >>>>>>>I have a suggestion: > > >>>>>>>It would be nice if there would be an option in the context menu of > a > > >>>>>>>class drawn to a pad (eg TH1F in a canvas) to show the class > > >>>>>> > > >>>>>>description > > >>>>>> > > >>>>>> > > >>>>>>>as plain text on the console. I don't know how a implementation > could > > >>>>>>>look like without storing the whole class description in the > > >>>>>> > > >>>>>>executable > > >>>>>> > > >>>>>> > > >>>>>>>and without starting a browser. Maybe it is possible to compile the > > >>>>>>>class description text into a root file which can be opened by the > > >>>>>> > > >>>>>>user. > > >>>>>> > > >>>>>> > > >>>>>>>If such a 'docu' file is open the corresponding help-entry appears > in > > >>>>>>>the context menus. Through the TBrowser now all class descriptions > > >>>>>> > > >>>>>>would > > >>>>>> > > >>>>>> > > >>>>>>>be acessible. This gives an easy interface to an online-help in > > >>>>>> > > >>>>>>programs. > > >>>>>> > > >>>>>> > > >>>>>>>What do you think? > > >>>>>>> > > >>>>>>>Best regards, > > >>>>>>>Thomas. > > >>>>> > > >>>>> > > >>>>> > > > >
This archive was generated by hypermail 2b29 : Sun Jan 02 2005 - 05:50:10 MET