--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/eric6/Documentation/Source/install.html Sun Apr 14 15:09:21 2019 +0200
@@ -0,0 +1,634 @@
+<!DOCTYPE html>
+<html><head>
+<title>install</title>
+<meta charset="UTF-8">
+<style>
+body {
+ background: #EDECE6;
+ margin: 0em 1em 10em 1em;
+ color: black;
+}
+
+h1 { color: white; background: #85774A; }
+h2 { color: white; background: #85774A; }
+h3 { color: white; background: #9D936E; }
+h4 { color: white; background: #9D936E; }
+
+a { color: #BA6D36; }
+
+</style>
+</head>
+<body><a NAME="top" ID="top"></a>
+<h1>install</h1>
+<p>
+Installation script for the eric6 IDE and all eric6 related tools.
+</p>
+<h3>Global Attributes</h3>
+<table>
+<tr><td>BlackLists</td></tr><tr><td>PlatformsBlackLists</td></tr><tr><td>PythonMarkers</td></tr><tr><td>PythonTextMarkers</td></tr><tr><td>apisDir</td></tr><tr><td>cfg</td></tr><tr><td>configLength</td></tr><tr><td>configName</td></tr><tr><td>currDir</td></tr><tr><td>defaultMacAppBundleName</td></tr><tr><td>defaultMacAppBundlePath</td></tr><tr><td>defaultMacPythonExe</td></tr><tr><td>distDir</td></tr><tr><td>doCleanDesktopLinks</td></tr><tr><td>doCleanup</td></tr><tr><td>doCompile</td></tr><tr><td>forceCleanDesktopLinks</td></tr><tr><td>includePythonVariant</td></tr><tr><td>installApis</td></tr><tr><td>macAppBundleName</td></tr><tr><td>macAppBundlePath</td></tr><tr><td>macPythonExe</td></tr><tr><td>modDir</td></tr><tr><td>platBinDir</td></tr><tr><td>platBinDirOld</td></tr><tr><td>progLanguages</td></tr><tr><td>progName</td></tr><tr><td>pyModDir</td></tr><tr><td>pyqtOverride</td></tr><tr><td>pyqtVariant</td></tr><tr><td>sourceDir</td></tr>
+</table>
+<h3>Classes</h3>
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Functions</h3>
+<table>
+<tr>
+<td><a href="#__pyName">__pyName</a></td>
+<td>Local function to create the Python source file name for the compiled .ui file.</td>
+</tr><tr>
+<td><a href="#cleanUp">cleanUp</a></td>
+<td>Uninstall the old eric files.</td>
+</tr><tr>
+<td><a href="#cleanUpLinuxSpecifics">cleanUpLinuxSpecifics</a></td>
+<td>Clean up Linux specific files.</td>
+</tr><tr>
+<td><a href="#cleanUpMacAppBundle">cleanUpMacAppBundle</a></td>
+<td>Uninstall the macOS application bundle.</td>
+</tr><tr>
+<td><a href="#cleanUpWindowsLinks">cleanUpWindowsLinks</a></td>
+<td>Clean up the Desktop and Start Menu entries for Windows.</td>
+</tr><tr>
+<td><a href="#cleanupSource">cleanupSource</a></td>
+<td>Cleanup the sources directory to get rid of leftover files and directories.</td>
+</tr><tr>
+<td><a href="#compileUiFiles">compileUiFiles</a></td>
+<td>Compile the .ui files to Python sources.</td>
+</tr><tr>
+<td><a href="#copyAppStreamFile">copyAppStreamFile</a></td>
+<td>Modify an appstream file and write it to its destination.</td>
+</tr><tr>
+<td><a href="#copyDesktopFile">copyDesktopFile</a></td>
+<td>Modify a desktop file and write it to its destination.</td>
+</tr><tr>
+<td><a href="#copyToFile">copyToFile</a></td>
+<td>Copy a string to a file.</td>
+</tr><tr>
+<td><a href="#copyTree">copyTree</a></td>
+<td>Copy Python, translation, documentation, wizards configuration, designer template files and DTDs of a directory tree.</td>
+</tr><tr>
+<td><a href="#createConfig">createConfig</a></td>
+<td>Create a config file with the respective config entries.</td>
+</tr><tr>
+<td><a href="#createGlobalPluginsDir">createGlobalPluginsDir</a></td>
+<td>Create the global plugins directory, if it doesn't exist.</td>
+</tr><tr>
+<td><a href="#createInstallConfig">createInstallConfig</a></td>
+<td>Create the installation config dictionary.</td>
+</tr><tr>
+<td><a href="#createLinuxSpecifics">createLinuxSpecifics</a></td>
+<td>Install Linux specific files.</td>
+</tr><tr>
+<td><a href="#createMacAppBundle">createMacAppBundle</a></td>
+<td>Create a Mac application bundle.</td>
+</tr><tr>
+<td><a href="#createPyWrapper">createPyWrapper</a></td>
+<td>Create an executable wrapper for a Python script.</td>
+</tr><tr>
+<td><a href="#createWindowsLinks">createWindowsLinks</a></td>
+<td>Create Desktop and Start Menu links.</td>
+</tr><tr>
+<td><a href="#createWindowsShortcut">createWindowsShortcut</a></td>
+<td>Create Windows shortcut.</td>
+</tr><tr>
+<td><a href="#determinePyQtVariant">determinePyQtVariant</a></td>
+<td>Module function to determine the PyQt variant to be used.</td>
+</tr><tr>
+<td><a href="#doDependancyChecks">doDependancyChecks</a></td>
+<td>Perform some dependency checks.</td>
+</tr><tr>
+<td><a href="#exit">exit</a></td>
+<td>Exit the install script.</td>
+</tr><tr>
+<td><a href="#getWinregEntry">getWinregEntry</a></td>
+<td>Function to get an entry from the Windows Registry.</td>
+</tr><tr>
+<td><a href="#initGlobals">initGlobals</a></td>
+<td>Module function to set the values of globals that need more than a simple assignment.</td>
+</tr><tr>
+<td><a href="#installEric">installEric</a></td>
+<td>Actually perform the installation steps.</td>
+</tr><tr>
+<td><a href="#main">main</a></td>
+<td>The main function of the script.</td>
+</tr><tr>
+<td><a href="#pipInstall">pipInstall</a></td>
+<td>Install the given package via pip.</td>
+</tr><tr>
+<td><a href="#prepareInfoFile">prepareInfoFile</a></td>
+<td>Function to prepare an Info.py file when installing from source.</td>
+</tr><tr>
+<td><a href="#shutilCopy">shutilCopy</a></td>
+<td>Wrapper function around shutil.copy() to ensure the permissions.</td>
+</tr><tr>
+<td><a href="#usage">usage</a></td>
+<td>Display a usage message and exit.</td>
+</tr><tr>
+<td><a href="#windowsDesktopEntries">windowsDesktopEntries</a></td>
+<td>Function to generate data for the Windows Desktop links.</td>
+</tr><tr>
+<td><a href="#windowsDesktopNames">windowsDesktopNames</a></td>
+<td>Function to generate the link names for the Windows Desktop.</td>
+</tr><tr>
+<td><a href="#windowsProgramsEntry">windowsProgramsEntry</a></td>
+<td>Function to generate the name of the Start Menu top entry.</td>
+</tr><tr>
+<td><a href="#wrapperNames">wrapperNames</a></td>
+<td>Create the platform specific names for the wrapper script.</td>
+</tr>
+</table>
+<hr /><hr />
+<a NAME="__pyName" ID="__pyName"></a>
+<h2>__pyName</h2>
+<b>__pyName</b>(<i>py_dir, py_file</i>)
+<p>
+ Local function to create the Python source file name for the compiled
+ .ui file.
+</p><dl>
+<dt><i>py_dir</i></dt>
+<dd>
+suggested name of the directory (string)
+</dd><dt><i>py_file</i></dt>
+<dd>
+suggested name for the compile source file (string)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+tuple of directory name (string) and source file name (string)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="cleanUp" ID="cleanUp"></a>
+<h2>cleanUp</h2>
+<b>cleanUp</b>(<i></i>)
+<p>
+ Uninstall the old eric files.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="cleanUpLinuxSpecifics" ID="cleanUpLinuxSpecifics"></a>
+<h2>cleanUpLinuxSpecifics</h2>
+<b>cleanUpLinuxSpecifics</b>(<i></i>)
+<p>
+ Clean up Linux specific files.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="cleanUpMacAppBundle" ID="cleanUpMacAppBundle"></a>
+<h2>cleanUpMacAppBundle</h2>
+<b>cleanUpMacAppBundle</b>(<i></i>)
+<p>
+ Uninstall the macOS application bundle.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="cleanUpWindowsLinks" ID="cleanUpWindowsLinks"></a>
+<h2>cleanUpWindowsLinks</h2>
+<b>cleanUpWindowsLinks</b>(<i></i>)
+<p>
+ Clean up the Desktop and Start Menu entries for Windows.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="cleanupSource" ID="cleanupSource"></a>
+<h2>cleanupSource</h2>
+<b>cleanupSource</b>(<i>dirName</i>)
+<p>
+ Cleanup the sources directory to get rid of leftover files
+ and directories.
+</p><dl>
+<dt><i>dirName</i></dt>
+<dd>
+name of the directory to prune (string)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="compileUiFiles" ID="compileUiFiles"></a>
+<h2>compileUiFiles</h2>
+<b>compileUiFiles</b>(<i></i>)
+<p>
+ Compile the .ui files to Python sources.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="copyAppStreamFile" ID="copyAppStreamFile"></a>
+<h2>copyAppStreamFile</h2>
+<b>copyAppStreamFile</b>(<i>src, dst, marker</i>)
+<p>
+ Modify an appstream file and write it to its destination.
+</p><dl>
+<dt><i>src</i></dt>
+<dd>
+source file name (string)
+</dd><dt><i>dst</i></dt>
+<dd>
+destination file name (string)
+</dd><dt><i>marker</i></dt>
+<dd>
+marker to be used (string)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="copyDesktopFile" ID="copyDesktopFile"></a>
+<h2>copyDesktopFile</h2>
+<b>copyDesktopFile</b>(<i>src, dst, marker</i>)
+<p>
+ Modify a desktop file and write it to its destination.
+</p><dl>
+<dt><i>src</i></dt>
+<dd>
+source file name (string)
+</dd><dt><i>dst</i></dt>
+<dd>
+destination file name (string)
+</dd><dt><i>marker</i></dt>
+<dd>
+marker to be used (string)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="copyToFile" ID="copyToFile"></a>
+<h2>copyToFile</h2>
+<b>copyToFile</b>(<i>name, text</i>)
+<p>
+ Copy a string to a file.
+</p><dl>
+<dt><i>name</i></dt>
+<dd>
+the name of the file.
+</dd><dt><i>text</i></dt>
+<dd>
+the contents to copy to the file.
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="copyTree" ID="copyTree"></a>
+<h2>copyTree</h2>
+<b>copyTree</b>(<i>src, dst, filters, excludeDirs=None, excludePatterns=None</i>)
+<p>
+ Copy Python, translation, documentation, wizards configuration,
+ designer template files and DTDs of a directory tree.
+</p><dl>
+<dt><i>src</i></dt>
+<dd>
+name of the source directory
+</dd><dt><i>dst</i></dt>
+<dd>
+name of the destination directory
+</dd><dt><i>filters</i></dt>
+<dd>
+list of filter pattern determining the files to be copied
+</dd><dt><i>excludeDirs</i></dt>
+<dd>
+list of (sub)directories to exclude from copying
+</dd><dt><i>excludePatterns=</i></dt>
+<dd>
+list of filter pattern determining the files to
+ be skipped
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="createConfig" ID="createConfig"></a>
+<h2>createConfig</h2>
+<b>createConfig</b>(<i></i>)
+<p>
+ Create a config file with the respective config entries.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="createGlobalPluginsDir" ID="createGlobalPluginsDir"></a>
+<h2>createGlobalPluginsDir</h2>
+<b>createGlobalPluginsDir</b>(<i></i>)
+<p>
+ Create the global plugins directory, if it doesn't exist.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="createInstallConfig" ID="createInstallConfig"></a>
+<h2>createInstallConfig</h2>
+<b>createInstallConfig</b>(<i></i>)
+<p>
+ Create the installation config dictionary.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="createLinuxSpecifics" ID="createLinuxSpecifics"></a>
+<h2>createLinuxSpecifics</h2>
+<b>createLinuxSpecifics</b>(<i></i>)
+<p>
+ Install Linux specific files.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="createMacAppBundle" ID="createMacAppBundle"></a>
+<h2>createMacAppBundle</h2>
+<b>createMacAppBundle</b>(<i>pydir</i>)
+<p>
+ Create a Mac application bundle.
+</p><dl>
+<dt><i>pydir</i> (str)</dt>
+<dd>
+the name of the directory where the Python script will
+ eventually be installed
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="createPyWrapper" ID="createPyWrapper"></a>
+<h2>createPyWrapper</h2>
+<b>createPyWrapper</b>(<i>pydir, wfile, isGuiScript=True</i>)
+<p>
+ Create an executable wrapper for a Python script.
+</p><dl>
+<dt><i>pydir</i></dt>
+<dd>
+the name of the directory where the Python script will
+ eventually be installed (string)
+</dd><dt><i>wfile</i></dt>
+<dd>
+the basename of the wrapper (string)
+</dd><dt><i>isGuiScript</i></dt>
+<dd>
+flag indicating a wrapper script for a GUI
+ application (boolean)
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+the platform specific name of the wrapper (string)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="createWindowsLinks" ID="createWindowsLinks"></a>
+<h2>createWindowsLinks</h2>
+<b>createWindowsLinks</b>(<i></i>)
+<p>
+ Create Desktop and Start Menu links.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="createWindowsShortcut" ID="createWindowsShortcut"></a>
+<h2>createWindowsShortcut</h2>
+<b>createWindowsShortcut</b>(<i>linkPath, targetPath, iconPath</i>)
+<p>
+ Create Windows shortcut.
+</p><dl>
+<dt><i>linkPath</i> (str)</dt>
+<dd>
+path of the shortcut file
+</dd><dt><i>targetPath</i> (str)</dt>
+<dd>
+path the shortcut shall point to
+</dd><dt><i>iconPath</i> (str)</dt>
+<dd>
+path of the icon file
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="determinePyQtVariant" ID="determinePyQtVariant"></a>
+<h2>determinePyQtVariant</h2>
+<b>determinePyQtVariant</b>(<i></i>)
+<p>
+ Module function to determine the PyQt variant to be used.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="doDependancyChecks" ID="doDependancyChecks"></a>
+<h2>doDependancyChecks</h2>
+<b>doDependancyChecks</b>(<i></i>)
+<p>
+ Perform some dependency checks.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="exit" ID="exit"></a>
+<h2>exit</h2>
+<b>exit</b>(<i>rcode=0</i>)
+<p>
+ Exit the install script.
+</p><dl>
+<dt><i>rcode</i></dt>
+<dd>
+result code to report back (integer)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="getWinregEntry" ID="getWinregEntry"></a>
+<h2>getWinregEntry</h2>
+<b>getWinregEntry</b>(<i>name, path</i>)
+<p>
+ Function to get an entry from the Windows Registry.
+</p><dl>
+<dt><i>name</i> (str)</dt>
+<dd>
+variable name
+</dd><dt><i>path</i> (str)</dt>
+<dd>
+registry path of the variable
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+value of requested registry variable
+</dd>
+</dl><dl>
+<dt>Return Type:</dt>
+<dd>
+any
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="initGlobals" ID="initGlobals"></a>
+<h2>initGlobals</h2>
+<b>initGlobals</b>(<i></i>)
+<p>
+ Module function to set the values of globals that need more than a
+ simple assignment.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="installEric" ID="installEric"></a>
+<h2>installEric</h2>
+<b>installEric</b>(<i></i>)
+<p>
+ Actually perform the installation steps.
+</p><dl>
+<dt>Returns:</dt>
+<dd>
+result code (integer)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="main" ID="main"></a>
+<h2>main</h2>
+<b>main</b>(<i>argv</i>)
+<p>
+ The main function of the script.
+</p><dl>
+<dt><i>argv</i> (list of str)</dt>
+<dd>
+list of command line arguments
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="pipInstall" ID="pipInstall"></a>
+<h2>pipInstall</h2>
+<b>pipInstall</b>(<i>packageName, message</i>)
+<p>
+ Install the given package via pip.
+</p><dl>
+<dt><i>packageName</i> (str)</dt>
+<dd>
+name of the package to be installed
+</dd><dt><i>message</i> (str)</dt>
+<dd>
+message to be shown to the user
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+flag indicating a successful installation
+</dd>
+</dl><dl>
+<dt>Return Type:</dt>
+<dd>
+bool
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="prepareInfoFile" ID="prepareInfoFile"></a>
+<h2>prepareInfoFile</h2>
+<b>prepareInfoFile</b>(<i>fileName</i>)
+<p>
+ Function to prepare an Info.py file when installing from source.
+</p><dl>
+<dt><i>fileName</i></dt>
+<dd>
+name of the Python file containing the info (string)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="shutilCopy" ID="shutilCopy"></a>
+<h2>shutilCopy</h2>
+<b>shutilCopy</b>(<i>src, dst, perm=0o644</i>)
+<p>
+ Wrapper function around shutil.copy() to ensure the permissions.
+</p><dl>
+<dt><i>src</i></dt>
+<dd>
+source file name (string)
+</dd><dt><i>dst</i></dt>
+<dd>
+destination file name or directory name (string)
+</dd><dt><i>perm=</i></dt>
+<dd>
+permissions to be set (integer)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="usage" ID="usage"></a>
+<h2>usage</h2>
+<b>usage</b>(<i>rcode=2</i>)
+<p>
+ Display a usage message and exit.
+</p><dl>
+<dt><i>rcode</i></dt>
+<dd>
+the return code passed back to the calling process.
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="windowsDesktopEntries" ID="windowsDesktopEntries"></a>
+<h2>windowsDesktopEntries</h2>
+<b>windowsDesktopEntries</b>(<i></i>)
+<p>
+ Function to generate data for the Windows Desktop links.
+</p><dl>
+<dt>Returns:</dt>
+<dd>
+list of tuples containing the desktop link name,
+ the link target and the icon target
+</dd>
+</dl><dl>
+<dt>Return Type:</dt>
+<dd>
+list of tuples of (str, str, str)
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="windowsDesktopNames" ID="windowsDesktopNames"></a>
+<h2>windowsDesktopNames</h2>
+<b>windowsDesktopNames</b>(<i></i>)
+<p>
+ Function to generate the link names for the Windows Desktop.
+</p><dl>
+<dt>Returns:</dt>
+<dd>
+list of desktop link names
+</dd>
+</dl><dl>
+<dt>Return Type:</dt>
+<dd>
+list of str
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="windowsProgramsEntry" ID="windowsProgramsEntry"></a>
+<h2>windowsProgramsEntry</h2>
+<b>windowsProgramsEntry</b>(<i></i>)
+<p>
+ Function to generate the name of the Start Menu top entry.
+</p><dl>
+<dt>Returns:</dt>
+<dd>
+name of the Start Menu top entry
+</dd>
+</dl><dl>
+<dt>Return Type:</dt>
+<dd>
+str
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr /><hr />
+<a NAME="wrapperNames" ID="wrapperNames"></a>
+<h2>wrapperNames</h2>
+<b>wrapperNames</b>(<i>dname, wfile</i>)
+<p>
+ Create the platform specific names for the wrapper script.
+</p><dl>
+<dt><i>dname</i></dt>
+<dd>
+name of the directory to place the wrapper into
+</dd><dt><i>wfile</i></dt>
+<dd>
+basename (without extension) of the wrapper script
+</dd>
+</dl><dl>
+<dt>Returns:</dt>
+<dd>
+the names of the wrapper scripts
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr />
+</body></html>
\ No newline at end of file
