From a39b92f278f6d1530cb151875b445185951634df Mon Sep 17 00:00:00 2001 From: tpearson Date: Wed, 10 Mar 2010 20:44:18 +0000 Subject: Added KDE3 version of POTraceGUI git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/potracegui@1101754 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/en/Makefile.am | 2 + doc/en/index.docbook | 555 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 557 insertions(+) create mode 100644 doc/en/Makefile.am create mode 100644 doc/en/index.docbook (limited to 'doc/en') diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am new file mode 100644 index 0000000..de43944 --- /dev/null +++ b/doc/en/Makefile.am @@ -0,0 +1,2 @@ +KDE_DOCS = potracegui +KDE_LANG = en diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..4be7a03 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,555 @@ + +potracegui 2.0"> + + + + + + + +]> + + + + + + + + + + + + + + +The &potracegui; Handbook + + + + + +Antonio Fasolato + +
Antonio.Fasolato@poste.it
+ + + + + + + +1999 +%{YEAR} +Antonio Fasolato + + + +&FDLNotice; + + + +2001-10-18 +2.0 + + + + + +&potracegui; is an application specially designed to do nothing you would +ever want. + + + + + + +KDE +potracegui +nothing +nothing else + + + + + + + +Introduction + + + + +&potracegui; is a program that lets you do absolutely nothing. Please report +any problems or feature requests to the &kde; mailing lists. + + + + +Using &potracegui; + + + + + + + + +Here's a screenshot of &potracegui; + + + + + + + + + Screenshot + + + + + + + +More &potracegui; features + +It slices! It dices! and it comes with a free toaster! + +The Squiggle Tool + + + + + + + + Squiggle + + is used to draw squiggly lines all over +the &potracegui; main window. It's not a bug, it's a feature! + + + + + + +Command Reference + + + + +The main &potracegui; window + + +The File Menu + + + + + +&Ctrl;N + +File +New + +Creates a new document + + + + +&Ctrl;S + +File +Save + +Saves the document + + + + +&Ctrl;Q + +File +Quit + +Quits &potracegui; + + + + + + + +The <guimenu>Help</guimenu> Menu + + + + + + +&help.menu.documentation; + + + + + + + +Developer's Guide to &potracegui; + + + + +Programming &potracegui; plugins is a joy to behold. Just read through the next +66 pages of API's to learn how! + + + + + + +XtUnmanageChildren +Xt - Geometry Management + + +XtUnmanageChildren + +remove a list of children from a parent widget's managed +list. +widgetsremoving +XtUnmanageChildren + + + + + +4 March 1996 + + +void XtUnmanageChildren(children, num_children) + WidgetList children; + Cardinal num_children; + + + +Inputs + + +children + + +Specifies an array of child widgets. Each child must be of +class RectObj or any subclass thereof. + + + + +num_children + + +Specifies the number of elements in children. + + + + + + + +Description + +XtUnmanageChildren() unmaps the specified widgets +and removes them from their parent's geometry management. +The widgets will disappear from the screen, and (depending +on its parent) may no longer have screen space allocated for +them. + +Each of the widgets in the children array must have +the same parent. + +See the “Algorithm” section below for full details of the +widget unmanagement procedure. + + + + +Usage +Unmanaging widgets is the usual method for temporarily +making them invisible. They can be re-managed with +XtManageChildren(). + +You can unmap a widget, but leave it under geometry +management by calling XtUnmapWidget(). You can +destroy a widget's window without destroying the widget by +calling XtUnrealizeWidget(). You can destroy a +widget completely with XtDestroyWidget(). + +If you are only going to unmanage a single widget, it is +more convenient to call XtUnmanageChild(). It is +often more convenient to call XtUnmanageChild() +several times than it is to declare and initialize an array +of widgets to pass to XtUnmanageChildren(). Calling +XtUnmanageChildren() is more efficient, however, +because it only calls the parent's change_managed() +method once. + + + + +Algorithm + +XtUnmanageChildren() performs the following: + + + +- + + +Ignores the child if it already is unmanaged or is being +destroyed. + + + + +- + + +Otherwise, if the child is realized, it makes it nonvisible +by unmapping it. + + + + + + + + + +Structures +The WidgetList type is simply an array of widgets: + +typedef Widget *WidgetList; + + + + + + + +Questions and Answers + + + +&reporting.bugs; +&updating.documentation; + + + + +My Mouse doesn't work. How do I quit &potracegui;? + + +You silly goose! Check out the Commands +Section for the answer. + + + + +Why can't I twiddle my documents? + + +You can only twiddle your documents if you have the foobar.lib +installed. + + + + + + + + + +Credits and License + + +&potracegui; + + +Program copyright %{YEAR} Antonio Fasolato Antonio.Fasolato@poste.it + + +Contributors: + +Konqui the KDE Dragon konqui@kde.org + +Tux the Linux Penguin tux@linux.org + + + + + +Documentation copyright %{YEAR} Antonio Fasolato Antonio.Fasolato@poste.it + + + + +&underFDL; + + + +&underGPL; +&underBSDLicense; +&underArtisticLicense; +&underX11License; + + + + +Installation + + +How to obtain &potracegui; + + + +&install.intro.documentation; + + + + +Requirements + + + + +In order to successfully use &potracegui;, you need &kde; 1.1. Foobar.lib is +required in order to support the advanced &potracegui; features. &potracegui; uses +about 5 megs of memory to run, but this may vary depending on your +platform and configuration. + + + +All required libraries as well as &potracegui; itself can be found +on The &potracegui; home page. + + + + +You can find a list of changes at http://apps.kde.org/potracegui. + + + + +Compilation and Installation + + + + + +&install.compile.documentation; + + + + +Configuration + +Don't forget to tell your system to start the dtd +dicer-toaster daemon first, or &potracegui; won't work ! + + + + + +&documentation.index; + + + + -- cgit v1.2.1