From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,e61c8636ef35379d X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2001-01-21 03:24:31 PST Path: supernews.google.com!sn-xit-02!supernews.com!isdnet!grolier!fr.clara.net!heighliner.fr.clara.net!news.tele.dk!128.39.3.166!uninett.no!ntnu.no!randhol+abuse From: randhol+abuse@pvv.org (Preben Randhol) Newsgroups: comp.lang.ada Subject: Re: Examples in Docs, was Re: Escape Sequences in Strings Date: 21 Jan 2001 11:24:30 GMT Organization: Norwegian university of science and technology Message-ID: References: <93objj$guk$1@nnrp1.deja.com> <93q77h$rr6$1@nnrp1.deja.com> <940f9j$nj2$1@nnrp1.deja.com> <94299p$8dd$1@nnrp1.deja.com> <94a2jj$tc2$1@nnrp1.deja.com> <94c73f$hs9$1@nnrp1.deja.com> <94c96r$jiv$1@nnrp1.deja.com> NNTP-Posting-Host: kiuk0156.chembio.ntnu.no X-Trace: kopp.stud.ntnu.no 980076270 22414 129.241.83.82 (21 Jan 2001 11:24:30 GMT) X-Complaints-To: usenet@itea.ntnu.no NNTP-Posting-Date: 21 Jan 2001 11:24:30 GMT User-Agent: slrn/0.9.6.3 (Linux) Xref: supernews.google.com comp.lang.ada:4254 Date: 2001-01-21T11:24:30+00:00 List-Id: On Sat, 20 Jan 2001 15:00:46 GMT, Robert Dewar wrote: >Yes, that seems like a good compromise but in this case I >favor minimal markup, so that the documentation can still >be easily read with ordinary editing tools while working >with the source. One can imagine a universal environment >allowing fancy markup, and that would be fine, if and >when it is universal :-) One could of course in the spirit of Ada, choose a markup system that increases the readability without inflicting a lot of tag insertions :-) GtkAda uses a system that looks something like this: -- -- This widget implements a top level window. -- It is used as the base class for dialogs, ... [I have clipped off some of the text] -- A window can also be modal, i.e. grab all the mouse and keyboard -- events in the application while it is displayed. -- -- -- 1.2.6 [...] procedure Gtk_New (Window : out Gtk_Window; The_Type : in Gtk.Enums.Gtk_Window_Type := Gtk.Enums.Window_Toplevel); -- Create a new window. -- The_Type specifies the type of the window, and can be either a -- top level window, a dialog or a popup window. You will most often only -- need to use Window_Toplevel, the other types are mostly used internally -- by gtk+. -- A Popup window is used to display a temporary information window. It has -- no borders nor resizing handles. To see how it looks on the web look at: http://gtkada.eu.org/docs/gtkada_rm_113.html#SEC475 This could be used to make reference manuals, not tutorials nor spec documents, but think that that should be in a separate document. -- Preben Randhol ---------------- http://www.pvv.org/~randhol/ -- iMy favorite editor is Emacs!bcwVim -- vim best-editor.txt