initial commit based on content from salvis.com

Author: PhilippSalvisberg

FAQ.md

@@ -0,0 +1,44 @@
+# Frequently Asked Questions
+
+## I cannot install any extension on macOS
+
+Maybe you’ve run into a SQL Developer bug on macOS. See [this blog post](https://www.salvis.com/blog/2015/05/05/cannot-install-extensions-in-sql-developer-4-on-mac-os-x/) for problem details and solution.
+
+## I cannot install any extension on Windows
+
+Have you installed SQL Developer in `C:\Program Files` or `C:\Program Files(x86)`? In this case the files are read-only for a standard Windows user.
+
+To solve the problem start SQL Developer as Administrator or install SQL Developer in an user folder. While the former requires local administrator rights, the latter is always feasible.
+
+## I’ve got errors in the extensions log after installation. What’s wrong?
+
+You are probably using an outdated version of SQL Developer. In this case you see after a restart an error message in the Extensions-Log similar to the following:
+
+![Extensions Log](images/extensions-log.png)
+
+SQL Developer 1.x, 2.x and 3.x are based on the Extension Software Development Kit (ESDK) version 1. SQL Developer 4.x requires the use of ESDK version 2. Unfortunately these versions are not compatible. So we decided to support the newest SQL Developer version only.
+
+Please update to SQL Developer 4.x or later since this is a prerequisite for this extension.
+
+## Is unwrapping code processed by the PL/SQL Wrapper of Oracle7, Oracle8, Oracle8i or Oracle9i supported?
+
+No. Beginning with Oracle Database 10g, the algorithm of the PL/SQL Wrapper has changed. PL/SQL Unwrapper currently supports only the latest algorithm used in the PL/SQL Wrapper of Oracle Database 10g, 11g, 12c, 18c and 19c.
+
+## Unwrap does nothing. What’s wrong?
+
+Please check the Logging Page in the Logging window. One of the following error messages is expected:
+
+- Could not unwrap this code. Most probably it was not wrapped with the Oracle 10g, 11g or 12c wrap utility.
+- SHA-1 hash values do not match. Expected ‘…’  but got ‘…’. Cannot unwrap code.
+
+If you’ve got the latter message, the wrapped code has most probably been modified.
+
+## What has changed in the latest version?
+
+See the [release information](https://github.com/Trivadis/plsql-unwrapper-sqldev/releases) for each version.
+
+## What are the licensing terms?
+
+The preview/trial version of PL/SQL Cop is licensed under the Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License. You may obtain a copy of the License at https://creativecommons.org/licenses/by-nc-nd/3.0/.
+
+![CC-BY_NC-ND](images/CC-BY-NC-ND.png)

README.md

@@ -0,0 +1,65 @@
+# PL/SQL Unwrapper for SQL Developer
+
+## Introduction
+
+PL/SQL Unwrapper for SQL Developer is a free extension to unwrap PL/SQL code wrapped with the wrap utility of the Oracle Database Server version 10g, 11g, 12c, 18c or 19c.
+
+## Example
+
+Open a wrapped PL/SQL unit (procedure, function, package specification, package body, type specification or type body) in a SQL Developer editor
+
+![Wrapped](images/unwrapper-1.png)
+
+Right-click within editor to show the pop-up-menu. Select `Unwrap` or simply press `Ctrl-Shift-U` to unwrap the code.
+
+![Unwrap](images/unwrapper-2.png)
+
+The editor content is replaced by the unwrapped code.
+
+![Unwrapped](images/unwrapper-3.png)
+
+By default the unwrapped code does not contain a valid DDL statement. In this case the `CREATE` is missing. You may change this behaviour in in the preferences.
+
+![Preferences](images/unwrapper-4.png)
+
+Check the `Add ‘CREATE OR REPLACE'` option to get a complete DDL statement.
+
+![Preferences](images/unwrapper-5.png)
+
+## Bulk Unwrap
+
+If you install [oddgen for SQL Developer](https://www.oddgen.org/) you will see a `PL/SQL Unwrapper` node in the `Generators` window:
+
+![oddgen Generator](images/generators.png)
+
+Open the PL/SQL Unwrapper node to show all wrapped objects in the navigator tree. Select one or more objects to unwrap. The following audioless video shows how to unwrap all package bodies in a schema in one go:
+
+[![Unwrapper](images/unwrapper.png)](https://trivadis.github.io/plsql-unwrapper-sqldev/unwrapper.mp4)
+
+## Configure Update Center
+
+Click the `Help` menu and select `Check for Updates…`. Press the `Add` button to register the update center http://update.salvis.com/ . If you have troubles to configure the proxy settings, because your company requires some additional authentication or similar, then I suggest to download PL/SQL Unwrapper for SQL Developer from [here](https://github.com/Trivadis/plsql-unwrapper-sqldev/releases) and use the `Install From Local File` option.
+
+![Update Center](images/salvis-update-center.png)
+
+## Releases
+
+You find all releases and release information [here](https://github.com/Trivadis/plsql-unwrapper-sqldev/releases).
+
+## Issues
+Please file your bug reports, enhancement requests, questions and other support requests within [Github's issue tracker](https://help.github.com/articles/about-issues/).
+
+* [Questions](https://github.com/trivadis/plsql-unwrapper-sqldev/issues?q=is%3Aissue+label%3Aquestion)
+* [Open enhancements](https://github.com/trivadis/plsql-unwrapper-sqldev/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement)
+* [Open bugs](https://github.com/trivadis/plsql-unwrapper-sqldev/issues?q=is%3Aopen+is%3Aissue+label%3Abug)
+* [Submit new issue](https://github.com/trivadis/plsql-unwrapper-sqldev/issues/new)
+
+## Frequently Asked Questions
+
+see [Frequently Ased Questions](FAQ.md).
+
+## License
+
+PL/SQL Unwrapper is licensed under the Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License. You may obtain a copy of the License at https://creativecommons.org/licenses/by-nc-nd/3.0/.
+
+![CC-BY_NC-ND](images/CC-BY-NC-ND.png)