|
From: Roger U. <ru...@us...> - 2008-08-29 06:15:58
|
Update of /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv17560/Demos Modified Files: Tag: py3k cmdserver.py demoutils.py dibdemo.py dlgtest.py dyndlg.py fontdemo.py guidemo.py hiertest.py menutest.py objdoc.py openGLDemo.py sliderdemo.py splittst.py threadedgui.py toolbar.py Log Message: Changes for Python 3 Index: dlgtest.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/dlgtest.py,v retrieving revision 1.1 retrieving revision 1.1.4.1 diff -C2 -d -r1.1 -r1.1.4.1 *** dlgtest.py 1 Sep 1999 23:33:35 -0000 1.1 --- dlgtest.py 29 Aug 2008 06:16:06 -0000 1.1.4.1 *************** *** 22,25 **** --- 22,26 ---- def __init__(self, modal=1): dialog.Dialog.__init__(self, IDD_SET_TABSTOPS) + self.counter=0 if modal: *************** *** 27,31 **** else: self.CreateWindow() ! def OnInitDialog(self): # Set the caption of the dialog itself. --- 28,32 ---- else: self.CreateWindow() ! def OnInitDialog(self): # Set the caption of the dialog itself. *************** *** 49,53 **** def OnNotify(self, controlid, code): if code==win32con.EN_CHANGE: ! print "Edit text changed!" return 1 # I handled this, so no need to call defaults! --- 50,54 ---- def OnNotify(self, controlid, code): if code==win32con.EN_CHANGE: ! print("Edit text changed!") return 1 # I handled this, so no need to call defaults! *************** *** 82,88 **** # In this case, we are interested in BN_CLICKED messages. self.HookNotify(self.OnNotify, win32con.BN_CLICKED) - def OnNotify(self, std, extra): ! print "OnNotify", std, extra # Some code that actually uses these objects. --- 83,88 ---- # In this case, we are interested in BN_CLICKED messages. self.HookNotify(self.OnNotify, win32con.BN_CLICKED) def OnNotify(self, std, extra): ! print("OnNotify", std, extra) # Some code that actually uses these objects. *************** *** 130,138 **** dlg = win32ui.CreateDialog(win32ui.IDD_DEBUGGER) dlg.datalist.append((win32ui.IDC_DBG_RADIOSTACK, "radio")) ! print "data list is ", dlg.datalist dlg.data['radio']=1 dlg.DoModal() ! print dlg.data['radio'] if __name__=='__main__': demo(1) --- 130,139 ---- dlg = win32ui.CreateDialog(win32ui.IDD_DEBUGGER) dlg.datalist.append((win32ui.IDC_DBG_RADIOSTACK, "radio")) ! print("data list is ", dlg.datalist) dlg.data['radio']=1 dlg.DoModal() ! print(dlg.data['radio']) if __name__=='__main__': demo(1) + Index: dibdemo.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/dibdemo.py,v retrieving revision 1.2 retrieving revision 1.2.2.1 diff -C2 -d -r1.2 -r1.2.2.1 *** dibdemo.py 9 Aug 2008 16:46:41 -0000 1.2 --- dibdemo.py 29 Aug 2008 06:16:06 -0000 1.2.2.1 *************** *** 38,44 **** if len(bPBM)>0: magic=f.readline() ! if magic <> "P6\n": ! print "The file is not a PBM format file" ! raise "Failed" # check magic? rowcollist=f.readline().split() --- 38,44 ---- if len(bPBM)>0: magic=f.readline() ! if magic != "P6\n": ! print("The file is not a PBM format file") ! raise ValueError("Failed - The file is not a PBM format file") # check magic? rowcollist=f.readline().split() *************** *** 66,69 **** if __name__=='__main__': ! import demoutils demoutils.NotAScript() \ No newline at end of file --- 66,69 ---- if __name__=='__main__': ! from . import demoutils demoutils.NotAScript() \ No newline at end of file Index: fontdemo.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/fontdemo.py,v retrieving revision 1.1 retrieving revision 1.1.4.1 diff -C2 -d -r1.1 -r1.1.4.1 *** fontdemo.py 1 Sep 1999 23:33:35 -0000 1.1 --- fontdemo.py 29 Aug 2008 06:16:06 -0000 1.1.4.1 *************** *** 61,65 **** self.width = right - left self.height = bottom - top ! x, y = self.width / 2, self.height / 2 dc.TextOut (x, y, self.text) --- 61,65 ---- self.width = right - left self.height = bottom - top ! x, y = self.width // 2, self.height // 2 dc.TextOut (x, y, self.text) *************** *** 75,79 **** if __name__=='__main__': ! import demoutils if demoutils.NeedGoodGUI(): FontDemo() --- 75,79 ---- if __name__=='__main__': ! from . import demoutils if demoutils.NeedGoodGUI(): FontDemo() Index: objdoc.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/objdoc.py,v retrieving revision 1.1 retrieving revision 1.1.4.1 diff -C2 -d -r1.1 -r1.1.4.1 *** objdoc.py 1 Sep 1999 23:33:35 -0000 1.1 --- objdoc.py 29 Aug 2008 06:16:06 -0000 1.1.4.1 *************** *** 15,19 **** # Look for existing open document for doc in self.GetDocumentList(): ! print "document is ", doc if doc.object is object: doc.GetFirstView().ActivateFrame() --- 15,19 ---- # Look for existing open document for doc in self.GetDocumentList(): ! print("document is ", doc) if doc.object is object: doc.GetFirstView().ActivateFrame() *************** *** 32,41 **** self.object = object def OnOpenDocument (self, name): ! raise error, "Should not be called if template strings set up correctly" return 0 class object_view (docview.EditView): def OnInitialUpdate (self): ! self.ReplaceSel("Object is %s" % `self.GetDocument().object`) def demo (): --- 32,41 ---- self.object = object def OnOpenDocument (self, name): ! raise error("Should not be called if template strings set up correctly") return 0 class object_view (docview.EditView): def OnInitialUpdate (self): ! self.ReplaceSel("Object is %s" % repr(self.GetDocument().object)) def demo (): *************** *** 45,49 **** if __name__=='__main__': ! import demoutils if demoutils.NeedGoodGUI(): demo() \ No newline at end of file --- 45,49 ---- if __name__=='__main__': ! from . import demoutils if demoutils.NeedGoodGUI(): demo() \ No newline at end of file Index: dyndlg.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/dyndlg.py,v retrieving revision 1.1 retrieving revision 1.1.4.1 diff -C2 -d -r1.1 -r1.1.4.1 *** dyndlg.py 1 Sep 1999 23:33:35 -0000 1.1 --- dyndlg.py 29 Aug 2008 06:16:06 -0000 1.1.4.1 *************** *** 27,31 **** style = win32con.DS_MODALFRAME | win32con.WS_POPUP | win32con.WS_VISIBLE | win32con.WS_CAPTION | win32con.WS_SYSMENU | win32con.DS_SETFONT cs = win32con.WS_CHILD | win32con.WS_VISIBLE ! dlg = [ ["Select Warehouse", (0, 0, 177, 93), style, None, (8, "MS Sans Serif")], ] dlg.append([130, "Current Warehouse:", -1, (7, 7, 69, 9), cs | win32con.SS_LEFT]) dlg.append([130, "ASTORIA", 128, (16, 17, 99, 7), cs | win32con.SS_LEFT]) --- 27,31 ---- style = win32con.DS_MODALFRAME | win32con.WS_POPUP | win32con.WS_VISIBLE | win32con.WS_CAPTION | win32con.WS_SYSMENU | win32con.DS_SETFONT cs = win32con.WS_CHILD | win32con.WS_VISIBLE ! dlg = [ ["Select Warehouse", (0, 0, 177, 93), style, 0, (8, "MS Sans Serif")], ] dlg.append([130, "Current Warehouse:", -1, (7, 7, 69, 9), cs | win32con.SS_LEFT]) dlg.append([130, "ASTORIA", 128, (16, 17, 99, 7), cs | win32con.SS_LEFT]) Index: demoutils.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/demoutils.py,v retrieving revision 1.1 retrieving revision 1.1.4.1 diff -C2 -d -r1.1 -r1.1.4.1 *** demoutils.py 1 Sep 1999 23:33:35 -0000 1.1 --- demoutils.py 29 Aug 2008 06:16:06 -0000 1.1.4.1 *************** *** 44,48 **** parent = win32ui.GetMainFrame().GetSafeHwnd() win32api.ShellExecute(parent, None, 'pythonwin.exe', '/app "%s"' % sys.argv[0], None, 1) ! except win32api.error, details: win32ui.MessageBox("Error executing command - %s" % (details), "Demos") --- 44,48 ---- parent = win32ui.GetMainFrame().GetSafeHwnd() win32api.ShellExecute(parent, None, 'pythonwin.exe', '/app "%s"' % sys.argv[0], None, 1) ! except win32api.error as details: win32ui.MessageBox("Error executing command - %s" % (details), "Demos") *************** *** 51,54 **** if __name__=='__main__': ! import demoutils demoutils.NotAScript() --- 51,54 ---- if __name__=='__main__': ! from . import demoutils demoutils.NotAScript() Index: threadedgui.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/threadedgui.py,v retrieving revision 1.3 retrieving revision 1.3.4.1 diff -C2 -d -r1.3 -r1.3.4.1 *** threadedgui.py 6 May 2000 08:29:58 -0000 1.3 --- threadedgui.py 29 Aug 2008 06:16:06 -0000 1.3.4.1 *************** *** 66,70 **** self.width = right - left self.height = bottom - top ! x, y = self.width / 2, self.height / 2 dc.TextOut (x, y, self.text[:self.index]) self.EndPaint(paintStruct) --- 66,70 ---- self.width = right - left self.height = bottom - top ! x, y = self.width // 2, self.height // 2 dc.TextOut (x, y, self.text[:self.index]) self.EndPaint(paintStruct) *************** *** 96,99 **** --- 96,100 ---- self._obj_ = win32ui.CreateMDIChild() self._obj_.AttachObject(self) + self._obj_.CreateWindow(None, title, style, rect, parent) rect = self.GetClientRect() *************** *** 111,114 **** --- 112,116 ---- rect = self.parentWindow.GetClientRect() rect = (0,0,rect[2]-rect[0], rect[3]-rect[1]) + self.child = FontWindow() self.child.Create("FontDemo", win32con.WS_CHILD | win32con.WS_VISIBLE, rect, self.parentWindow) *************** *** 150,154 **** def ThreadedDemo(): rect = win32ui.GetMainFrame().GetMDIClient().GetClientRect() ! rect = rect[0], rect[3]*3/4, rect[2]/4, rect[3] incr = rect[2] for i in range(4): --- 152,156 ---- def ThreadedDemo(): rect = win32ui.GetMainFrame().GetMDIClient().GetClientRect() ! rect = rect[0], int(rect[3]*3/4), int(rect[2]/4), rect[3] incr = rect[2] for i in range(4): Index: toolbar.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/toolbar.py,v retrieving revision 1.2 retrieving revision 1.2.4.1 diff -C2 -d -r1.2 -r1.2.4.1 *** toolbar.py 5 Mar 2005 03:15:25 -0000 1.2 --- toolbar.py 29 Aug 2008 06:16:06 -0000 1.2.4.1 *************** *** 47,51 **** return # Not handled if (idFrom==win32ui.ID_APP_ABOUT): ! return 0, ("It works!", idFrom, code) return None # not handled. --- 47,51 ---- return # Not handled if (idFrom==win32ui.ID_APP_ABOUT): ! return 0, ("It Works - in unicode yet!", idFrom, code) return None # not handled. *************** *** 57,67 **** def OnSize (self, params): ! print 'OnSize called with ', params def OnNext (self, id, cmd): ! print 'OnNext called' def OnPrevious (self, id, cmd): ! print 'OnPrevious called' msg = """\ --- 57,67 ---- def OnSize (self, params): ! print('OnSize called with ', params) def OnNext (self, id, cmd): ! print('OnNext called') def OnPrevious (self, id, cmd): ! print('OnPrevious called') msg = """\ Index: cmdserver.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/cmdserver.py,v retrieving revision 1.2 retrieving revision 1.2.4.1 diff -C2 -d -r1.2 -r1.2.4.1 *** cmdserver.py 4 Jun 2000 06:19:32 -0000 1.2 --- cmdserver.py 29 Aug 2008 06:16:06 -0000 1.2.4.1 *************** *** 7,11 **** from pywin.framework import winout ! import thread, sys import traceback --- 7,11 ---- from pywin.framework import winout ! import _thread, sys import traceback *************** *** 19,23 **** def register(self, writer): "Register the writer for the current thread" ! self.writers[thread.get_ident()] = writer if self.origStdOut is None: self.origStdOut = sys.stdout --- 19,23 ---- def register(self, writer): "Register the writer for the current thread" ! self.writers[_thread.get_ident()] = writer if self.origStdOut is None: self.origStdOut = sys.stdout *************** *** 27,31 **** "Remove the writer for the current thread, if any" try: ! del self.writers[thread.get_ident()] except KeyError: pass --- 27,31 ---- "Remove the writer for the current thread, if any" try: ! del self.writers[_thread.get_ident()] except KeyError: pass *************** *** 37,41 **** "Return the current thread's writer, default sys.stdout" try: ! return self.writers[thread.get_ident()] except KeyError: return self.origStdOut --- 37,41 ---- "Return the current thread's writer, default sys.stdout" try: ! return self.writers[_thread.get_ident()] except KeyError: return self.origStdOut *************** *** 48,52 **** num=1 while num<1000: ! print 'Hello there no ' + str(num) win32api.Sleep(50) num = num + 1 --- 48,52 ---- num=1 while num<1000: ! print('Hello there no ' + str(num)) win32api.Sleep(50) num = num + 1 *************** *** 65,74 **** # ServerThread((out, cmd, title, bCloseOnEnd)) # out = sys.stdout ! thread.start_new_thread( ServerThread, (out, cmd, title, bCloseOnEnd) ) def ServerThread(myout, cmd, title, bCloseOnEnd): try: writer.register(myout) ! print 'Executing "%s"\n' % cmd bOK = 1 try: --- 65,74 ---- # ServerThread((out, cmd, title, bCloseOnEnd)) # out = sys.stdout ! _thread.start_new_thread( ServerThread, (out, cmd, title, bCloseOnEnd) ) def ServerThread(myout, cmd, title, bCloseOnEnd): try: writer.register(myout) ! print('Executing "%s"\n' % cmd) bOK = 1 try: *************** *** 78,88 **** bOK = 0 if bOK: ! print "Command terminated without errors." else: t, v, tb = sys.exc_info() ! print t, ': ', v traceback.print_tb(tb) tb = None # prevent a cycle ! print "Command terminated with an unhandled exception" writer.unregister() if bOK and bCloseOnEnd: --- 78,88 ---- bOK = 0 if bOK: ! print("Command terminated without errors.") else: t, v, tb = sys.exc_info() ! print(t, ': ', v) traceback.print_tb(tb) tb = None # prevent a cycle ! print("Command terminated with an unhandled exception") writer.unregister() if bOK and bCloseOnEnd: *************** *** 92,99 **** except: t, v, tb = sys.exc_info() ! print t, ': ', v traceback.print_tb(tb) tb = None ! print "Thread failed" # assist for reloading (when debugging) - use only 1 tracer object, --- 92,99 ---- except: t, v, tb = sys.exc_info() ! print(t, ': ', v) traceback.print_tb(tb) tb = None ! print("Thread failed") # assist for reloading (when debugging) - use only 1 tracer object, *************** *** 104,108 **** # writer=ThreadWriter() if __name__=='__main__': ! import demoutils demoutils.NotAScript() --- 104,108 ---- # writer=ThreadWriter() if __name__=='__main__': ! from . import demoutils demoutils.NotAScript() Index: openGLDemo.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/openGLDemo.py,v retrieving revision 1.2 retrieving revision 1.2.4.1 diff -C2 -d -r1.2 -r1.2.4.1 *** openGLDemo.py 11 Mar 2000 00:56:33 -0000 1.2 --- openGLDemo.py 29 Aug 2008 06:16:06 -0000 1.2.4.1 *************** *** 7,12 **** from OpenGL.GLU import * except ImportError: ! print "The OpenGL extensions do not appear to be installed." ! print "This Pythonwin demo can not run" sys.exit(1) --- 7,12 ---- from OpenGL.GLU import * except ImportError: ! print("The OpenGL extensions do not appear to be installed.") ! print("This Pythonwin demo can not run") sys.exit(1) *************** *** 39,43 **** ! threeto8 = [0, 0111>>1, 0222>>1, 0333>>1, 0444>>1, 0555>>1, 0666>>1, 0377] twoto8 = [0, 0x55, 0xaa, 0xff] oneto8 = [0, 255] --- 39,43 ---- ! threeto8 = [0, 0o111>>1, 0o222>>1, 0o333>>1, 0o444>>1, 0o555>>1, 0o666>>1, 0o377] twoto8 = [0, 0x55, 0xaa, 0xff] oneto8 = [0, 255] Index: menutest.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/menutest.py,v retrieving revision 1.1 retrieving revision 1.1.4.1 diff -C2 -d -r1.1 -r1.1.4.1 *** menutest.py 1 Sep 1999 23:33:35 -0000 1.1 --- menutest.py 29 Aug 2008 06:16:06 -0000 1.1.4.1 *************** *** 4,8 **** if __name__=='__main__': ! import demoutils if demoutils.NeedGoodGUI(): win=interact.edit.currentView.GetParent() --- 4,8 ---- if __name__=='__main__': ! from . import demoutils if demoutils.NeedGoodGUI(): win=interact.edit.currentView.GetParent() *************** *** 10,12 **** id=menu.GetMenuItemID(6) menu.EnableMenuItem(id,win32con.MF_BYCOMMAND|win32con.MF_GRAYED) ! print "The interactive window's 'Close' menu item is now disabled." \ No newline at end of file --- 10,12 ---- id=menu.GetMenuItemID(6) menu.EnableMenuItem(id,win32con.MF_BYCOMMAND|win32con.MF_GRAYED) ! print("The interactive window's 'Close' menu item is now disabled.") \ No newline at end of file Index: hiertest.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/hiertest.py,v retrieving revision 1.1 retrieving revision 1.1.4.1 diff -C2 -d -r1.1 -r1.1.4.1 *** hiertest.py 1 Sep 1999 23:33:35 -0000 1.1 --- hiertest.py 29 Aug 2008 06:16:06 -0000 1.1.4.1 *************** *** 17,21 **** def GetSubList(self, item): if os.path.isdir(item): ! ret = map(lambda path, base=item: os.path.join(base, path), os.listdir(item)) else: ret = None --- 17,21 ---- def GetSubList(self, item): if os.path.isdir(item): ! ret = [os.path.join(item, fname) for fname in os.listdir(item)] else: ret = None *************** *** 80,84 **** try: return "%-20s %d bytes" % (os.path.basename(self.filename), os.stat(self.filename)[6]) ! except os.error, details: return "%-20s - %s" % (self.filename, details[1]) --- 80,84 ---- try: return "%-20s %d bytes" % (os.path.basename(self.filename), os.stat(self.filename)[6]) ! except os.error as details: return "%-20s - %s" % (self.filename, details[1]) *************** *** 102,104 **** demoboth() else: ! demodlg() \ No newline at end of file --- 102,104 ---- demoboth() else: ! demodlg() Index: sliderdemo.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/sliderdemo.py,v retrieving revision 1.1 retrieving revision 1.1.4.1 diff -C2 -d -r1.1 -r1.1.4.1 *** sliderdemo.py 4 Oct 1999 08:39:31 -0000 1.1 --- sliderdemo.py 29 Aug 2008 06:16:06 -0000 1.1.4.1 *************** *** 39,43 **** return rc def OnCancel(self): ! print "The slider control is at position", self.slider.GetPos() self._obj_.OnCancel() ### --- 39,43 ---- return rc def OnCancel(self): ! print("The slider control is at position", self.slider.GetPos()) self._obj_.OnCancel() ### Index: guidemo.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/guidemo.py,v retrieving revision 1.3 retrieving revision 1.3.4.1 diff -C2 -d -r1.3 -r1.3.4.1 *** guidemo.py 11 Mar 2000 00:56:06 -0000 1.3 --- guidemo.py 29 Aug 2008 06:16:06 -0000 1.3.4.1 *************** *** 25,29 **** try: # seeif I can locate the demo files. ! import fontdemo except ImportError: # else put the demos direectory on the path (if not already) --- 25,29 ---- try: # seeif I can locate the demo files. ! from . import fontdemo except ImportError: # else put the demos direectory on the path (if not already) *************** *** 31,35 **** instPath = regutil.GetRegistryDefaultValue(regutil.BuildDefaultPythonKey() + "\\InstallPath") except win32api.error: ! print "The InstallPath can not be located, and the Demos directory is not on the path" instPath="." --- 31,35 ---- instPath = regutil.GetRegistryDefaultValue(regutil.BuildDefaultPythonKey() + "\\InstallPath") except win32api.error: ! print("The InstallPath can not be located, and the Demos directory is not on the path") instPath="." *************** *** 40,44 **** else: sys.path.append(demosDir) ! import fontdemo import sys --- 40,44 ---- else: sys.path.append(demosDir) ! from . import fontdemo import sys *************** *** 46,52 **** for name, cmd in demos: try: ! exec cmd except: ! print "Demo of %s failed - %s:%s" % (cmd,sys.exc_info()[0], sys.exc_info()[1]) return # Otherwise allow the user to select the demo to run --- 46,52 ---- for name, cmd in demos: try: ! exec(cmd) except: ! print("Demo of %s failed - %s:%s" % (cmd,sys.exc_info()[0], sys.exc_info()[1])) return # Otherwise allow the user to select the demo to run *************** *** 59,68 **** title, cmd = demos[rc] try: ! exec cmd except: ! print "Demo of %s failed - %s:%s" % (title,sys.exc_info()[0], sys.exc_info()[1]) if __name__==__main__.__name__: ! import demoutils if demoutils.NeedGoodGUI(): demo() --- 59,68 ---- title, cmd = demos[rc] try: ! exec(cmd) except: ! print("Demo of %s failed - %s:%s" % (title,sys.exc_info()[0], sys.exc_info()[1])) if __name__==__main__.__name__: ! from . import demoutils if demoutils.NeedGoodGUI(): demo() Index: splittst.py =================================================================== RCS file: /cvsroot/pywin32/pywin32/Pythonwin/pywin/Demos/splittst.py,v retrieving revision 1.2 retrieving revision 1.2.4.1 diff -C2 -d -r1.2 -r1.2.4.1 *** splittst.py 11 Mar 2000 00:57:08 -0000 1.2 --- splittst.py 29 Aug 2008 06:16:06 -0000 1.2.4.1 *************** *** 18,23 **** frame_rect = self.GetWindowRect() size = ((frame_rect[2] - frame_rect[0]), ! (frame_rect[3] - frame_rect[1])/2) ! sub_size = (size[0]/2, size[1]) splitter.CreateStatic (self, 2, 1) self.v1 = win32ui.CreateEditView(doc) --- 18,23 ---- frame_rect = self.GetWindowRect() size = ((frame_rect[2] - frame_rect[0]), ! (frame_rect[3] - frame_rect[1])//2) ! sub_size = (size[0]//2, size[1]) splitter.CreateStatic (self, 2, 1) self.v1 = win32ui.CreateEditView(doc) |
