chore(pgsql): update comments of pg_hugepage.yml

Author: waitingsong

roles/pgsql/tasks/grace_patroni_restart.yml

@@ -1,7 +1,7 @@
 #!/usr/bin/ansible-playbook
 ---
 #--------------------------------------------------------------#
-# patroni restart pg_cls gracefully           [pt_restart]
+# patroni restart pg_cls gracefully                 [pt_restart]
 # avoiding switching pg primary/standby
 # usage:
 #   - ./pgsql.yml -l <pg_cls> -t pt_restart -e "pt_restart=true"
@@ -16,7 +16,8 @@
 #   - ./pgsql.yml -l <pg_cls> -t pt_restart -e "pt_restart=true"
 #     all nodes have been restarted
 #   - ./pgsql.yml -l '<ip>,&<pg_cls>' -t pt_restart -e "pt_restart=true"
-#     nodes in ansible_play_hosts_all have been restarted, other nodes in the same pg_cls ignored
+#     nodes in ansible_play_hosts_all have been restarted,
+#     other nodes in the same pg_cls ignored
 #--------------------------------------------------------------#
 
 - name: set variable

roles/pgsql/tasks/pg_hugepage.yml

@@ -1,11 +1,19 @@
 ---
 #--------------------------------------------------------------#
 # Enable hugepage for pg and restart pg cluster    [pg_hugepage]
-# if `node_hugepage_count` or `node_hugepage_ratio` changed, it will full backup the pg_cls and restart it gracefully
+# if `node_hugepage_count` or `node_hugepage_ratio` changed,
+# it will full backup the pg_cls and restart it gracefully
 # support usage:
 #   - `pig install`
 #   - `bin/pgsql-add <pg_cls>`
+#   - `bin/pgsql-add <pg_cls> <ip>`
+#      service of nodes in ansible_play_hosts_all will be unavailable during the process,
+#      other nodes in the same pg_cls ignored
 #   - `pgsql.yml -l <pg_cls> -t pg_hugepage`
+#      entire service of this postgres cluster will be unavailable during the process
+#   - `pgsql.yml -l '<ip>,&<pg_cls>' -t pg_hugepage`
+#      service of nodes in ansible_play_hosts_all will be unavailable during the process,
+#      other nodes in the same pg_cls ignored
 #--------------------------------------------------------------#
 # calculation rules:
 #   1. `shared_memory_size_in_huge_pages` (from PG15+): if `node_hugepage_count` is -1 and huge_pages (from PG) != off