From 11d82aa49efb3d1cbc08f14562a757f115053c8b Mon Sep 17 00:00:00 2001 From: Samay Sharma Date: Mon, 13 Feb 2023 16:23:52 -0800 Subject: [PATCH v9 3/5] Remove Anti-Features section from Installation from source docs Currently, several meson setup options are listed in anti-features. However, they are similar to most other options in the postgres features list as they are 'auto' features themselves. Also, other options are likely better suited to the developer options section. This commit, therefore, moves the options listed in the anti-features section into other sections and removes that section. For consistency, this reorganization has been done on the make section of the docs as well. --- doc/src/sgml/installation.sgml | 140 ++++++++++++++------------------- 1 file changed, 57 insertions(+), 83 deletions(-) diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index 7e65cdd72e..d7ab0c205e 100644 --- a/doc/src/sgml/installation.sgml +++ b/doc/src/sgml/installation.sgml @@ -1214,23 +1214,6 @@ build-postgresql: - - - - - - Anti-Features - - - The options described in this section allow disabling - certain PostgreSQL features that are built - by default, but which might need to be turned off if the required - software or system features are not available. Using these options is - not recommended unless really necessary. - - - - @@ -1270,34 +1253,6 @@ build-postgresql: - - - - - Allow the build to succeed even if PostgreSQL - has no CPU spinlock support for the platform. The lack of - spinlock support will result in very poor performance; therefore, - this option should only be used if the build aborts and - informs you that the platform lacks spinlock support. If this - option is required to build PostgreSQL on - your platform, please report the problem to the - PostgreSQL developers. - - - - - - - - - Disable use of CPU atomic operations. This option does nothing on - platforms that lack such operations. On platforms that do have - them, this will result in poor performance. This option is only - useful for debugging or making performance comparisons. - - - - @@ -1702,6 +1657,34 @@ build-postgresql: + + + + + Allow the build to succeed even if PostgreSQL + has no CPU spinlock support for the platform. The lack of + spinlock support will result in very poor performance; therefore, + this option should only be used if the build aborts and + informs you that the platform lacks spinlock support. If this + option is required to build PostgreSQL on + your platform, please report the problem to the + PostgreSQL developers. + + + + + + + + + Disable use of CPU atomic operations. This option does nothing on + platforms that lack such operations. On platforms that do have + them, this will result in poor performance. This option is only + useful for debugging or making performance comparisons. + + + + @@ -2657,13 +2640,6 @@ ninja install - - - - - Anti-Features - - @@ -2703,36 +2679,6 @@ ninja install - - - - - - This option is set to true by default; setting it to false will - allow the build to succeed even if PostgreSQL - has no CPU spinlock support for the platform. The lack of - spinlock support will result in very poor performance; therefore, - this option should only be changed if the build aborts and - informs you that the platform lacks spinlock support. If setting this - option to false is required to build PostgreSQL on - your platform, please report the problem to the - PostgreSQL developers. - - - - - - - - - This option is set to true by default; setting it to false will - disable use of CPU atomic operations. The option does nothing on - platforms that lack such operations. On platforms that do have - them, disabling atomics will result in poor performance. Changing - this option is only useful for debugging or making performance comparisons. - - - @@ -3175,8 +3121,36 @@ ninja install + + + + + This option is set to true by default; setting it to false will + allow the build to succeed even if PostgreSQL + has no CPU spinlock support for the platform. The lack of + spinlock support will result in very poor performance; therefore, + this option should only be changed if the build aborts and + informs you that the platform lacks spinlock support. If setting this + option to false is required to build PostgreSQL on + your platform, please report the problem to the + PostgreSQL developers. + + + - + + + + + This option is set to true by default; setting it to false will + disable use of CPU atomic operations. The option does nothing on + platforms that lack such operations. On platforms that do have + them, disabling atomics will result in poor performance. Changing + this option is only useful for debugging or making performance comparisons. + + + + -- 2.38.1