catalog updating for v1.8 release

Author: balinorLiang

CN/modules/ROOT/pages/v1.8/10.adoc

@@ -2,55 +2,25 @@
 :sectnums:
 :sectnumlevels: 5
 
+= 适配插件
 
-= FAQ
+== 目的
 
-== IvorySQL贡献的许可
+- 通过RPM包安装的用户已经涵盖了如上插件，用户可以根据自身需求连接数据库后执行create extension语句即可。对于其他插件，用户可自行下载源码并于IvorySQL结合使用进行探索。
 
-如果您提交的贡献是原创作品，那么您可以假设IvorySQL将作为整个IvorySQL版本的一部分发布给下游用户，该版本将遵循Apache许可证2.0版本。
 
-如果您提交的内容不是原创作品，同样鼓励代码共享和尊重原作者的著作权，同样允许代码修改，再发布。请注意需要满足如下条件：
+== 说明
 
-1、需要给代码的用户一份Apache许可证。
+- 通过RPM包安装的用户已经涵盖了如上插件，用户可以根据自身需求连接数据库后执行create extension语句即可。对于其他插件，用户可自行下载源码并于IvorySQL结合使用进行探索。
 
-2、如果您修改了代码，需要在被修改的文件中说明。
+== 使用
+详细使用说明请参照插件对应项目网址：
+|====
+|pgddl | https://github.com/lacanoid/pgddl 
+|pgvector | https://github.com/pgvector/pgvector
+|pgroonga | https://github.com/pgroonga/pgroonga
+|====
 
-3、在延伸的代码中（修改和有源代码衍生的代码中）需要带有原来代码中的协议、商标、专利声明和其他原来作者规定需要包含的说明。
 
-4、如果再发布的产品中包含一个Notice文件，则在Notice文件中需要带有Apache许可证。您可以在Notice中增加自己的许可，但不可以表现为对Apache许可证构成更改。
 
-最后，请记住，从非原始的工作中删除许可标头从来都不是一个好主意。即使您使用的文件部分最初在顶部有许可标头，您也应该保留它。与往常一样，如果您不太确定您的贡献所涉及的许可问题，请随时在开发人员邮件列表中联系我们。
 
-== 编码指南
-
-您获得反馈和看到代码合并到项目中的机会在很大程度上取决于更改的粒度。如果您的想法发生了更大的变化，我们强烈建议您在花大量时间编写代码之前，先加入开发人员的邮件列表，并与我们分享您的建议。即使您的建议得到社区的验证，我们仍然建议您将实际工作作为一系列小型的、独立的提交来完成。这使得评审员的工作更加容易，并提高了反馈的及时性。
-
-当谈到IvorySQL的C和C++部分时，我们尝试遵循PostgreSQL编码约定。除此之外：
-
-对于C和Perl代码，如果需要，请运行pgindent。我们建议在查看更改时使用git diff--color，这样您提交的代码中就不会出现任何虚假的空白问题。
-
-所有贡献给IvorySQL的新功能都应该由与其一起贡献的回归测试覆盖。如果您不确定如何测试或记录您的工作，请在ivorysql-hackers邮件列表中提出问题，社区的开发人员将尽力帮助您。
-
-至少，您应该始终运行make installcheck world，以确保您没有破坏任何东西。
-
-== 适用于上游PostgreSQL的更改
-
-如果您正在进行的更改涉及PostgreSQL和IvorySQL之间的通用功能，则可能会要求您将其转发到PostgreSQL。这不仅是为了我们不断减少两个项目之间的差异，而且是为了让与PostgreSQL相关的任何变化都能从对上游PostgreSQL社区更广泛的审查中受益。一般来说，将这两个代码库都放在手边是个好主意，这样您就可以确定您的更改是否需要前移。
-
-== 补丁提交
-
-一旦您准备好与IvorySQL核心团队和IvorySQL社区的其他成员共享您的工作，您应该将所有提交推送到从官方IvorySQL派生的分支的您自己的存储库中，并向我们发送请求。
-
-== 补丁审查
-
-假定提交的拉取请求通过验证检查，可供同行审查。同行审查是确保对IvorySQL的贡献具有高质量并与路线图和社区期望保持一致的过程。我们鼓励IvorySQL社区的每个成员审查请求并提供反馈。由于您不必成为核心团队成员就可以做到这一点，因此我们建议您向有兴趣成为IvorySQL长期贡献者的任何人提供一系列拉动式评论。
-
-同行评审的一个结果可能是达成共识，即您需要以某些方式修改pull请求。GitHub允许您将其他提交推送到从中发送请求的分支中。这些额外的提交将对所有审阅者可见。
-
-当同行评议收到参与者至少+1张+1和no-1张的选票时，同行评议会趋于一致。在这一点上，您应该期望核心团队成员之一将您的更改引入到项目中。
-
-在补丁审查期间的任何时候，您都可能会因审查人员和核心团队成员的工作效率而遇到延迟。请耐心点，也不要气馁。如果您在几天内没有收到预期的反馈，请添加一条评论，要求更新pull请求本身，或者向邮件列表发送一封电子邮件。
-
-== 直接提交到存储库
-
-有时，您会看到核心团队成员直接提交到存储库，而无需执行pull请求工作流。这仅适用于小的更改，我们使用的经验法则是：如果更改涉及任何可能导致测试失败的功能，那么它必须通过pull请求工作流。另一方面，如果更改发生在代码库的非功能部分（例如在注释块中修复打字错误），则核心团队成员可以决定直接提交到存储库。

CN/modules/ROOT/pages/v1.8/11.adoc

@@ -1,26 +1,28 @@
 :sectnums:
 :sectnumlevels: 5
+
 :imagesdir: ./_images
 
-= Ivorysql框架设计
+= 新增Oracle兼容模式的端口与Ip
 
 == 目的
-- 为了对原有的postgres改动最小的前提下，实现对oracle兼容。我们需要实现双parser、双端口、模式PLPGSQL实现PL\iSQL的框架。实现流程图如下：
 
-image::p18.png[]
+- 为了将Oracle端口、Ip与PG的端口Ip进行区分。现需要增加对ORAPORT和ORAHOST的处理;
 
 == 功能
 
-=== 双端口设计
-
-- 保持了Ivorysql 5432端口兼容原有postgres情况，因此 Ivorysql采用另一个独立的端口登录，默认为1521。从该端口登录，默认采用oracle兼容模式。如果需要从5432端口登录且还要进入兼容模式，则需要通过compatible_mode参数进行设置;
-
-=== parser模块设计
-
-- 为了将Oracle语法与postgres语法间的相互干扰降到最低，因此新增parser模块，用于处理Oracle相关的语法;
-
-=== 新增PL\iSQL过程语言
+- 新增ivoryhost：需要在连接时新增参数ivoryhost即可指定，其功能类似 host;
 
-- 同样为了减少Oracle兼容与postgres语法不同而导致测试用例冲突得情况，因此单独设计了一套Oracle专用的测试用例。该套测试用例由postgres原有测试框架拷贝修改而来;
+- 新增ivoryport：相较于host，port的功能相对复杂一些。其中涉及到可以在configure阶段配置，连接阶段指定端口;
 
+== 测试用例：
+```
+   ./configure --with-oraport=5555
+   ./initdb ....
+   ./pg_ctl -D ../data start
+    
+   ./pg_ctl -o “-p 5433 -o 1522” -D ../data
+```
+  
 
+​