[idea] Merge constant aliases by using multiple term tags for a varlistentry

[Girgias]

As a reply to #5434 (comment) I think improving the markup of aliased constants to something like this probably makes the most sense, as we don't duplicate wording nor need to specify X is an alias of Y. :)

[jordikroon]

From a reader perspective I am not sure if this is clear enough. Because the extra enter could also indicate that the first constant may not have a description. Even though if that were the case it would have had an extra enter.

Additionally Error reporting constants are also formatted this way, but they are not considered aliases.

My suggestion (this would keep them on the same line):

<varlistentry>
 <term>
  <constant xml:id="constant.zend-thread-safe">ZEND_THREAD_SAFE</constant>,
  <constant xml:id="constant.php-zts">PHP_ZTS</constant>
  (<type>bool</type>)
 </term>
 <listitem>
  <simpara>
   Indicates whether the current build of PHP is thread safe.
  </simpara>
 </listitem>
</varlistentry>

[Girgias]

From a reader perspective I am not sure if this is clear enough. Because the extra enter could also indicate that the first constant may not have a description. Even though if that were the case it would have had an extra enter.

Additionally Error reporting constants are also formatted this way, but they are not considered aliases.

My suggestion (this would keep them on the same line):

<varlistentry>
 <term>
  <constant xml:id="constant.zend-thread-safe">ZEND_THREAD_SAFE</constant>,
  <constant xml:id="constant.php-zts">PHP_ZTS</constant>
  (<type>bool</type>)
 </term>
 <listitem>
  <simpara>
   Indicates whether the current build of PHP is thread safe.
  </simpara>
 </listitem>
</varlistentry>

Sorry for the late reply, that could also work and happy either way :)

[jordikroon]

@kocsismate is this something you could try for #5434?

[kocsismate]

@jordikroon Absolutely, that's what I would also prefer!